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

# エージェント

> 作業を分担する子エージェント、名前を付けたエージェント、オーケストレーション、互いにやり取りするセッション。

## 子エージェント

エージェントは、リクエストの一部を子エージェントに任せられます。子エージェントはそれぞれ白紙の状態から始め、担当部分に取り組み、最終的な応答だけを返します。複数を同時に実行できます。それぞれの子エージェントは、それを始めたステップの下に1行ずつ表示されます。子エージェントが求める承認には、どの子エージェントからのものかが表示されます。

| 種類 | 動作 |
| - | - |
| 調査 | 読み取りだけを行います。 |
| 編集 | フォルダの一時的なGitワークツリーで作業します。終わると、変更はフォルダにマージされます。ステージやコミットはされません。変更が競合した場合は何も書き込まず、パッチを保管します。Gitリポジトリが必要です。 |
| バックグラウンド | 子エージェントの作業中もエージェントは作業を続けます。結果は、終わったときに会話に戻ります。 |

子エージェントが親より多くのことをできることはありません。あなたの[権限モード](https://docs.archetype.ing/ja/use/approvals.md)と承認ルールは、子エージェントの呼び出しにも適用されます。子エージェントに質問があれば、まず親に尋ねます。親が10分以内に答えなければ、質問はあなたに届き、**要対応**に表示されます。

子エージェントは、Archetype自身のモデル、Claude Code、Codexで有効です。無効にするには、ユーザ設定に`"children": false`を書きます。

**トークンマキシング**は速さを優先します。エージェントは作業を独立した部分に分け、すべてを子エージェントとして同時に実行します。ステータスバーか`/tokenmaxxing`でオンにします。

## 名前付きエージェント

組み込みのエージェントは2つあります。`general`と、読み取りだけを行う`explore`です。独自のエージェントはMarkdownファイルとして追加します。エージェントは、名前と説明をもとにどれを使うかを選びます。

```markdown theme={null}
---
name: reviewer
description: Reads the changed files and finds bugs and missing tests
mode: inspect        # inspect or edit; without it, the task decides
tools: [read_file, search_text]   # without it, every tool of the mode
model: gpt-6-luna    # a model of the parent's provider; without it, the parent's
max-turns: 30        # 1 to 200; without it, no limit
---

Read the change closely. For each problem, give the path, the line and why.
```

| 場所 | 対象 |
| - | - |
| `~/.config/archetype/agents/*.md` | あなた（すべてのフォルダ） |
| `.archetype/agents/*.md` | このプロジェクト |

あなたのエージェントは、同じ名前の組み込みエージェントを置き換えます。プロジェクトのエージェントは、新しい名前を追加するだけです。組み込みやあなたのエージェントと同じ名前のものは警告とともにスキップされるため、クローンしたリポジトリが`explore`の動作を変えることはできません。

## オーケストレーション

1つの会話に収まらない作業では、1つのセッションがほかのセッションを主導します。

**1. 始める**

`/orchestration`と、してほしいことを入力します。または、フォルダの新規セッションのメニューで**オーケストレーション**を選びます。

**2. 計画に同意する**

主導するセッションが計画を書きます。ステップ、それぞれの完了の条件、どのエンジンが担当するかです。あなたが「Start」と答えるまで、何も始まりません。変更してほしいことを言葉で伝えると、計画を書き直します。

**3. ステップを実行する**

各ステップは専用のブランチで、同時に3つまで実行されます。ステップが終わると、別のエンジンにサインインしていれば、そのエンジンが確認します。確認に2回失敗したステップは、あなたを待ちます。

**4. 結果を受け取る**

デフォルトでは、各ステップのプルリクエストが準備でき、チェックが通った状態で終わります。主導するセッションが、マージする順序を提案します。

ステップからの質問は、まず主導するセッションに届きます。あなたにしか決められないことは、主導するセッションの会話に届きます。設定は、設定ファイルの`orchestration`にあります。`"orchestration": false`で無効にします。

## 互いにやり取りするセッション

同じコンピュータ上の会話は、互いにメッセージを送れます（[A2A](https://a2a-protocol.org/)プロトコル）。別のセッションに確認する、別のフォルダで作業を始める、といったことをエージェントに頼めます。

* 作業中のセッションに送ったメッセージは、実行中のリクエストに加わります。作業中でなければ、そこで新しいリクエストを始めます。
* 受け取ったセッションは、自身の権限で作業し、自身の承認を求めます。
* 別のセッションへの送信や停止は、`ask`モードでは先に確認し、`read-only`では拒否されます。
* エージェントが新しいセッションを開くのは、あなたが頼んだときだけです。そうでなければ、作業を子エージェントに分けます。
* 人が介さずにメッセージが8回やり取りされると、それ以上は送られません。

`"a2a": false`で無効にします。プロジェクトの設定に書くと、そのフォルダでだけ無効になります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.