> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 按 ID 检索咏唱引擎云智能体

> 按标识符检索咏唱引擎云智能体，以 OpenAI beta 形态返回其模型、指令、工具与元数据。

按标识符检索一个智能体。响应兼容 OpenAI beta Agents，因此为 OpenAI Agents 资源编写的客户端 SDK 无需改动即可对接咏唱引擎云。

## 接口

```http theme={null}
GET /v1/agents/{agent_id}
```

## 认证

`Authorization: Bearer <api_key>` 或 `Authorization: ApiKey <api_key>`。

## 路径参数

<ParamField path="agent_id" type="string" required>
  智能体标识符。
</ParamField>

## 响应

<ResponseField name="id" type="string">
  智能体标识符。
</ResponseField>

<ResponseField name="object" type="string">
  恒为 `agent`。
</ResponseField>

<ResponseField name="name" type="string">
  显示名称。
</ResponseField>

<ResponseField name="model" type="string">
  底层模型标识符。
</ResponseField>

<ResponseField name="instructions" type="string">
  智能体的系统指令。
</ResponseField>

<ResponseField name="tools" type="array">
  附加到智能体的工具定义。
</ResponseField>

<ResponseField name="metadata" type="object">
  自由格式元数据。
</ResponseField>

<ResponseField name="created_at" type="integer">
  Unix 秒。
</ResponseField>

## 示例

```bash theme={null}
curl https://agent.example.com/v1/agents/ag_0198a... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

```json theme={null}
{
  "id": "ag_0198a...",
  "object": "agent",
  "name": "support-triage",
  "model": "gpt-4o-mini",
  "instructions": "You are a triage agent...",
  "tools": [],
  "metadata": {},
  "created_at": 1735000000
}
```