Keyboard shortcuts

Press or to navigate between chapters

Press ? to show this help

Press Esc to hide this help

エージェント

エージェントは ZeroClaw デプロイメントの主役です。本書のその他すべて、すなわちプロバイダー、チャネル、セキュリティプロファイル、スキル、メモリは、エージェントが利用できるように存在しています。このセクションは見せ場であり、ドキュメントの残りはエンドクレジットのようなものです。

マルチエージェント。 ZeroClaw は 1 つのインストールから多数のエージェントを実行します。各エージェントは独自の参照セット(リスクプロファイル、モデルプロバイダー、チャンネル)、独自のワークスペースディレクトリ、独自のメモリバックエンドを持ちます。エージェントは、親のアイデンティティとセキュリティポリシーを継承する一時的な SubAgent を生成でき、エージェントは peer group を共有している場合に相互に通信できます。設定では、各エージェントは [agents.<alias>] ブロックです。Agents → Runtime internals を参照してください。

エージェントは結合点です

エージェントとは、インストールするプログラムではありません。それは2つの要素を結合する名前付きの行 [agents.<alias>] です。

  • 設定参照(リレーショナルな側面): 他の場所で設定されたものへのポインタです。モデルプロバイダ、リスクプロファイル、ランタイムプロファイル、チャネル、スキル / ナレッジ / MCP バンドル、cron ジョブなどがあります。それぞれがドット区切りのエイリアスになっています。エージェントはこれらを所有しません。エージェントはそれらを指し示すだけであり、多くのエージェントが同じものを指したり、自由に分岐したりできます。
  • Filesystemコンポーネント(ディスク側): エージェントごとのワークスペースディレクトリ、メモリバックエンド、アイデンティティ(パーソナリティ)ソース。これは、リレーショナルグラフが具体的なディレクトリツリーと交わる場所です。
  Config references (relational)              Filesystem (on-disk)
  ──────────────────────────────             ──────────────────────
  - model provider                           - workspace/
  - risk profile                             - memory store
  - runtime profile          agents.<alias>  - identity / personality
  - channels             ──▶  (the join)  ◀──
  - peer groups
  - skill / knowledge / MCP bundles
  - cron jobs

エージェントは左側の参照を指し示しますが、それらを所有していません。複数のエージェントが1つを共有したり、自由に分岐したりできます。エージェントは右側のファイルシステム部分を所有します。

各参照は、それぞれのセクションへのリンクになっています。クレジット: モデルプロバイダーは Model Providers、プロファイルは Security & Autonomy、チャンネルは Channels、ピアグループは Peer Groups、バンドルは Tools にあります。

最初からマルチエージェント

特権的な「ザ・エージェント」は存在しません。ランタイムはエイリアスをキーとするエージェントのマップを保持し、シングルエージェント構成は単にサイズ1のマップにすぎません。最初に1つのボットから始めて後から追加するのではなく、エージェントを追加してそれぞれを接続し、設定の最初の行から共存します。

各エージェントはそれぞれ独自の参照と独自のファイルシステムに接続するため、エージェント間で一部の軸を共有しつつ、他の軸では独立して分岐させることができます。2つのエージェントが1つのモデルプロバイダーを共有しながらも、異なるリスクプロファイルで動作し、異なるチャネルで応答し、完全に別々のメモリを保持するといったことが可能です。

エージェントは2つの方法で互いに到達でき、それぞれ別々に制御されます。エージェントはピアグループを共有するチャネル上でメッセージを送信できます。また、呼び出し元のリスクプロファイルが委譲を許可し、ターゲットが呼び出し元の到達可能なセット(同一プロファイルのピア、または呼び出し元のdelegatesリストにある明示的なクロスプロファイルのエントリ。エージェントの実行を参照)に含まれる場合にのみ、互いにタスクを**委譲**できます。

                    agents.researcher          agents.support
                    ─────────────────          ──────────────
  model provider     openrouter.prod ◀───────── openrouter.prod   (same one)
  risk profile       hardened                   permissive        (diverge)
  channel            discord.main               slack.helpdesk    (diverge)
  peers              └──────▶ peer group on discord.main ◀───────┘

2 つのエージェントが 1 つのモデルプロバイダーを共有し、それぞれ異なるリスクプロファイルで実行され、異なるチャネルで応答し、ピアグループを共有する場合にのみ相互作用します。

SubAgentは、共存に対する短命の例外です。エージェントは、親のアイデンティティとセキュリティポリシーを継承する一時的なSubAgentを生成し、単一のタスクを実行できます。委任とSubAgentを参照してください。

次に進む場所

  • エージェントの構造: [agents.<alias>] のすべてのフィールドと、各参照が指す対象について説明します。
  • Filesystemコンポーネント: エージェントごとにディスク上に存在するワークスペース、メモリ、アイデンティティ。
  • エージェントの実行: エージェントの指定、共存、およびエージェントが zerocode Code と Chat ペインにどのように表示されるか。

ランタイムの内部構造、パーミッションモデル、メモリモデル、エージェントループについては、Runtime internals を参照してください。