95e0f34d31
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese, French and German (18 pages each), mirroring the existing en/ru structure. - generate the 5 new locales in config.ts from a single strings table (nav, sidebar, search, footer, docFooter, outline, editLink) with locale-prefixed links - rework DocsCardGrid from the binary isRu check to a per-locale map so the home cards render translated copy and prefixed links for every locale
85 lines
7.2 KiB
Markdown
85 lines
7.2 KiB
Markdown
---
|
||
title: コンセプト – Agent Teams ドキュメント
|
||
description: Agent Teams 全体で使われる中核的な用語集 — チーム、リード、チームメイト、タスク、カンバン、インボックス、ランタイム、レビューについて。
|
||
lang: ja-JP
|
||
---
|
||
|
||
# コンセプト
|
||
|
||
このページでは、Agent Teams 全体で使われる中核的な用語を定義します。アプリ、タスクボード、メッセージ、レビューフローで共有される語彙としてご利用ください。
|
||
|
||
## チーム
|
||
|
||
チームとは、1 つのプロジェクトパスに紐付けられた、名前付きのエージェントのグループです。リード、任意のチームメイト、ランタイム/プロバイダー設定、プロンプト、インボックス、タスク、ローカルの起動状態を持ちます。
|
||
|
||
## リード {#lead}
|
||
|
||
リードはチームのコーディネーターです。ユーザーの目標をタスクへと変換し、チームメイトを割り当てたり再配置したりし、ブロッカーを追跡し、レビューを依頼し、ボード上で作業を前進させ続けます。
|
||
|
||
[チームメイト →](#teammate)
|
||
|
||
リードのメッセージは、チームメイトのメッセージとは異なる配信経路を使います。アプリはリードのインボックスのエントリをリードのランタイムにリレーしますが、チームメイトはターンの合間に自身のインボックスファイルを読み取ります。
|
||
|
||
## チームメイト {#teammate}
|
||
|
||
チームメイトとは、チーム内のリード以外のエージェントです。チームメイトは通常、builder、reviewer、researcher、tester といった特定のロールを担います。チームメイトはダイレクトメッセージ、タスクの割り当て、タスクコメント、レビュー依頼を受け取れます。
|
||
|
||
[リード ↑](#lead)
|
||
|
||
## タスク
|
||
|
||
タスクとは、作業の永続的な単位です。id、ステータス、オーナー、説明、コメント、ログ、添付ファイル、タスク参照、レビュー可能な変更を持ちます。
|
||
|
||
一般的なタスクの状態は `todo`、`in_progress`、`done`、`review`、`approved` です。内部的には、タスクファイルが作業状態を保存する一方で、review と approved の配置にはカンバンのオーバーレイ状態も使われることがあります。
|
||
|
||
## カンバン
|
||
|
||
カンバンとは、チーム作業のボードビューです。状態ごとにタスクを一覧したり、タスクの詳細を開いたり、ログを確認したり、差分をレビューしたり、完了した作業を承認したり、変更を依頼したりできます。
|
||
|
||
## インボックス
|
||
|
||
インボックスとは、チーム参加者向けのローカルなメッセージファイルです。Agent Teams は、ユーザーメッセージ、リードメッセージ、チームメイトメッセージ、ランタイム配信のメタデータ、クロスチームメッセージ、一部のシステム通知にインボックスを使用します。
|
||
|
||
メッセージは永続的なローカルレコードです。配信は依然として、選択したランタイムが生存していて次のターンを処理できることに依存します。
|
||
|
||
## エージェントブロック
|
||
|
||
エージェントブロックとは、`<info_for_agent>...</info_for_agent>` でラップされた、エージェント専用の非表示の指示テキストです。UI は通常の人間向け表示からこれらのブロックを取り除きますが、エージェントとランタイム配信はそれらを調整の詳細として利用できます。
|
||
|
||
現在の正規のマーカーは `info_for_agent` です。古いドキュメントでは `info_for_agent` マーカー付きのフェンス付きコードブロックや、XML スタイルの `<agent_block>` タグを使っている場合があります。これらはレガシーなパターンであり、見つけたら `info_for_agent` へ移行すべきです。(元のタグ名は `agent-block` でした。アンダースコア形式の `<agent_block>` は、HTML としてのパースを避けるために VitePress のソースで使用されています。)
|
||
|
||
## コンテキストフェーズ
|
||
|
||
コンテキストフェーズとは、セッションのコンテキストタイムラインを構成する 1 つのセグメントです。コンパクションが新しいフェーズを開始するため、リセットの前後でトークンとコンテキストの使用状況を分析できます。
|
||
|
||
コンテキストの追跡では、プロジェクトの指示、メンションされたファイル、ツール出力、思考テキスト、チームの調整、ユーザーメッセージといったカテゴリを区別します。これらの数値は診断用であり、プロバイダーの請求明細ではありません。
|
||
|
||
## ランタイム
|
||
|
||
ランタイムとは、エージェントのターンを実行するローカルの実行経路です。サポートされるランタイム経路には Claude Code、Codex、OpenCode が含まれます。
|
||
|
||
ランタイムは、モデルの実行挙動、認証の詳細、ツール実行のセマンティクス、レート制限、モデルの可用性、一部のトランスクリプト/ログ形式を担います。
|
||
|
||
## プロバイダー
|
||
|
||
プロバイダーとは、ランタイムの背後にあるモデルアクセス経路です。現在のプロバイダー id には Anthropic、Codex、Gemini、OpenCode が含まれます。OpenCode は、独自の設定を通じて多くのモデルプロバイダーへルーティングできます。
|
||
|
||
Agent Teams はタスクとメッセージをオーケストレーションしますが、プロバイダーの認証やプロバイダーのポリシーを置き換えるものではありません。
|
||
|
||
## ソロモード
|
||
|
||
ソロモードは、1 メンバーのチームを実行します。手早い作業、調整オーバーヘッドの削減、フルチームへ拡張する前のプロンプト検証に役立ちます。
|
||
|
||
## クロスチームコミュニケーション
|
||
|
||
エージェントはチーム内およびチーム間でメッセージを送信できます。別々のチームが関連する作業を担当しており、すべてを 1 つの大きなチームにまとめることなく調整する必要がある場合に使用します。
|
||
|
||
## 自律性のレベル
|
||
|
||
自律性は、エージェントが確認を求める前にどこまで実行できるかを制御します。自律性が高いほど速く、低いほど、機微なコードパス、永続化、プロバイダー認証、Git 操作、リリースに対して安全です。
|
||
|
||
## レビュー
|
||
|
||
レビューとは、タスクスコープの受け入れフローです。タスクは review に移動し、コメントや変更依頼を受け取り、結果が受け入れられると approved に移動できます。
|
||
|
||
レビューはローカルの差分とタスク履歴に結び付いているため、タスクが狭い範囲に保たれ、エージェントが作業中のタスクをメンションするときに最も効果を発揮します。
|