创建智能体 - POST /v1/agents

curl -X POST https://agent.ariacompute.cn/v1/agents \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SupportBot",
    "model": "gpt-4o-mini",
    "instructions": "You are a helpful support assistant."
  }'

{
  "id": "agent_01a2b3c4d5e6f7890abc",
  "object": "agent",
  "name": "SupportBot",
  "model": "gpt-4o-mini",
  "instructions": "You are a helpful support assistant.",
  "reasoning": {},
  "multi_agent": { "enabled": false },
  "service_tier": "auto",
  "tools": [],
  "created_at": 1740000000000
}

curl -X POST https://agent.ariacompute.cn/v1/agents \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SupportBot",
    "model": "gpt-4o-mini",
    "instructions": "You are a helpful support assistant."
  }'

{
  "id": "agent_01a2b3c4d5e6f7890abc",
  "object": "agent",
  "name": "SupportBot",
  "model": "gpt-4o-mini",
  "instructions": "You are a helpful support assistant.",
  "reasoning": {},
  "multi_agent": { "enabled": false },
  "service_tier": "auto",
  "tools": [],
  "created_at": 1740000000000
}

创建智能体。所有请求字段都是可选的，省略的字段用服务端默认值（service_tier 默认为 auto，tools 默认为 []）。

接口

POST /v1/agents

认证

Authorization: Bearer <api_key> 或 Authorization: ApiKey <key>。若未设置 AGENT_CLOUD_API_KEY（开放模式），则可选。

请求体

string

显示名称。

string

模型标识符（例如 gpt-4o-mini）。

string

附加在智能体基础指令之后的自定义指令。

object

可选 { "effort": string, "summary": string }。

object

可选 { "enabled": boolean, "max_concurrent_subagents": number }。

string

默认为 auto。

object

可选 { "format": string, "verbosity": string }。

array

工具定义对象。

响应

string

智能体 id（agent_<hex>）。

string

恒为 agent。

string

显示名称（若已设置）。

string

模型标识符（若已设置）。

string

指令（若已设置）。

object

推理配置。

object

多智能体配置（enabled，可选 max_concurrent_subagents）。

string

服务层级。

object

文本 format/verbosity（若已设置）。

array

已注册工具。

integer

创建时间，Unix 纪元毫秒。

curl -X POST https://agent.ariacompute.cn/v1/agents \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SupportBot",
    "model": "gpt-4o-mini",
    "instructions": "You are a helpful support assistant."
  }'

{
  "id": "agent_01a2b3c4d5e6f7890abc",
  "object": "agent",
  "name": "SupportBot",
  "model": "gpt-4o-mini",
  "instructions": "You are a helpful support assistant.",
  "reasoning": {},
  "multi_agent": { "enabled": false },
  "service_tier": "auto",
  "tools": [],
  "created_at": 1740000000000
}

PIN API

ROUTER API

AGENT API

MEMO API

创建智能体 - POST /v1/agents

接口

认证

请求体

响应

​接口

​认证

​请求体

​响应

接口

认证

请求体

响应