得られるもの
- 仕様から生成される API 呼び出しエージェント: タグごとにまとめられた HTTP 呼び出しの設定、パイプライン、デプロイ
- エンドポイントのフィルタリング、ベース URL の上書き、認証ヘッダーの引き継ぎ
- 生成されたツールと並べて MCP サーバーのツールを追加するオプション
- 設定であるため、レビュー、差分確認、バージョン管理ができるツール
EDDIでの仕組み
create_api_agentMCP ツール、またはPOST /administration/agents/setup-apiで、EDDIに OpenAPI 仕様を渡します。- エージェントに持たせるオペレーションを許可リストに登録します。宣言されていないエンドポイントは呼び出せません。
- EDDIが HTTP 呼び出しの設定を生成し、完全なパイプラインを構築して、エージェントをデプロイします。
- 認証情報は
${vault:...}参照として保管します。 - 書き込みは
http.post:*,http.put:*,http.patch:*,http.delete:*でゲートし、読み取りはhttp.get:*で除外します。
設定
EDDIのドキュメントに基づいています。your-agent-id のようなプレースホルダーは、ご自身の値に置き換えてください。
{
"targetServerUrl": "https://api.example.com/v1",
"httpCalls": [
{
"name": "list-open-orders",
"saveResponse": true,
"responseObjectName": "order",
"request": {
"method": "GET",
"path": "/orders",
"queryParams": { "status": "open" },
"headers": { "Authorization": "Bearer ${vault:orders-api-token}" }
}
}
]
}{
"hitlConfig": {
"toolApprovals": {
"requireApproval": [
"http.post:*",
"http.put:*",
"http.patch:*",
"http.delete:*"
],
"exempt": [
"http.get:*"
],
"approvalTimeout": "PT30M",
"timeoutPolicy": "AUTO_REJECT"
}
}
}ガバナンス
- 承認パターンはツールの呼び出し先(
http.post:*)を指定できるため、operationId が変わっても正しく機能し続けます。 - 外部への呼び出しは、プラットフォームによって SSRF とパストラバーサルから保護されます。
- REST では、
setup-apiがhitlConfigを受け付けるため、最初のバージョンから書き込みツールがゲートされた状態でエージェントをプロビジョニングできます。MCP ツールでは設定できません。 - 判断は監査台帳に記録されます。
知っておくべきこと
- 生成された書き込みツールは、リクエストボディ全体を1つの
requestBodyパラメーターとして受け取ります。
構築と運用を任せたいですか?
EDDI Solutionsは、コネクタの構築と保守、マネージドまたは共同運用でのEDDIの運用、お客様のクラウドやオンプレミスでの支援を提供します。
EDDI Solutionsに相談する ↗関連するインテグレーション
このページの設定と動作は、2026-10-14に確認したEDDIのドキュメントに基づいています。フィールド名やデフォルト値はリリースによって変わることがあるため、お使いのバージョンのドキュメントで確認してください。