HN 日本語サマリー

← 一覧へ戻る
オープンソース

Collaborative Human Agent Protocol (CHAP)

Collaborative Human Agent Protocol (CHAP) (github.com)

20 pointsby arsalanshahid4 コメント

要約

CHAP (Collaborative Human-Agent Protocol) は、人間とエージェントが協力して作業を行うためのプロトコルです。エージェントが作成したドラフトと人間の編集内容を、クエリ、再生、検証可能な「エンベロープ」として保存します。これにより、問題発生時の原因究明が容易になり、開発プロセスにおけるエージェントの意思決定の履歴を追跡・分析することが可能になります。

全文翻訳

協調型人間・エージェントプロトコル (CHAP)


[画像: 同じシナリオ、2つのスタック。CHAPなしの場合:6つのツールが1つの決定の断片を保持(OpenAIログ失効、Zendeskスレッド、Slackスクロール済み、Linearコメント、Webhookテール、Notionランブック)、4つのUIを横断して45分かけて「エージェントは何をドラフトし、なぜ承認したのか?」に答える。CHAPとそのハッシュチェーンをオンにした場合:3つのハッシュリンクされた封筒(task.create → artefact → decide.override)がprev_hashで結合され、1回のaudit.read呼び出しで30秒。]


仕事は、数百のエージェントと数百人の人々が参加するチームへと移行しています。エージェントはドラフトを作成し、トリアージし、推奨します。人間は承認し、修正し、却下し、エスカレートします。これらの人間の決定は作業に説明責任を持たせますが、通常はチャットスレッド、チケットコメント、記憶の中にしか記録されません。

CHAPは、これらの決定に明確な構造と監査可能な記録を提供します。エージェントが生成したもの、人間が決定したもの、そしてその理由を、クエリ可能で検証可能な1つのログに記録します。

  • 構造化されたオーバーライド。人間がエージェントの作業を編集する場合、その編集は、差分、理由、チームが定義したタグとともに記録されるため、後で修正を分析できます。
  • 改ざん検出可能なログ。すべての変更は順序通りに記録されます。ハッシュチェーンがオンになっている場合、最近のチェーンヘッドがオペレーターの手の届かない場所に保持されている限り、改変されたエントリは検証時に検出されます(SECURITY.md §5)。履歴は、キーのローテーション、ベンダーログの失効、スタッフの変更を経ても存続します。
  • 署名とID。プロファイルと呼ばれるオプションの拡張機能は、すべての呼び出しに署名することを要求し、署名キーを検証済みのIDにバインドし、エントリをトランスペアレンシーログに提出します。
  • MCPおよびA2Aと並行して。MCPはエージェントとツールを接続し、A2Aはエージェント同士を接続します。CHAPはエージェントが人間と共有する作業を記録します。

コンセプト

CHAPはプロトコルです。これは、エージェント、人間、およびそれらのツールが、ワークスペースを仲介するサービスであるコーディネーターに送信する一連の呼び出しです。コーディネーターは、各呼び出しをワークスペースのルールに対してチェックし、応答し、受け入れられた各変更をワークスペースの監査ログに記録します。TypeScriptおよびPythonパッケージはコーディネーターであり、独自のプロセスに組み込んだり、サーバーとして実行したりできます。

用語内容
ワークスペース1つの作業体に対する名前付きコンテキスト:そのメンバー、タスク、および使用するプロファイル
参加者URI(例: human:alice@example.org または agent:triage)によって名前付けされたメンバー。group: はメンバーのセットを名前付けします
タスク参加者に割り当てられた作業単位
成果物参加者がタスクで生成するもの:ドラフト、決定、オーバーライド
封筒1回の呼び出し、JSON-RPC 2.0メッセージとして。その method は動詞です(例: task.create または decide.approve)
監査ログワークスペースのすべての変更の順序付けられた記録。ハッシュチェーンがオンの場合、各エントリは前のエントリのハッシュを含みます

動詞は名前の通りに読みます。タスクは作成、完了、レビュー依頼(task.create、task.complete、review.request)されます。レビュアーはそれを承認、拒否、またはオーバーライドします(decide.approve、decide.reject、decide.override)。作業は引き継がれたり、エスカレートされたりします(handoff.propose、escalate.raise)。audit.read は記録を返します。

コアとプロファイル。すべてのコーディネーターはコア(core/1.0)を実装しています:ワークスペース、参加者、タスク、および監査ログ。それ以外のすべてはオプションのプロファイルで、バージョン名が付けられています。review/1.0 はレビューリクエストと決定を追加します。その他には、人への簡単な質問(whisper/1.0)、グループ投票(deliberation/1.0)、引き継ぎ(handoff/1.0)、一時停止とロールバック(control/1.0)、ルーティング(routing/1.0)、シャドウおよびトライアルモード(modes/1.0)、署名付き呼び出し(security-signed/1.0)、検証済みID(identity-oidc/1.0、identity-vc/1.0)、およびトランスペアレンシーログ(audit-scitt/1.0)を追加します。ワークスペースは使用しているプロファイルをアドバタイズし、コーディネーターは他のプロファイルに属する呼び出しを拒否します。core/SPEC.md はコアを1ページにまとめ、profiles/PROFILES.md はプロファイルをリストし、GLOSSARY.md はすべての用語を定義します。

インストール

ライブラリ。各パッケージはコアとすべてのプロファイルを実装しています。新しいワークスペースは、指定しない限り core/1.0 と review/1.0 をアドバタイズします。

TypeScript

Python

npm install @brightbeamai/chap-coordinator
pip install chap-coordinator

新しいプロジェクト。create-chap-app は、レビューデスク、1つのプロファイル設定、および diff-profiles コマンドを備えたプロジェクトを生成します。

npx create-chap-app my-gate
cd my-gate && npm install && npm run demo

デフォルトのテンプレートはコードゲートです。コーディングエージェントがGitリポジトリで行った各変更は、差分としてレビューされ、レビュアーの署名で承認され、CIが検証できるように証拠とともにコミットされます。その他のテンプレートは、Claude Desktop、Cursor、Claude Code用のMCPゲート、サポートデスク、アウトバウンド承認ゲート、およびプロダクションセットです。docs/profile-explorer.md は、各プロファイルが何を変更するかを示しています。

このリポジトリのクローンから。START_HERE.md は、Python 3.10以降とインストール不要で、Pythonコーディネーターでローカルレビューデスクを実行します。

git clone https://github.com/BrightbeamAI/chap.git && cd chap
python3 start-here/start.py

examples/00-five-minute-start.md は、curl を使用してコア参照サーバーに封筒を送信し、監査ログを読み戻します。ライブラリは packages/coordinator/ および packages/coordinator-py/ にあり、参照実装は reference/ および reference/python/ にあります。

90秒ツアー

A solo developer reviews pull requests with Cursor, and the bot flags a warning the developer disagrees with. The clip shows the exchange in six steps, in about 23 seconds.

[画像: 6ステップのCHAP Core+Reviewウォークスルー。上部にプログレスバーとステップインジケーターが表示されています。ステップ1:セットアップ(ワークスペース、2人の参加者、タスク)。ステップ2:ドラフト(エージェントがレスポンスをドラフト)。ステップ3:レビュー待ち(draft artefact を伴う review.request)。ステップ4:オーバーライド(人間が同意しない:diff、理由、タグ)。ステップ5:監査チェーン(ハッシュリンクされた再生、prev_hash 連続)。ステップ6:2ヶ月後(オーバーライド学習レポートは、上位タグとして framework-pattern を示し、次のプロンプト改訂を正しい問題に向けます)。]

各ステップのコードは、TypeScriptとPythonで提供されます。

1. ワークスペースの起動:SQLiteとハッシュチェーンを備えたコーディネーター、および2人の参加者

TypeScript

Python

import { Coordinator } from "@brightbeamai/chap-coordinator";
import { SqliteStore } from
  "@brightbeamai/chap-coordinator/storage/sqlite";

const coord = new Coordinator({
  store: new SqliteStore("./chap.db"),
  enableChain: true,
});

coord.api.workspace.create({
  workspace: "wsp_pr_reviews",
  profiles:  ["core/1.0", "review/1.0"],
});

coord.api.participant.join({
  workspace: "wsp_pr_reviews",
  from:      "human:me@local",
  type:      "human",
});

coord.api.participant.join({
  workspace: "wsp_pr_reviews",
  from:      "agent:cursor#v1",
  type:      "agent",
});
from chap_coordinator import Coordinator
from chap_coordinator.storage.sqlite \
    import SqliteStore

coord = Coordinator(
    store=SqliteStore("./chap.db"),
    enable_chain=True,
)

def send(method, params):
    return coord.dispatch({
        "jsonrpc": "2.0", "id": method,
        "method": method, "params": params,
    })

send("workspace.create", {
    "workspace": "wsp_pr_reviews",
    "profiles":  ["core/1.0", "review/1.0"],
})

send("participant.join", {
    "workspace": "wsp_pr_reviews",
    "from":      "human:me@local",
    "type":      "human",
})

send("participant.join", {
    "workspace": "wsp_pr_reviews",
    "from":      "agent:cursor#v1",
    "type":      "agent",
})

2. ボットがドラフトし、あなたがオーバーライドする:Cursorインテグレーションが封筒を発行します

TypeScript

Python

// Cursorが返したレビュー。
const cursorReview = {
  comments: [{ severity: "warning",
               body: "Unused parameter." }],
};

// ボットのレビューはタスクの出力です。
const { task_id } = coord.api.task.create({
  workspace: "wsp_pr_reviews",
  from:      "agent:cursor#v1",
  assignee:  "agent:cursor#v1",
  kind:      "code_review",
  input:     { pr_id: "PR-482" },
});

coord.api.task.complete({
  workspace: "wsp_pr_reviews",
  from:      "agent:cursor#v1",
  task_id,
  output:    cursorReview,
});

coord.api.review.request({
  workspace: "wsp_pr_reviews",
  from:      "agent:cursor#v1",
  task_id,
  artefact:  cursorReview,
  to:        "human:me@local",
});

// 1つのコメントに同意しません。オーバーライドします。
coord.api.decide.override({
  workspace:        "wsp_pr_reviews",
  from:             "human:me@local",
  task_id,
  intent_preserved: true,
  diff: [{ op: "replace",
           path: "/comments/0/severity",
           value: "info" }],
  rationale: "False positive. Framework " +
             "convention, not a bug.",
  tags: ["false-positive",
         "framework-pattern-misread"],
});
# Cursorが返したレビュー。
cusor_review = {
    "comments": [{"severity": "warning",
                  "body": "Unused parameter." }],
}

# ボットのレビューはタスクの出力です。
r = send("task.create", {
    "workspace": "wsp_pr_reviews",
    "from":      "agent:cursor#v1",
    "assignee":  "agent:cursor#v1",
    "kind":      "code_review",
    "input":     {"pr_id": "PR-482"},
})
task_id = r["result"]["task_id"]

send("task.complete", {
    "workspace": "wsp_pr_reviews",
    "from":      "agent:cursor#v1",
    "task_id":   task_id,
    "output":    cursor_review,
})

send("review.request", {
    "workspace": "wsp_pr_reviews",
    "from":      "agent:cursor#v1",
    "task_id":   task_id,
    "artefact":  cursor_review,
    "to":        "human:me@local",
})

# 1つのコメントに同意しません。オーバーライドします。
send("decide.override", {
    "workspace":        "wsp_pr_reviews",
    "from":             "human:me@local",
    "task_id":          task_id,
    "intent_preserved": True,
    "diff": [{"op":    "replace",
              "path":  "/comments/0/severity",
              "value": "info"}],
    "rationale": "False positive. Framework "
                 "convention, not a bug.",
    "tags": ["false-positive",
             "framework-pattern-misread"],
})

2つのサーフェス。TypeScriptは型付きファサード coord.api.* を提供するため、すべてのメソッドにオートコンプリートとコンパイル時チェックがあります。PythonはJSON-RPC封筒をサーフェス coord.dispatch({...}) に保持し、ここでは send() ヘルパーでラップしています。これはPythonテストで使用されるイディオムです。どちらも同じ封筒で同じパラメータを送信するため、監査チェーンはどちらのクライアントが呼び出しを行ったかに関わらず同じように読み取れます。

3. 2ヶ月後:スクリプトがオーバーライドをタグ、意図、レビュアーごとにグループ化します

リポジトリには、両方の言語でスクリプトが含まれています。これは、HTTP経由で、またはSQLiteファイルから直接監査チェーンを読み取ります。

# TypeScript参照、ステップ1のSqliteStoreに対して:
$ npx tsx reference/core-plus-review/analyze-overrides.ts --db ./chap.db wsp_pr_reviews

# Python参照、同じ考え方:
$ python3 reference/python/analyze_overrides.py --db ./chap.db wsp_pr_reviews

Override Learning Report
========================================
Workspace:       wsp_pr_reviews
Total overrides: 47

By tag:
  false-positive                       ████████████████████   31  (66%)
  framework-pattern-misread            ██████████████          22  (47%)
  cosmetic-pref                        █████                    8  (17%)

Intent breakdown:
  refining (same decision, better wording)   41
  substituting (different decision)          6

Top reviewers:
  human:me@local                            47

Hint: the most common tags are your next prompt revision targets.

最も一般的なタグは、Cursorの次のプロンプト改訂で修正すべきことを示しています。

chap-analytics(pip install chap-analytics)は、SQLiteファイル、JSONエクスポート、ライブコーディネーター、または audit.read からチェーン全体をドキュメント化されたpandasテーブルにロードします:オーバーライド、決定、レビュアー、ウィスパー、ハンドオフ。 Notebook は1週間のレビューデータを処理し、ANALYTICS_ROADMAP.md は計画されている作業を説明しています。

オーバーライド封筒

オーバーライド封筒は、レビュアーによるエージェントの出力への変更を記録します。各フィールドは以下に注釈付けされています。

[画像: decide.override封筒の構造。各フィールドに注釈が付いています:task_idはレビューチェーンへのリンク、fromはクエリ可能なIDを保持、logical_idは改訂を生き残る、intent_preservedはrefiningとsubstitutingオーバーライドを分離、diffはRFC 6902 JSON Patch、rationaleは「what」に沿った「why」、tagsは構造化された監視データ。]

分析において最も重要な2つのフィールドは次のとおりです。

  • intent_preserved は、人間の決定を維持してその言葉遣いを書き直した「リファイン」オーバーライドと、人間が異なる決定を下した「サブスティテュート」オーバーライドを区別します。それぞれが異なる修正を指し示します。1つのポリシー条項の周りの多くのリファインオーバーライドはエージェントの取得を指し、多くのサブスティテュートオーバーライドは曖昧なポリシーまたはエージェントのタスクコンテキストを指します。
  • tags は、チームが合意した小さく管理された語彙です。3ヶ月後に数えて、「どのプロンプトに作業が必要か?」および「ボットが常に間違えるパスはどれか?」という質問に答えるためのものです。

ステータス

CHAP 0.3は公開ドラフトです。小さなコアとオプションのプロファイル(SPECIFICATION.md)が含まれています。

  • 2つの参照コーディネーター(TypeScriptとPython)が同じメソッドを実装しており、差分ファザーがそれらが同様に応答し、ログに記録することを確認しています。
  • 適合性ハーネスはコアと review/1.0 をカバーし、PythonコーディネーターとスタンドアロンTypeScriptサーバーに対して実行されます。
  • コーディネーターは、MCP サーバーまたは A2A エージェントとして自身を提示できます。
  • フレームワークブリッジは、LangGraph、Pydantic AI、AG2、LlamaIndex Workflows、およびGoogle ADKの人間参加型決定を監査ログに配置します。

1.0の前に、マイナーリリースは互換性を破壊する可能性があり、その変更ログには移行とともに各破壊的変更がリストされます。1.0以降は、仕様はセマンティックバージョニングに従います。厳密な安定性を求める場合は、1.0までお待ちください。ROADMAP.md は、それが約束することと、その道のりのマイルストーンを示しています。

次に読むもの

読むもの対象
START_HERE.mdPythonコーディネーターでのローカルレビューデスク。Python以外のインストールは不要
IN_PRACTICE.mdソロ開発者とCursorからGMP規制製造まで、シナリオ
ABOUT.mdリポジトリの内容、CHAPがMCPおよびA2Aとどのように関連するか、再利用する標準、および貢献方法
core/SPEC.mdコア、1ページにまとめたもの
技術レポートアーキテクチャ、プロファイルセマンティクス、脅威モデル。シナリオはJSONトレースとして含まれます

引用

学術的または技術的な作業でCHAPを参照する場合は、技術レポートを引用してください。

BibTeX

@techreport{chap2026,
  author      = {Shahid, Arsalan and Suttie, Gordon and Black, Philip},
  title       = {Collaborative Human-Agent Protocol (CHAP): An open protocol for auditable, structured multi-human and multi-agent collaboration},
  institution = {Brightbeam AI},
  year        = {2026},
  type        = {Technical Report},
  number      = {arXiv:2606.09751},
  url         = {https://arxiv.org/abs/2606.09751}
}

CC BY 4.0 (仕様テキスト、LICENSE-SPEC.md参照) · Apache 2.0 (その他すべて) · 任意の言語、任意のデプロイメント。