# API

自律 AI エージェントとリアルタイムに会話するための API です。SSE・MCP・A2A の 3 つの接続方式に対応し、会話履歴・ファイル・成果物の取得から、スキル・プレイブック・ユーザーの管理まで REST API として提供します。

## 3 つの接続方式

エージェントに送るリクエストと返るレスポンスの基本構造は、どの方式でも共通です。違うのは、つなぎ方と、クライアントが仕様をどう知るかです。

|              | Chat API / SSE         | MCP                        | A2A              |
| ------------ | ---------------------- | -------------------------- | ---------------- |
| **プロトコル**    | REST + SSE             | Streamable HTTP / JSON-RPC | JSON-RPC         |
| **エンドポイント**  | `/v1/chat/completions` | `/v1/mcp`                  | `/v1/a2a`        |
| **ディスカバリー**  | なし（API 仕様を参照）          | `tools/list` で自動取得         | Agent Card で自動取得 |
| **想定クライアント** | 自社アプリ / HTTP クライアント    | Claude 等の MCP 対応 AI エージェント | A2A 対応 AI エージェント |

- **Chat API / SSE** — 自社アプリケーションにエージェント機能を組み込む場合。リクエスト・レスポンスを自分で制御できます
- **MCP** — MCP 対応の AI エージェントから接続する場合。エージェントがツール定義を自動取得します
- **A2A** — A2A 対応のエージェントから接続する場合。Agent Card でスキルを自動取得します

比較の詳細と実装例は[接続方式ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/connection-guide.md)にあります。

## 扱えるもの

| 分類         | 内容                                                                 | リファレンス                                                                                                                                                                                                                                                                                                       |
| ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **会話**     | チャット（SSE ストリーミング）、会話管理、ファイル管理、成果物取得、検索                             | [ユーザー API（会話・ライブラリ・組織）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference.md)                                                                                                                                                                                     |
| **ライブラリ**  | ライブラリのファイル、Agent、スキル、プレイブック                                        | [ユーザー API（会話・ライブラリ・組織）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference.md)                                                                                                                                                                                     |
| **組織**     | ユーザー、マスターデータ                                                       | [ユーザー API（会話・ライブラリ・組織）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference.md)                                                                                                                                                                                     |
| **プロジェクト** | プロジェクト・工程・配置の設定、ワークフローの実行の開始と中断、トリガーの発火、実行の結果・記録 (証跡)・KPI、確認依頼、連携先 | [ユーザー API（プロジェクト）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference-projects.md)（アプリケーション） / [システム連携 API](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/admin-api-reference.md#projects)（プロジェクト一覧・ワークフローの実行の開始と取得と中断・トリガーの発火だけ） |
| **管理**     | 共有メモリ、ユーザー管理、ログ、マスターデータ管理                                          | [システム連携 API](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/admin-api-reference.md)                                                                                                                                                                                          |

## 始め方

Console でクライアントを作成したら、[API を呼び出す](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/quickstart/call-api.md) の手順で最初のリクエストを送ってみてください。

## ガイド

- [Console ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/console-guide.md) — Console でクライアントを作成
- [認証ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/auth-guide.md) — AC / CC フローの詳細
- [接続方式ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/connection-guide.md) — SSE / MCP / A2A の比較と選択
- [SSE ストリーミングガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/streaming-guide.md) — SSE のライフサイクルとイベント処理
- [プロジェクト API ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/project-api-guide.md) — うまくいかなかった実行を見つけ、原因を調べて直す流れ
- [AI クライアント接続ガイド（MCP）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/ai-client-guide.md) — Claude Code などの AI クライアントからつなぐ（プラグイン・人・システム連携）

## リファレンス

- [ユーザー API リファレンス（会話・ライブラリ・組織）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference.md) — 会話・ライブラリ・組織のエンドポイント
- [ユーザー API リファレンス（プロジェクト）](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference-projects.md) — プロジェクトのエンドポイント
- [システム連携 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/admin-api-reference.md) — システム連携から呼ぶ全エンドポイント
- [認証 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/auth-saas-ref.md) — トークン取得とスコープ
- [MCP API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/mcp-ref.md) / [A2A API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/a2a-ref.md)

マーケットプレイス版の API は [マーケットプレイス ＞ API](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api.md) を参照してください。
