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 でスキルを自動取得します
比較の詳細と実装例は接続方式ガイドにあります。
扱えるもの
| 分類 | 内容 | リファレンス |
|---|---|---|
| 会話 | チャット（SSE ストリーミング）、会話管理、ファイル管理、成果物取得、検索 | ユーザー API（会話・ライブラリ・組織） |
| ライブラリ | ライブラリのファイル、Agent、スキル、プレイブック | ユーザー API（会話・ライブラリ・組織） |
| 組織 | ユーザー、マスターデータ | ユーザー API（会話・ライブラリ・組織） |
| プロジェクト | プロジェクト・工程・配置の設定、ワークフローの実行の開始、トリガーの発火、実行の結果・記録 (証跡)・KPI、確認依頼、連携先 | ユーザー API（プロジェクト）（アプリケーション） / システム連携 API（プロジェクト一覧・ワークフローの実行の開始と取得・トリガーの発火だけ） |
| 管理 | 共有メモリ、ユーザー管理、ログ、マスターデータ管理 | システム連携 API |
始め方
Console でクライアントを作成したら、API を呼び出す の手順で最初のリクエストを送ってみてください。
ガイド
- Console ガイド — Console でクライアントを作成
- 認証ガイド — AC / CC フローの詳細
- 接続方式ガイド — SSE / MCP / A2A の比較と選択
- SSE ストリーミングガイド — SSE のライフサイクルとイベント処理
- プロジェクト API ガイド — うまくいかなかった実行を見つけ、原因を調べて直す流れ
リファレンス
- ユーザー API リファレンス（会話・ライブラリ・組織） — 会話・ライブラリ・組織のエンドポイント
- ユーザー API リファレンス（プロジェクト） — プロジェクトのエンドポイント
- システム連携 API リファレンス — システム連携から呼ぶ全エンドポイント
- 認証 API リファレンス — トークン取得とスコープ
- MCP API リファレンス / A2A API リファレンス
マーケットプレイス版の API は マーケットプレイス ＞ API を参照してください。