> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ficcaurora.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Gtp4.1prompt

# GPT-4.1 模型提示指南

## 1. 代理工作流 (Agentic Workflows)

### 系统提示提醒 (System Prompt Reminders)

#### 持久性 (Persistence)

* 示例: 持续进行直到完全解决问题

#### 工具调用 (Tool-calling)

* 示例: 不确定时使用工具，不要猜测
* 规划 (Planning) \[可选]

### 工具调用 (Tool Calls) 优化

* 推荐 API 'tools' 字段传递工具
* 在 'description' 字段添加详细描述
* 工具用法示例放置于系统提示的 `# Examples` 部分

### 诱导规划与思维链 (CoT)

* GPT-4.1 不是推理模型
* 通过 Planning 提示组件诱导显式、逐步的规划
* 效果: SWE-bench 任务通过率提高 4%
* SWE-bench Verified 示例提示 (工作流详细)

### 模型特性 (字面遵循)

* 超越 GPT-4o 的能力
* 通过提示诱导规划 (Planning)
* 高度可操纵性 (steerable)
* 构建信息丰富的评估（Evals）
* 经常迭代 (Iterate Often)

## 2. 长上下文 (Long Context)

### 上下文窗口: 1M token

* “大海捞针”评估表现优异 (达到 1M)
* 仅使用外部上下文 (External Context)

### 提示组织 (Prompt Organization)

* 同时使用内部和外部知识 (默认行为)

## 3. 思维链 (Chain of Thought, CoT)

* 目的: 分解问题为更易管理的部分，提高输出质量
* 代价: 增加成本和延迟 (更多输出 token)
* 推荐基础 CoT 指令: 'First, think carefully step by step...'

### 改进 CoT 提示

#### 示例策略 (Query/Context Analysis)

* 1. Query Analysis (查询分析)
* 2. Context Analysis (上下文分析，优化召回率)
* 3. Synthesis (综合，总结最相关文档)

## 4. 指令遵循 (Instruction Following)

### 性能: 表现出色，可精确控制输出

* 1. 设定高层次的 'Response Rules'/'Instructions' 部分

### 字面遵循: 可能需要包含明确的'做什么'/'不做什么'的规范

* 2. 添加子部分指定具体行为 (如 `# Sample Phrases`)

#### 3. 使用有序列表指定工作流步骤

* 检查冲突、不明确的指令 (模型倾向遵循末尾指令)
* 4. 调试失败行为

### 客户服务代理示例提示 (展示多样化规则和结构)

* 过度遵循 '必须调用工具' 导致幻觉/空值调用 (应增加信息不足时询问用户的指令)
* 重复使用样本短语 (需指示其变化)
* 过度提供解释性散文或多余格式 (需提供明确指令/示例)

## 5. 一般建议与结构

### 提示结构 (Starting Point)

* # Role and Objective
* # Instructions (包括子类别)
* # Reasoning Steps
* # Output Format
* # Examples
* # Context
* # Final instructions and prompt to think step by step

### 分隔符 (Delimiters) 建议

* 1. Markdown (推荐起点，用于标题和列表)
* 2. XML (表现良好，方便包装和嵌套)

#### 3. JSON (结构化，但在非编码环境可能冗长)

* XML (表现良好)
* Lee et al. 格式 (ID: 1 | TITLE:...) (表现良好)

### 注意事项 (Caveats)

#### 可能抗拒生成非常长、重复的输出 (需强烈指示)

* JSON 格式 (表现不佳)
* 罕见并行工具调用不正确 (可考虑禁用 `parallel_tool_calls`)

## 附录: 生成和应用文件补丁 (Diffs)

* GPT-4.1 Diff 能力大幅提升

### 推荐 V4A Diff 格式 (Apply Patch Tool)

* 命令结构: `%%bash apply_patch <<"EOF" ...`
* 文件操作: `*** [ACTION] File: [path]` (Add, Update, Delete)
* 代码块变更: `- [old_code]`, `+ [new_code]`
* 上下文 (Context): 默认 3 行前后上下文
* 唯一识别: 使用 `@@` 指示类或函数

### 其他有效 Diff 格式

* SEARCH/REPLACE 格式 (Aider benchmark)
* Pseudo-XML 格式 (无内部转义)
* 共同点: 不使用行号；提供旧代码和精确替换的新代码