エージェント

Agents は、特定のタスクやワークフロー向けに設定できる Specialized AI Assistants です。カスタムプロンプト、モデル、ツールアクセスを持つ集中型のツールを作成できます。

Types

OpenCode には Primary Agents と Subagents の2 種類のエージェントがあります。

Primary Agents

Primary Agents は、直接対話するメインアシスタントです。Tab キーまたは設定した switch_agent キーバインドで切り替えられます。

OpenCode には 2 つのビルトイン Primary Agents が付属しています：Build と Plan。

Subagents

Subagents は、Primary Agents が特定のタスクのために呼び出せる Specialized Assistants です。メッセージ内で @ メンション することで手動で呼び出すこともできます。

OpenCode には 3 つのビルトイン Subagents が付属しています：General、Explore、Scout。

Built-in

OpenCode には、2 つのビルトイン Primary Agents と 3 つのビルトイン Subagents が付属しています。

Use Build

Mode: primary

Build は、開発作業向けの全ツールが有効な デフォルト Primary Agent です。

Use Plan

Mode: primary

分析及計画専用の制限付きエージェントです。デフォルトで file edits と bash は ask に設定されています。変更を加えずにコード分析を行う場合に便利です。

Use General

Mode: subagent

複雑な調査やマルチステップタスクの実行に特化した汎用エージェントです。并行作業のための全ツールアクセスを持っています。

Use Explore

Mode: subagent

コードベースを高速に探索する読み取り専用エージェントです。ファイルの検索、コードの検索、コードベースに関する質問への回答に素早く使用できます。

Use Scout

Mode: subagent

外部ドキュメントや依存関係調査用の読み取り専用エージェントです。ライブラリソースの検査や、ローカルコードの上流実装との照合に使用できます。

Use Compaction

Mode: primary | Hidden

長いコンテキストを小さなサマリーに圧縮するシステムエージェントです。必要に応じて自動的に実行されます。

Use Title

Mode: primary | Hidden

短いセッションタイトルを生成するシステムエージェントです。自動的に実行されます。

Use Summary

Mode: primary | Hidden

セッションサマリーを作成するシステムエージェントです。自動的に実行されます。

Usage

Primary Agents の場合、セッション中に Tab キーで切り替えられます。
Subagents は以下のように呼び出せます：
- Primary Agents がその説明に基づいて 自動的に 呼び出す
- @ メンション で手動呼び出し：@general help me search for this function
セッション間のナビゲーション：Subagents が子セッションを作成したとき：
- session_child_first（デフォルト：Leader+Down）で最初の子セッションに入る
- session_child_cycle（デフォルト：Right）で次の子セッションに循環
- session_parent（デフォルト：Up）で親に戻る

Configure

Agents は 2 つの方法で設定できます：

JSON

opencode.json でエージェントを設定します：

{
  "agent": {
    "build": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-4-20250514",
      "permission": {
        "edit": "allow",
        "bash": "allow"
      }
    },
    "plan": {
      "mode": "primary",
      "permission": {
        "edit": "deny",
        "bash": "deny"
      }
    }
  }
}

Markdown

Markdown ファイルでエージェントを定義します：

-グローバル：~/.config/opencode/agents/

プロジェクトごと：.opencode/agents/

---
description: Reviews code for quality
mode: subagent
permission:
  edit: deny
  bash: deny
---

You are in code review mode. Focus on security, performance, and maintainability.

Options

Description

必須 - エージェントの機能の簡単な説明。

Temperature

temperature でランダム性を制御します：

0.0-0.2: 非常に集中型、コード分析に最適
0.3-0.5: バランス型、一般的な開発に適切
0.6-1.0: よりクリエイティブ、ブレインストーミングに便利

Max Steps

強制テキスト応答前の最大エージェント反復回数を制御します。

{
  "agent": {
    "quick-thinker": {
      "steps": 5
    }
  }
}

Disable

disable: true を設定してエージェントを無効にします。

Prompt

カスタムシステムプロンプトファイルを指定します：

{
  "agent": {
    "review": {
      "prompt": "{file:./prompts/code-review.txt}"
    }
  }
}

Model

このエージェントのモデルを上書きします：

{
  "agent": {
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514"
    }
  }
}

Permissions

エージェントが実行できるアクションを管理するための権限を設定します：

"ask" — 実行前に承認を求める
"allow" — 承認なしに許可
"deny" — ツールを無効にする

利用可能な権限キー：read、edit、glob、grep、list、bash、task、external_directory、todowrite、webfetch、websearch、lsp、skill、question、doom_loop

{
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "git push": "ask",
          "git status *": "allow"
        }
      }
    }
  }
}

Mode

エージェントのモードを制御：primary、subagent、all。

Hidden

hidden: true で Subagent を @ オートコンプリートメニューから非表示にします。プログラム的にのみ呼び出される内部エージェントに便利です。

Task Permissions

Taskツール経由でエージェントが呼び出せる Subagents を制御します：

{
  "agent": {
    "orchestrator": {
      "permission": {
        "task": {
          "*": "deny",
          "orchestrator-*": "allow",
          "code-reviewer": "ask"
        }
      }
    }
  }
}

Color

color（16進数またはテーマカラー：primary、secondary、accent、success、warning、error、info）でエージェントのビジュアル外観をカスタマイズします。

Top P

ランダム性制御の温度 альтернатива（0.0〜1.0）。

Additional

その他のオプションは、モデル固有機能のために Provider に直接渡されます。

Create Agents

以下を使用して新しいエージェントを作成します：

opencode agent create

このインタラクティブコマンドは：

保存場所を指定（グローバルまたはプロジェクト）
エージェントの説明を入力
システムプロンプトと識別子を生成
権限を選択
Markdownファイルを作成

Examples

Documentation Agent

---
description: Writes and maintains project documentation
mode: subagent
permission:
  bash: deny
---

You are a technical writer. Create clear, comprehensive documentation.

Security Auditor

---
description: Performs security audits and identifies vulnerabilities
mode: subagent
permission:
  edit: deny
---

You are a security expert. Look for input validation vulnerabilities, authentication flaws, data exposure risks.