メインコンテンツへスキップ
GET /api/v1/cloud/agents/{agent_id} 指定された Agent の詳細情報を取得します。

​
リクエストヘッダー

ヘッダー必須説明
AuthorizationはいBearer <PAT>

​
パスパラメーター

パラメーター型必須説明
agent_idstringはいAgent の一意識別子。プレフィックスは agent_

​
クエリパラメーター

パラメーター型必須説明
versionintegerいいえ指定バージョンの Agent スナップショットを返します。省略時は現在の Agent を返します

​
リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/agents/agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent",
  "description": "",
  "model": "ultimate",
  "system": "You are a documentation testing assistant.",
  "tools": [],
  "mcp_servers": [],
  "skills": [
    {"type": "custom", "skill_id": "skill_019e5d133c057536872f745e0b6dbd5d"}
  ],
  "metadata": {},
  "multiagent": null,
  "version": 1,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:26:39.61669Z"
}

​
レスポンスフィールド

version を省略した場合、レスポンスは現在の Agent オブジェクトを返します。version を指定した場合、レスポンスは Agent バージョンスナップショットを返します。
フィールド型説明
typestring固定値 "agent"
idstringAgent の一意識別子
namestringAgent 名
descriptionstringAgent の説明
modelstring | objectモデル識別子。Agent model を参照
systemstringシステムプロンプト
toolsAgent tool の配列ツール設定リスト
mcp_serversMCP server の配列MCP サーバー設定
skillsSkill binding の配列Skill バインディング
metadataMetadata オブジェクトカスタムメタデータ
multiagentMultiagent | nullAgents 設定。未設定の場合は null
versioninteger現在のバージョン
archived_atstring|nullアーカイブ日時（ISO 8601）。未アーカイブの場合は null
created_atstring作成日時（ISO 8601）
updated_atstring最終更新日時（ISO 8601）

​
エラー

HTTPtype発生条件
400invalid_request_errorversion が正の整数ではない
401authentication_errorPAT が無効または期限切れ
403permission_errorこの Agent へのアクセス権限がない
404not_found_error指定された ID の Agent が存在しない
完全なエラーエンベロープについてはエラーを参照してください。

​
エラーレスポンス例

{
  "type": "error",
  "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
  "error": {
    "type": "not_found_error",
    "message": "Agent 'agent_nonexistent' was not found."
  }
}

​
関連

Agent の定義

再利用可能でバージョン管理された Agent 構成を作成する。