> ## 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 从子智能体中检索单个轮次，包括其状态与嵌套的条目数组。

使用此接口获取子智能体内的某个特定轮次。响应包含轮次元数据，以及构成该轮次的条目数组。

## 接口

```http theme={null}
GET /v1/agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}
```

## 认证

传递 `Authorization: Bearer <api-key>` 或 `Authorization: ApiKey <key>` 之一。

## 路径参数

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

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

<ParamField path="turn_id" type="string" required>
  轮次标识符。
</ParamField>

## 响应

<ResponseField name="id" type="string">
  唯一的轮次标识符。
</ResponseField>

<ResponseField name="session_id" type="string">
  父会话标识符。
</ResponseField>

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

<ResponseField name="status" type="string">
  轮次状态，例如 `completed`。
</ResponseField>

<ResponseField name="items" type="array">
  轮次内的条目对象数组。
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/subagents/sub_01D/turns/turn_02C \
    -H "Authorization: Bearer <api-key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "turn_02C",
    "session_id": "sess_01J5X8",
    "subagent_id": "sub_01D",
    "status": "completed",
    "items": [
      {
        "id": "msg_02A",
        "role": "user",
        "content": "Summarize this document"
      },
      {
        "id": "msg_02B",
        "role": "assistant",
        "content": "The document discusses..."
      }
    ]
  }
  ```
</ResponseExample>