fix(docs): locale translations for nav elements and headings

This commit is contained in:
Adam
2026-02-11 18:51:27 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions

View File

@@ -3,12 +3,13 @@ title: エージェント
description: 特殊なエージェントを構成して使用します。
---
エージェントは、特定のタスクやワークフロー向けに構成できる特殊な AI アシスタントです。これらを使用すると、カスタム プロンプト、モデル、ツール アクセスを備えた焦点を絞ったツールを作成できます。
エージェントは、特定のタスクやワークフロー向けに構成できる特殊な AI アシスタントです。これらを使用すると、カスタムプロンプト、モデル、ツールアクセスを備えた焦点を絞ったツールを作成できます。
:::tip
プラン エージェントを使用すると、コードを変更せずにコードを分析し、提案を確認できます。
Plan エージェントを使用すると、コードを変更せずにコードを分析し、提案を確認できます。
:::
You can switch between agents during a session or invoke them with the `@` mention.
セッション中にエージェントを切り替えたり、`@` メンションでエージェントを呼び出したりできます。
---
@@ -18,40 +19,41 @@ OpenCode には 2 種類のエージェントがあります。プライマリ
---
### 主要エージェント
### プライマリエージェント
プライマリ エージェントは、直接対話する主要なアシスタントです。 **Tab** キー、または設定した `switch_agent` キーバインドを使用して、それらを切り替えることができます。これらのエージェントが主な会話を処理します。ツールへのアクセスは権限によって構成されます。たとえば、Build ではすべてのツールが有効になっていますが、Plan は制限されています。
プライマリエージェントは、直接対話する主要なアシスタントです。 **Tab** キー、または設定した `switch_agent` キーバインドを使用して、それらを切り替えることができます。これらのエージェントが主な会話を処理します。ツールへのアクセスは権限によって構成されます。たとえば、Build ではすべてのツールが有効になっていますが、Plan は制限されています。
:::tip
**Tab** キーを使用して、セッション中にプライマリ エージェントを切り替えることができます。
**Tab** キーを使用して、セッション中にプライマリエージェントを切り替えることができます。
:::
OpenCode には、**Build** と **Plan** という 2 つの組み込みプライマリ エージェントが付属しています。これらについて以下で説明します。
OpenCode には、**Build** と **Plan** という 2 つの組み込みプライマリエージェントが付属しています。これらについて以下で説明します。
---
### サブエージェント
サブエージェントは、プライマリ エージェントが特定のタスクのために呼び出すことができる特殊なアシスタントです。メッセージ内で **@ メンション**することで、手動で呼び出すこともできます。
サブエージェントは、プライマリエージェントが特定のタスクのために呼び出すことができる特殊なアシスタントです。メッセージ内で **@ メンション**することで、手動で呼び出すこともできます。
OpenCode には、**General** と **Explore** という 2 つの組み込みサブエージェントが付属しています。これについては以下で見ていきます。
---
## 内蔵
## 組み込み
OpenCode には、2 つの組み込みプライマリ エージェントと 2 つの組み込みサブエージェントが付属しています。
OpenCode には、2 つの組み込みプライマリエージェントと 2 つの組み込みサブエージェントが付属しています。
---
### ビルドを使用する
### Build
_モード_: `primary`
ビルドは、すべてのツールが有効になっている **デフォルト** プライマリ エージェントです。これは、ファイル操作やシステム コマンドへの完全なアクセスが必要な開発作業用の標準エージェントです。
Build は、すべてのツールが有効になっている **デフォルト** プライマリエージェントです。これは、ファイル操作やシステムコマンドへの完全なアクセスが必要な開発作業用の標準エージェントです。
---
### 利用プラン
### Plan
_モード_: `primary`
@@ -65,15 +67,15 @@ _モード_: `primary`
---
### 一般的な使用
### General
_モード_: `subagent`
複雑な質問を調査し、複数ステップのタスクを実行するための汎用エージェント。完全なツール アクセス権 (todo を除く) があるため、必要に応じてファイルを変更できます。これを使用して、複数の作業単位を並行して実行します。
複雑な質問を調査し、複数ステップのタスクを実行するための汎用エージェント。完全なツールアクセス権 (todo を除く) があるため、必要に応じてファイルを変更できます。これを使用して、複数の作業単位を並行して実行します。
---
### 探索を使用する
### Explore
_モード_: `subagent`
@@ -81,36 +83,36 @@ _モード_: `subagent`
---
### 圧縮を使用する
### Compact
_モード_: `primary`
長いコンテキストを小さな要約に圧縮する隠しシステム エージェント。これは必要に応じて自動的に実行され、UI では選択できません。
長いコンテキストを小さな要約に圧縮する隠しシステムエージェント。これは必要に応じて自動的に実行され、UI では選択できません。
---
### タイトルを使用する
### Title
_モード_: `primary`
短いセッション タイトルを生成する非表示のシステム エージェント。これは自動的に実行され、UI では選択できません。
短いセッションタイトルを生成する非表示のシステムエージェント。これは自動的に実行され、UI では選択できません。
---
### 使用概要
### Summary
_モード_: `primary`
セッション概要を作成する非表示のシステム エージェント。これは自動的に実行され、UI では選択できません。
セッション概要を作成する非表示のシステムエージェント。これは自動的に実行され、UI では選択できません。
---
## 使用法
1. プライマリ エージェントの場合は、セッション中に **Tab** キーを使用してエージェントを切り替えます。設定した `switch_agent` キーバインドを使用することもできます。
1. プライマリエージェントの場合は、セッション中に **Tab** キーを使用してエージェントを切り替えます。設定した `switch_agent` キーバインドを使用することもできます。
2. サブエージェントは次のように呼び出すことができます。
- プライマリ エージェントによって、説明に基づいて特殊なタスクを **自動的に** 実行されます。
- プライマリエージェントによって、説明に基づいて特殊なタスクを **自動的に** 実行されます。
- メッセージ内でサブエージェントを **@ メンション**することで手動で実行できます。例えば。
```txt frame="none"
@@ -125,7 +127,7 @@ _モード_: `primary`
---
## 設定する
## 設定
組み込みエージェントをカスタマイズしたり、構成を通じて独自のエージェントを作成したりできます。エージェントは次の 2 つの方法で構成できます。
@@ -133,7 +135,7 @@ _モード_: `primary`
### JSON
`opencode.json` 構成ファイルでエージェントを構成します。
`opencode.json` 設定ファイルでエージェントを構成します。
```json title="opencode.json"
{
@@ -209,7 +211,7 @@ Markdown ファイル名がエージェント名になります。たとえば
## オプション
これらの構成オプションを詳しく見てみましょう。
これらの設定オプションを詳しく見てみましょう。
---
@@ -227,7 +229,7 @@ Markdown ファイル名がエージェント名になります。たとえば
}
```
これは**必須**の構成オプションです。
これは**必須**の設定オプションです。
---
@@ -278,7 +280,7 @@ Markdown ファイル名がエージェント名になります。たとえば
---
### 最大ステップ数
### ステップ数
エージェントが強制的にテキストのみで応答するまでに実行できるエージェントの反復の最大数を制御します。これにより、コストを管理したいユーザーは、エージェントのアクションに制限を設定できます。
@@ -296,7 +298,7 @@ Markdown ファイル名がエージェント名になります。たとえば
}
```
制限に達すると、エージェントは、作業の概要と推奨される残りのタスクを応答するように指示する特別なシステム プロンプトを受け取ります。
制限に達すると、エージェントは、作業の概要と推奨される残りのタスクを応答するように指示する特別なシステムプロンプトを受け取ります。
:::caution
従来の `maxSteps` フィールドは非推奨になりました。代わりに `steps` を使用してください。
@@ -304,7 +306,7 @@ Markdown ファイル名がエージェント名になります。たとえば
---
### 無効にする
### 無効
エージェントを無効にするには、`true` に設定します。
@@ -322,7 +324,7 @@ Markdown ファイル名がエージェント名になります。たとえば
### プロンプト
`prompt` 構成を使用して、このエージェントのカスタム システム プロンプト ファイルを指定します。プロンプト ファイルには、エージェントの目的に固有の指示が含まれている必要があります。
`prompt` 設定を使用して、このエージェントのカスタムシステムプロンプトファイルを指定します。プロンプトファイルには、エージェントの目的に固有の指示が含まれている必要があります。
```json title="opencode.json"
{
@@ -334,16 +336,16 @@ Markdown ファイル名がエージェント名になります。たとえば
}
```
このパスは、構成ファイルが配置されている場所に対する相対パスです。したがって、これはグローバルな OpenCode 構成とプロジェクト固有の構成の両方で機能します。
このパスは、設定ファイルが配置されている場所に対する相対パスです。したがって、これはグローバルな OpenCode 設定とプロジェクト固有の設定の両方で機能します。
---
### モデル
`model` 構成を使用して、このエージェントのモデルをオーバーライドします。さまざまなタスクに最適化されたさまざまなモデルを使用する場合に役立ちます。たとえば、計画にはより高速なモデルを、実装にはより有能なモデルを使用します。
`model` 設定を使用して、このエージェントのモデルをオーバーライドします。さまざまなタスクに最適化されたさまざまなモデルを使用する場合に役立ちます。たとえば、計画にはより高速なモデルを、実装にはより有能なモデルを使用します。
:::tip
モデルを指定しない場合、プライマリ エージェントは [グローバルに設定されたモデル ](/docs/config#models) を使用し、サブエージェントはサブエージェントを呼び出したプライマリ エージェントのモデルを使用します。
モデルを指定しない場合、プライマリエージェントは [グローバルに設定されたモデル](/docs/config#models) を使用し、サブエージェントはサブエージェントを呼び出したプライマリエージェントのモデルを使用します。
:::
```json title="opencode.json"
@@ -356,13 +358,13 @@ Markdown ファイル名がエージェント名になります。たとえば
}
```
OpenCode 構成内のモデル ID は、`provider/model-id` という形式を使用します。たとえば、[OpenCode Zen](/docs/zen) を使用している場合、GPT 5.1 Codex には `opencode/gpt-5.1-codex` を使用します。
OpenCode 設定内のモデル ID は、`provider/model-id` という形式を使用します。たとえば、[OpenCode Zen](/docs/zen) を使用している場合、GPT 5.1 Codex には `opencode/gpt-5.1-codex` を使用します。
---
### ツール
`tools` 構成を使用して、このエージェントで使用できるツールを制御します。特定のツールを `true` または `false` に設定することで、有効または無効にすることができます。
`tools` 設定を使用して、このエージェントで使用できるツールを制御します。特定のツールを `true` または `false` に設定することで、有効または無効にすることができます。
```json title="opencode.json" {3-6,9-12}
{
@@ -402,7 +404,7 @@ MCP サーバーからすべてのツールを無効にするには、次のよ
}
```
[tools](/docs/tools) について詳しくはこちらをご覧ください。
[ツール](/docs/tools) について詳しくはこちらをご覧ください。
---
@@ -478,7 +480,7 @@ Only analyze code and suggest changes.
}
```
これにはグロブ パターンを使用できます。
これにはグロブパターンを使用できます。
```json title="opencode.json" {7}
{
@@ -536,9 +538,9 @@ Only analyze code and suggest changes.
---
### 隠れた
### 非表示
`@` を使用して、`hidden: true` オートコンプリート メニューからサブエージェントを非表示にします。他のエージェントによってタスク ツールを介してプログラム的にのみ呼び出す必要がある内部サブエージェントに役立ちます。
`@` を使用して、`hidden: true` オートコンプリートメニューからサブエージェントを非表示にします。他のエージェントによってタスクツールを介してプログラム的にのみ呼び出す必要がある内部サブエージェントに役立ちます。
```json title="opencode.json"
{
@@ -551,7 +553,7 @@ Only analyze code and suggest changes.
}
```
これは、オートコンプリート メニューでのユーザーの表示にのみ影響します。権限が許可されていれば、非表示のエージェントをタスク ツール経由でモデルから呼び出すことができます。
これは、オートコンプリートメニューでのユーザーの表示にのみ影響します。権限が許可されていれば、非表示のエージェントをタスクツール経由でモデルから呼び出すことができます。
:::note
`mode: subagent` エージェントにのみ適用されます。
@@ -561,7 +563,7 @@ Only analyze code and suggest changes.
### タスクの権限
`permission.task` を使用して、エージェントがタスク ツール経由でどのサブエージェントを呼び出すことができるかを制御します。柔軟なマッチングのためにグロブ パターンを使用します。
`permission.task` を使用して、エージェントがタスクツール経由でどのサブエージェントを呼び出すことができるかを制御します。柔軟なマッチングのためにグロブパターンを使用します。
```json title="opencode.json"
{
@@ -580,12 +582,12 @@ Only analyze code and suggest changes.
}
```
`deny` に設定すると、サブエージェントはタスク ツールの説明から完全に削除されるため、モデルはそれを呼び出そうとしません。
`deny` に設定すると、サブエージェントはタスクツールの説明から完全に削除されるため、モデルはそれを呼び出そうとしません。
:::tip
ルールは順番に評価され、**最後に一致したルールが優先されます**。上記の例では、`orchestrator-planner` は `*` (拒否) と `orchestrator-*` (許可) の両方に一致しますが、`orchestrator-*` は `*` の後に来るため、結果は `allow` になります。
:::tip
ユーザーは、エージェントのタスク権限が拒否する場合でも、`@` オートコンプリート メニューを介して、いつでもサブエージェントを直接呼び出すことができます。
ユーザーは、エージェントのタスク権限が拒否する場合でも、`@` オートコンプリートメニューを介して、いつでもサブエージェントを直接呼び出すことができます。
:::
---
@@ -611,7 +613,7 @@ Only analyze code and suggest changes.
---
### トップP
### Top P
`top_p` オプションで応答の多様性を制御します。ランダム性を制御するための温度の代替手段。
@@ -629,9 +631,9 @@ Only analyze code and suggest changes.
---
### 追加
### 追加オプション
エージェント設定で指定したその他のオプションはすべて、モデル オプションとしてプロバイダーに**直接渡されます**。これにより、プロバイダー固有の機能とパラメーターを使用できるようになります。
エージェント設定で指定したその他のオプションはすべて、モデルオプションとしてプロバイダーに**直接渡されます**。これにより、プロバイダー固有の機能とパラメーターを使用できるようになります。
たとえば、OpenAI の推論モデルを使用すると、推論の労力を制御できます。
@@ -668,9 +670,9 @@ opencode agent create
1. エージェントを保存する場所を尋ねます。グローバルまたはプロジェクト固有。
2. エージェントが行うべきことの説明。
3. 適切なシステム プロンプトと識別子を生成します。
3. 適切なシステムプロンプトと識別子を生成します。
4. エージェントがアクセスできるツールを選択できます。
5. 最後に、エージェント構成を含むMarkdown ファイルを作成します。
5. 最後に、エージェント設定を含む Markdown ファイルを作成します。
---
@@ -678,11 +680,11 @@ opencode agent create
さまざまなエージェントの一般的な使用例をいくつか示します。
- **ビルド エージェント**: すべてのツールを有効にした完全な開発作業
- **ビルドエージェント**: すべてのツールを有効にした完全な開発作業
- **計画エージェント**: 変更を加えずに分析および計画を立てる
- **レビュー エージェント**: 読み取り専用アクセスとドキュメント ツールを備えたコード レビュー
- **デバッグ エージェント**: bash および読み取りツールを有効にして調査に重点を置きます
- **ドキュメント エージェント**: ファイル操作を使用してドキュメントを作成しますが、システム コマンドは使用しません
- **レビューエージェント**: 読み取り専用アクセスとドキュメントツールを備えたコードレビュー
- **デバッグエージェント**: bash および読み取りツールを有効にして調査に重点を置きます
- **ドキュメントエージェント**: ファイル操作を使用してドキュメントを作成しますが、システムコマンドは使用しません
---
@@ -696,7 +698,7 @@ opencode agent create
---
### 文書作成エージェント
### ドキュメント作成エージェント
```markdown title="~/.config/opencode/agents/docs-writer.md"
---
@@ -718,7 +720,7 @@ Focus on:
---
### セキュリティ監査
### セキュリティ監査エージェント
```markdown title="~/.config/opencode/agents/security-auditor.md"
---