Agents SDK v0.6.0：概要

公開日: 2026-02-25

最新の Agents SDK ↗ リリースでは、同一の Worker 内で Agent と McpAgent を RPC 経由で接続できるようになりました — HTTP を使わず、ネットワークのオーバーヘッドなしで通信できます。さらに、簡易な MCP 接続では OAuth をオプトインに変更し、プロダクションワークロード向けにスキーマ変換を強化し、@cloudflare/ai-chat に対する信頼性修正を複数含んでいます。

---

MCP 向け RPC トランスポート

同一 Worker 内で Durable Object バインディングを使って Agent と McpAgent を接続できるようになりました。接続は Cloudflare ランタイム内に留まり、ネットワーク往復やシリアライズのオーバーヘッドが発生しません。

addMcpServer に Durable Object namespace を直接渡します。

import { Agent } from "agents";
export class MyAgent extends Agent {
  async onStart() {
    // Connect via DO binding — no HTTP, no network overhead
    await this.addMcpServer("counter", env.MY_MCP);
    // With props for per-user context
    await this.addMcpServer("counter", env.MY_MCP, {
      props: { userId: "user-123", role: "admin" },
    });
  }
}

上記は JavaScript / TypeScript どちらでも動作します。addMcpServer メソッドは第二引数に string | DurableObjectNamespace を受け付けるようになり、HTTP と RPC の経路が型安全に区別され、混在できないようになっています。

主な機能:

• ハイバネーション対応 — Durable Object のハイバネーション復帰後も RPC 接続は自動的に復元されます。バインディング名と props はストレージに保存され、起床時に復元されます。HTTP の MCP 接続と同等の挙動です。
• 重複排除 — 同じサーバー名で addMcpServer を呼ぶと既存の接続を返し、重複した接続を作成しません。接続 ID はハイバネーション復元後も安定しています。
• サーフェスの縮小 — RPC トランスポートの内部実装を 609 行から 245 行に縮小しました。RPCServerTransport は手作りのチェックの代わりに MCP SDK の JSONRPCMessageSchema を検証に使用します。

注意: RPC トランスポートは実験的です。API はフィードバックに応じて変更される可能性があります。更新はトラッキング issue ↗ を参照してください。

---

MCP 接続での OAuth をオプトインに

addMcpServer() はもはや接続ごとに自動的に OAuth プロバイダを作成しません。認証を必要としないサーバーでは、単純な呼び出しだけで動作します。

// No callbackHost, no OAuth config — just works
await this.addMcpServer("my-server", "https://mcp.example.com");

サーバーが 401 を返した場合、SDK は次の明確なエラーを投げます:

"This MCP server requires OAuth authentication. Provide callbackHost in addMcpServer options to enable the OAuth flow."

ストレージからの復元フローでもコールバック URL が欠落している場合は適切に処理され、OAuth を要求しないサーバーについては認証プロバイダ作成をスキップします。

---

JSON Schema -> TypeScript コンバータの強化

generateTypes() と getAITools() で使われるスキーマコンバータが、以前は本番でクラッシュを引き起こしていたエッジケースに対応するようになりました。

• 深さと循環参照のガード — 再帰的または深くネストされたスキーマでのスタックオーバーフローを防止します。
• $ref 解決 — 内部 JSON Pointer（#/definitions/...、#/$defs/...、#）をサポートします。
• タプル対応 — prefixItems（JSON Schema 2020-12）および配列 items（draft-07）をサポートします。
• OpenAPI 3.0 nullable: true — すべてのスキーマ分岐でサポートされます。
• ツール単位のエラー隔離 — 1 つの不正なスキーマが generateTypes() や getAITools() の全パイプラインをクラッシュさせないようになりました。
• 入力スキーマ欠落時のフォールバック — getAITools() は投げる代わりに { type: "object" } にフォールバックします。

---

@cloudflare/ai-chat の修正

• ツール拒否フロー — 拒否されたツール承認（approved: false）は tool_result を伴う output-denied に遷移するようになり、Anthropic プロバイダ互換性の問題を修正しました。カスタム拒否メッセージは state: "output-error" と errorText でサポートされます。
• 中止/キャンセル対応 — ストリーミング応答は中止シグナル発火時にリーダーループを正しくキャンセルし、クライアントへ done シグナルを送ります。
• 重複メッセージの永続化 — persistMessages() は内容と順序で assistant メッセージを照合し、クライアントが全履歴を再送した場合の重複行の挿入を防ぎます。
• requestId in OnChatMessageOptions — ハンドラはストリーム前の失敗に対して適切にタグ付けされたエラーレスポンスを返せるようになりました。
• redacted_thinking の保持 — メッセージサニタイザが Anthropic の redacted_thinking ブロックを除去しなくなりました。
• /get-messages の信頼性 — エンドポイント処理を prototype の onRequest() オーバーライドからコンストラクタラッパーに移動し、ユーザーが onRequest をオーバーライドして super.onRequest() を呼ばない場合でも動作するようにしました。
• クライアントツール API の復活 — createToolsFromClientSchemas、clientTools、AITool、extractClientToolSchemas、および useAgentChat の tools オプションは、ランタイムでツールが動的に定義されるユースケースのために SDK で復活しました。
• jsonSchema 初期化問題の修正 — onChatMessage 内で getAITools() を呼ぶ際の jsonSchema not initialized エラーを修正しました。

---

アップグレード

最新バージョンに更新するには:

npm i agents@latest @cloudflare/ai-chat@latest

---

参考・リソース

• API ドキュメント
• ヘルプセンター
• System Status

---

© 2026 Cloudflare, Inc. Privacy Policy | Terms of Use