fix(docs): locale translations
This commit is contained in:
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: 代理商
|
||||
description: 配置和使用專門的代理。
|
||||
description: 配置和使用专門的代理。
|
||||
---
|
||||
|
||||
代理是專門的人工智能助手,可以針對特定任務和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的專用工具。
|
||||
代理是专門的人工智能助手,可以針对特定任务和工作流程進行配置。它們允许您创建具有自定義提示、模型和工具访问权限的专用工具。
|
||||
|
||||
:::tip
|
||||
使用計劃代理來分析代碼並審查建議,而無需進行任何代碼更改。
|
||||
使用計劃代理來分析代碼并审查建議,而無需進行任何代碼更改。
|
||||
:::
|
||||
|
||||
您可以在會話期間在代理之間切換,或使用 `@` 提及來調用它們。
|
||||
您可以在会话期間在代理之間切換,或使用 `@` 提及來调用它們。
|
||||
|
||||
---
|
||||
|
||||
@@ -28,13 +28,13 @@ opencode有两种类型的代理;主代理和次代理。
|
||||
:::
|
||||
|
||||
opencode附带两个内置的主要代理:**Build** 和 **Plan**。地
|
||||
看看下面這些。
|
||||
看看下面这些。
|
||||
|
||||
---
|
||||
|
||||
### 子代理
|
||||
|
||||
子代理是主要代理可以調用來執行特定任務的專業助手。您還可以通過在消息中**@提及**它們來手動調用它們。
|
||||
子代理是主要代理可以调用來执行特定任务的专業助手。您还可以通过在消息中**@提及**它們來手动调用它們。
|
||||
|
||||
opencode附带两个内置子代理:**General** 和 **Explore**。我们将在下面看看这个。
|
||||
|
||||
@@ -50,7 +50,7 @@ opencode附带两个内置主代理和两个内置子代理。
|
||||
|
||||
_模式_:`primary`
|
||||
|
||||
構建是啟用所有工具的**默認**主要代理。這是用於需要完全訪問文件操作和系統命令的開發工作的標準代理。
|
||||
構建是启用所有工具的**默認**主要代理。这是用于需要完全访问文件操作和系統命令的開發工作的標準代理。
|
||||
|
||||
---
|
||||
|
||||
@@ -58,7 +58,7 @@ _模式_:`primary`
|
||||
|
||||
_模式_:`primary`
|
||||
|
||||
專為規劃和分析而設計的受限代理。我們使用權限系統為您提供更多控制並防止意外更改。
|
||||
专为規劃和分析而設計的受限代理。我们使用权限系統为您提供更多控制并防止意外更改。
|
||||
默认情况下,以下所有项均设置为`ask`:
|
||||
|
||||
- `file edits`:所有书写、修复和编辑
|
||||
@@ -72,7 +72,7 @@ _模式_:`primary`
|
||||
|
||||
_模式_:`subagent`
|
||||
|
||||
用於研究複雜問題和執行多步驟任務的通用代理。具有完整的工具訪問權限(待辦事項除外),因此可以在需要時更改文件。使用它可以並行運行多個工作單元。
|
||||
用于研究复杂问题和执行多步骤任务的通用代理。它具有完整的工具访问权限(待办事项除外),因此可在需要时修改文件,并并行运行多个工作单元。
|
||||
|
||||
---
|
||||
|
||||
@@ -80,7 +80,7 @@ _模式_:`subagent`
|
||||
|
||||
_模式_:`subagent`
|
||||
|
||||
用於探索代碼庫的快速只讀代理。無法修改文件。當您需要按模式快速查找文件、搜索代碼中的關鍵字或回答有關代碼庫的問題時,請使用此功能。
|
||||
用于探索代碼庫的快速只讀代理。无法修改文件。当您需要按模式快速查找文件、搜索代碼中的關鍵字或回答有關代碼庫的問題時,请使用此功能。
|
||||
|
||||
---
|
||||
|
||||
@@ -112,25 +112,25 @@ _模式_:`primary`
|
||||
|
||||
1. 对于主要代理,请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。
|
||||
|
||||
2. 可以調用子代理:
|
||||
- **自動**由主要代理根據其描述執行專門任務。
|
||||
- 通過在消息中**@提及**子代理手動進行。例如。
|
||||
2. 可以调用子代理:
|
||||
- **自动**由主要代理根據其描述执行专門任务。
|
||||
- 通过在消息中**@提及**子代理手动進行。例如。
|
||||
|
||||
```txt frame="none"
|
||||
@general help me search for this function
|
||||
```
|
||||
|
||||
3. **會話之間導航**:當子代理創建自己的子會話時,您可以使用以下命令在父會話和所有子會話之間導航:
|
||||
3. **会话之间导航**:当子代理创建自己的子会话時,您可以使用以下命令在父会话和所有子会话之间导航:
|
||||
- **\<Leader>+Right**(或您配置的 `session_child_cycle` 鍵綁定)向前循環父級 → 子級 1 → 子級 2 → ... → 父級
|
||||
- **\<Leader>+Left**(或您配置的 `session_child_cycle_reverse` 鍵綁定)向後循環父級 ← 子級 1 ← 子級 2 ← ... ← 父級
|
||||
|
||||
這使您可以在主要對話和專門的子代理工作之間無縫切換。
|
||||
这使您可以在主要对话和专門的子代理工作之間無縫切換。
|
||||
|
||||
---
|
||||
|
||||
## 配置
|
||||
|
||||
您可以自定義內置代理或通過配置創建您自己的代理。可以通過兩種方式配置代理:
|
||||
您可以自定義内置代理或通过配置创建您自己的代理。可以通过两种方式配置代理:
|
||||
|
||||
---
|
||||
|
||||
@@ -177,7 +177,7 @@ _模式_:`primary`
|
||||
|
||||
---
|
||||
|
||||
### 降價
|
||||
### Markdown
|
||||
|
||||
您还可以使用 Markdown 文件定义代理。将它们放入:
|
||||
|
||||
@@ -212,7 +212,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
|
||||
## 選項
|
||||
|
||||
讓我們詳細看看這些配置選項。
|
||||
讓我们詳細看看这些配置選項。
|
||||
|
||||
---
|
||||
|
||||
@@ -230,7 +230,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
}
|
||||
```
|
||||
|
||||
這是一個**必需的**配置選項。
|
||||
这是一个**必需的**配置選項。
|
||||
|
||||
---
|
||||
|
||||
@@ -238,7 +238,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
|
||||
使用 `temperature` 配置控制 LLM 响应的随机性和创意。
|
||||
|
||||
較低的值使響應更加集中和確定,而較高的值則增加創造力和可變性。
|
||||
較低的值使響应更加集中和確定,而較高的值则增加创建力和可變性。
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -253,11 +253,11 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
}
|
||||
```
|
||||
|
||||
溫度值的範圍通常為 0.0 到 1.0:
|
||||
温度值范围通常为 0.0 到 1.0:
|
||||
|
||||
- **0.0-0.2**:非常集中且確定的響應,非常適合代碼分析和規劃
|
||||
- **0.3-0.5**:具有一定創造力的平衡響應,適合一般開發任務
|
||||
- **0.6-1.0**:更有創意和多樣化的反應,有助於頭腦風暴和探索
|
||||
- **0.0-0.2**:响应更集中、确定性更高,适合代码分析和规划
|
||||
- **0.3-0.5**:平衡型响应,兼顾稳定性与创造力
|
||||
- **0.6-1.0**:响应更有创意和多样性,适合头脑风暴和探索
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -277,15 +277,15 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
}
|
||||
```
|
||||
|
||||
如果未指定温度,opencode 将使用特定于型号的默认值;大多数型号通常为 0,Qwen 型号为 0.55。
|
||||
如果未指定温度,opencode 将使用特定于模型的默认值;大多数模型通常为 0,Qwen 模型为 0.55。
|
||||
|
||||
---
|
||||
|
||||
### 最大步數
|
||||
|
||||
控制代理在被迫僅使用文本響應之前可以執行的最大代理迭代次數。這允許希望控製成本的用戶對代理操作設置限制。
|
||||
控制代理在被迫仅使用文本響应之前可以执行的最大代理迭代次數。这允许希望控制成本的用戶对代理操作设置限制。
|
||||
|
||||
如果未設置,代理將繼續迭代,直到模型選擇停止或用戶中斷會話。
|
||||
如果未设置,代理将繼續迭代,直到模型选择停止或用戶中斷会话。
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -299,7 +299,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
}
|
||||
```
|
||||
|
||||
當達到限制時,代理會收到特殊的系統提示,指示其響應其工作摘要和建議的剩餘任務。
|
||||
当達到限制時,代理会收到特殊的系統提示,指示其響应其工作摘要和建議的剩餘任务。
|
||||
|
||||
:::caution
|
||||
旧版 `maxSteps` 字段已废弃。请改用`steps`。
|
||||
@@ -343,7 +343,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
|
||||
|
||||
### 模型
|
||||
|
||||
使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有用。例如,更快的规划模型、更强大的实施模型。
|
||||
使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有帮助。例如,更快的规划模型、更强大的实施模型。
|
||||
|
||||
:::tip
|
||||
如果您不指定模型,主代理将使用[全局配置的模型](/docs/config#models),而子代理将使用调用子代理的主代理的模型。
|
||||
@@ -386,7 +386,7 @@ opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您
|
||||
```
|
||||
|
||||
:::note
|
||||
特定於代理的配置會覆蓋全局配置。
|
||||
特定于代理的配置会覆盖全局配置。
|
||||
:::
|
||||
|
||||
您还可以使用通配符同时控制多个工具。例如,要禁用 MCP 服务器中的所有工具:
|
||||
@@ -410,7 +410,7 @@ opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您
|
||||
|
||||
---
|
||||
|
||||
### 權限
|
||||
### 权限
|
||||
|
||||
您可以配置权限来管理代理可以执行的操作。 目前,`edit`、`bash` 和 `webfetch` 工具的权限可以配置为:
|
||||
|
||||
@@ -427,7 +427,7 @@ opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您
|
||||
}
|
||||
```
|
||||
|
||||
您可以覆蓋每個代理的這些權限。
|
||||
您可以覆盖每个代理的这些权限。
|
||||
|
||||
```json title="opencode.json" {3-5,8-10}
|
||||
{
|
||||
@@ -482,7 +482,7 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
這可以採用全局模式。
|
||||
这可以採用全局模式。
|
||||
|
||||
```json title="opencode.json" {7}
|
||||
{
|
||||
@@ -499,8 +499,8 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
您還可以使用`*`通配符來管理所有命令的權限。
|
||||
由於最後一個匹配規則優先,因此將 `*` 通配符放在前面,將特定規則放在後面。
|
||||
您还可以使用`*`通配符來管理所有命令的权限。
|
||||
由于最后一个匹配规则优先,因此将 `*` 通配符放在前面,将特定规则放在后面。
|
||||
|
||||
```json title="opencode.json" {8}
|
||||
{
|
||||
@@ -542,7 +542,7 @@ Only analyze code and suggest changes.
|
||||
|
||||
### 隱
|
||||
|
||||
使用`hidden: true`从`@`自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有用。
|
||||
使用`hidden: true`从`@`自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有帮助。
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -555,7 +555,7 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
這僅影響自動完成菜單中的用戶可見性。如果權限允許,模型仍然可以通過任務工具調用隱藏代理。
|
||||
这仅影响自动完成菜单中的用户可见性。如果权限允许,模型仍然可以通过任务工具调用隐藏代理。
|
||||
|
||||
:::note
|
||||
仅适用于`mode: subagent`代理。
|
||||
@@ -563,7 +563,7 @@ Only analyze code and suggest changes.
|
||||
|
||||
---
|
||||
|
||||
### 任務權限
|
||||
### 任务权限
|
||||
|
||||
使用`permission.task`控制代理可以通过任务工具调用哪些子代理。使用glob模式进行灵活匹配。
|
||||
|
||||
@@ -591,7 +591,7 @@ Only analyze code and suggest changes.
|
||||
:::
|
||||
|
||||
:::tip
|
||||
用戶始終可以通過 `@` 自動完成菜單直接調用任何子代理,即使代理的任務權限會拒絕它。
|
||||
用戶始終可以通过 `@` 自动完成菜单直接调用任何子代理,即使代理的任务权限会拒絕它。
|
||||
:::
|
||||
|
||||
---
|
||||
@@ -631,13 +631,13 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
值範圍從 0.0 到 1.0。較低的值更加集中,較高的值更加多樣化。
|
||||
值范围從 0.0 到 1.0。較低的值更加集中,較高的值更加多樣化。
|
||||
|
||||
---
|
||||
|
||||
### 額外的
|
||||
|
||||
您在代理配置中指定的任何其他選項都將作為模型選項**直接**傳遞給提供程序。這允許您使用特定於提供商的功能和參數。
|
||||
您在代理配置中指定的任何其他選項都将作为模型選項**直接**傳遞給提供商。这允许您使用特定于提供商的功能和參數。
|
||||
|
||||
例如,使用 OpenAI 的推理模型,您可以控制推理工作:
|
||||
|
||||
@@ -654,7 +654,7 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
這些附加選項是特定於型號和提供商的。檢查提供商的文檔以獲取可用參數。
|
||||
这些附加選項是特定于模型和提供商的。检查提供商的文档以获取可用參數。
|
||||
|
||||
:::tip
|
||||
运行 `opencode models` 查看可用模型的列表。
|
||||
@@ -662,20 +662,20 @@ Only analyze code and suggest changes.
|
||||
|
||||
---
|
||||
|
||||
## 創建代理
|
||||
## 创建代理
|
||||
|
||||
您可以使用以下命令創建新代理:
|
||||
您可以使用以下命令创建新代理:
|
||||
|
||||
```bash
|
||||
opencode agent create
|
||||
```
|
||||
|
||||
此交互式命令將:
|
||||
此交互式命令将:
|
||||
|
||||
1. 詢問代理保存在哪裡;全局或特定項目。
|
||||
2. 描述代理應該做什麼。
|
||||
3. 生成適當的系統提示和標識符。
|
||||
4. 讓您選擇代理可以訪問哪些工具。
|
||||
2. 描述代理应该做什麼。
|
||||
3. 生成適当的系統提示和標識符。
|
||||
4. 讓您选择代理可以访问哪些工具。
|
||||
5. 最后,使用代理配置创建一个markdown文件。
|
||||
|
||||
---
|
||||
@@ -684,17 +684,17 @@ opencode agent create
|
||||
|
||||
以下是不同代理的一些常見用例。
|
||||
|
||||
- **構建代理**:啟用所有工具的完整開發工作
|
||||
- **構建代理**:启用所有工具的完整開發工作
|
||||
- **規劃代理**:分析規劃,不做改動
|
||||
- **審查代理**:具有隻讀訪問權限和文檔工具的代碼審查
|
||||
- **审查代理**:具有隻讀访问权限和文档工具的代碼审查
|
||||
- **调试代理**:专注于启用bash和读取工具的调查
|
||||
- **文檔代理**:使用文件操作但不使用系統命令的文檔編寫
|
||||
- **文档代理**:使用文件操作但不使用系統命令的文档編寫
|
||||
|
||||
---
|
||||
|
||||
## 示例
|
||||
|
||||
以下是一些您可能會覺得有用的示例代理。
|
||||
以下是一些您可能会覺得有用的示例代理。
|
||||
|
||||
:::tip
|
||||
您有想要分享的经纪人吗? [提交 PR](https://github.com/anomalyco/opencode)。
|
||||
|
||||
Reference in New Issue
Block a user