GET /v1/agents/{agent_id}
指定された Agent の詳細情報を取得します。
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|
| Authorization | はい | Bearer <PAT> |
| X-CAS-Include-Extended | いいえ | true に設定すると拡張フィールド（skills、metadata）がレスポンスに含まれます |
パスパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|
agent_id | string | はい | Agent の一意識別子、agent_ プレフィックス + UUID 形式 |
リクエスト例
curl -X GET "https://api.qoder.com/api/v1/cloud/agents/agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-H "Authorization: Bearer $QODER_PAT"
リクエスト例（拡張フィールド付き）
curl -X GET "https://api.qoder.com/api/v1/cloud/agents/agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-H "Authorization: Bearer $QODER_PAT" \
-H "X-CAS-Include-Extended: true"
レスポンス例
HTTP 200 OK
{
"type": "agent",
"id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"name": "doc-test-agent",
"description": "",
"model": "ultimate",
"system": "あなたはドキュメントテストアシスタントです",
"instructions": "あなたはドキュメントテストアシスタントです",
"tools": [],
"mcp_servers": [],
"skills": [
{"type": "custom", "skill_id": "skill_019e5d133c057536872f745e0b6dbd5d"}
],
"metadata": {},
"default_environment": "",
"version": 1,
"archived": false,
"archived_at": null,
"created_at": "2026-05-18T15:26:39.61669Z",
"updated_at": "2026-05-18T15:26:39.61669Z"
}
X-CAS-Include-Extended: true ヘッダーを付与しない場合、レスポンスに skills と metadata フィールドは含まれません。
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|
type | string | 固定値 "agent" |
id | string | Agent の一意識別子 |
name | string | Agent 名 |
description | string | Agent の説明 |
model | string | モデル識別子 |
instructions | string | システムプロンプト |
system | string | instructions のエイリアス（非推奨、instructions を使用してください） |
tools | array | ツール設定リスト |
mcp_servers | array | MCP サーバー設定 |
skills | array | Skill バインディングリスト（拡張フィールド、X-CAS-Include-Extended: true が必要） |
metadata | object | カスタムメタデータ（拡張フィールド、X-CAS-Include-Extended: true が必要） |
default_environment | string | デフォルトの実行環境 |
version | integer | 現在のバージョン番号 |
archived | boolean | アーカイブ済みかどうか |
archived_at | string|null | アーカイブ時刻（ISO 8601）、未アーカイブの場合は null |
created_at | string | 作成時刻（ISO 8601） |
updated_at | string | 最終更新時刻（ISO 8601） |
エラーコード
| HTTP | type | トリガー条件 |
|---|
| 401 | authentication_error | PAT が無効または期限切れ |
| 403 | permission_error | この Agent にアクセスする権限がない |
| 404 | not_found_error | 指定 ID の Agent が存在しない |
エラーレスポンス例
{
"type": "error",
"error": {
"type": "not_found_error",
"message": "Agent 'agent_nonexistent' was not found."
}
}
