AI Coding Assistant Lingma:エージェントの作成

ヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer 認可ヘッダー。形式は です。 は Personal Access Token (PAT) のプレースホルダーです。
Content-Type	はい	application/json
Idempotency-Key	いいえ	重複作成を防止するためのべき等性キー。

リクエストボディ

フィールド	タイプ	必須	説明
name	文字列	はい	エージェント名、1～256文字。
model	文字列/オブジェクト	はい	モデルの識別子。文字列 (例："ultimate") またはオブジェクト。
instructions	文字列	いいえ	システムプロンプト。
description	文字列	いいえ	エージェントの説明。
tools	配列	いいえ	ツール設定のリスト。下記の「tools 要素の構造」をご参照ください。完全なリファレンスについては、「[Agent Tools](/cloud-agents/tools)」をご参照ください。
mcp_servers	配列	いいえ	MCP サーバー設定のリスト。フォーマットは [{"name":"","type":"url","url":""}] です。認証は「[Vaults](/cloud-agents/vaults)」を使用して設定します。
skills	配列	いいえ	スキルバインディング。フォーマットは [{"type":"custom","skill_id":""}] で、最大 20 エントリ。
metadata	オブジェクト	いいえ	カスタムメタデータのキーと値のペア。

tools 要素の構造

{
  "type": "agent_toolset_20260401",
  "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
}

フィールド	タイプ	必須	説明
type	文字列	はい	ツールセットのタイプ識別子。使用可能な値と最新バージョンについては、「[Agent Tools](/cloud-agents/tools)」をご参照ください。
enabled_tools	配列	いいえ	有効にするアトミックツールの許可リスト。このフィールドを省略するか、空の配列 [] を渡すと、すべての組み込みツールが有効になります。 空でない配列は厳密な許可リストとして機能し、リストに含まれていないツールはモデルから参照できなくなります。「[Agent Tools](/cloud-agents/tools)」をご参照ください。

リクエストの例

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/agents" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "doc-test-agent",
    "model": "ultimate",
    "instructions": "You are a documentation testing assistant.",
    "tools": [
      {
        "type": "agent_toolset_20260401",
        "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
      }
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "weather-service",
        "url": "https://mcp.example.com/sse"
      }
    ]
  }'

レスポンスの例

HTTP 201 Created

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent",
  "description": "",
  "model": "ultimate",
  "system": "You are a documentation testing assistant.",
  "instructions": "You are a documentation testing assistant.",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]
    }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "name": "weather-service",
      "url": "https://mcp.example.com/sse"
    }
  ],
  "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"
}

レスポンスフィールド

フィールド	タイプ	説明
type	文字列	常に "agent"。
id	文字列	プレフィックス agent_ が付く、エージェントの一意な識別子。
name	文字列	エージェント名。
description	文字列	エージェントの説明。
model	文字列	モデルの識別子。
instructions	文字列	システムプロンプト。
system	文字列	instructions のエイリアス (非推奨、代わりに instructions を使用してください)。
tools	配列	ツール設定のリスト。
mcp_servers	配列	MCP サーバー設定。
default_environment	文字列	デフォルトのランタイム環境。
version	整数	現在のバージョン。1 から始まります。
archived	ブール値	アーカイブ済みかどうか (デフォルトは false)。
archived_at	文字列/null	アーカイブ時刻 (ISO 8601)、アーカイブされていない場合は null。
created_at	文字列	作成時刻 (ISO 8601)。
updated_at	文字列	最終更新時刻 (ISO 8601)。

エラー

HTTP	タイプ	トリガー
400	invalid_request_error	必須フィールド name がありません。
400	invalid_request_error	name が 256文字を超えています。
400	invalid_request_error	必須フィールド model がありません。
400	invalid_request_error	mcp_servers または skills の設定が無効です。
400	invalid_request_error	skills が最大エントリ数の 20 を超えています。
401	authentication_error	PAT が無効か、または期限切れです。
403	permission_error	この操作を実行する権限がありません。

完全なエラーエンベロープについては、「エラー」をご参照ください。

エラーレスポンスの例

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "name must be between 1 and 256 characters"
  }
}