DCP-AI + Express の API サーバーのテンプレート¶
英語版の参考訳です(26/10/2026 更新)。内容が異なる場合は英語版が優先されます。識別子、コマンド、コードブロックは翻訳せずにそのまま掲載しています。
サーバーの中で DCP のバンドルの確認がどこに入るかを示す Express の API です。
署名は検証しません。 テンプレートの
verifyBundleはバンドルの構造(バージョン、マニフェストのフィールド、複合署名の有無、セッションの nonce)だけを確認します。署名は 1 つも検証しないため、偽造または改変されたバンドルが通ってしまいます。ルートと流れを見るために使い、検証器としては使わないでください。バンドルを検証するには、@dcp-ai/express2.1.0か SDK のverifySignedBundleV2を、docs/QUICKSTART_EXPRESS.md のように使ってください。
クイックスタート¶
-
依存関係をインストールします:
-
サーバーを起動します:
テンプレートは .dcp/ を読まないため、npx @dcp-ai/cli init は不要です(また、そのウィザードはデモです:エージェントの作成)。
このテンプレートがすること¶
- バンドルの構造を確認する DCP のミドルウェアを持つ Express の API サーバーを実行する(上記参照)
- エージェントは保護されたルートに届くために Citizenship Bundle を提示する
- 公開のルートと保護されたルートのレートを制限する
- 構造の確認を通ったバンドルが名乗るエージェントを、メモリー上のレジストリに保持する。その
agent_idと 能力は自己申告で検証されておらず、レジストリは再起動で失われる /agents/actionは何も実行しない。行動をバンドルが自己申告した能力と照らし合わせ、action_idを返す/verify、/health、/agents/*、/.well-known/dcp-capabilities.jsonを提供する
エンドポイント¶
| メソッド | パス | 認証 | 説明 |
|---|---|---|---|
| GET | /health |
なし | ヘルスチェック |
| POST | /verify |
なし | DCP のバンドルの構造の確認(署名の検証なし) |
| POST | /agents/action |
DCP | 模擬的な受領確認:バンドルに対する能力の確認のみで、行動は実行しない(バンドルが必要) |
| GET | /agents/registry |
DCP | 登録されたエージェントを一覧する |
| GET | /.well-known/dcp-capabilities.json |
なし | 能力の発見 |
ファイル¶
index.js— DCP のミドルウェアを持つ Express のサーバーpackage.json— 依存関係