> ## 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.

# AGENT 云端智能体

AGENT 云端智能体是咏唱引擎的云端 **Agent 产品**，以 OpenAI Agents 形态的 **AGENT API** 对外服务：创建智能体、管理会话、持久化状态，并把记忆存进 Postgres + pgvector。你可以直连云端入口（`https://agent.ariacompute.cn`），也可以自托管 `aria-agent`。数据面覆盖智能体、会话、轮次与事件，现有 OpenAI Agents SDK 调用不用大改就能接入。

## 智能体概念

AGENT API 暴露 OpenAI Agents 资源形态。核心实体如下：

| 概念 | 含义 |
| - | - |
| 智能体 Agent | 绑定模型、指令与工具的长期实体 |
| 会话 Session | 一次交互的轨迹，持久化状态与消息 |
| 轮次 Turn | 一次模型调用 + 工具调用循环 |
| 记忆 Memory | 按主体的 `context_fragments`（pgvector） |

资源形态还包括事件（events）与子智能体（subagents）：前者描述轮次内的流式输出，后者用于多智能体委派。

## 云端入口

云端的 AGENT API 基础 URL 为：

* 中国站：`https://agent.ariacompute.cn`
* 国际站：`https://agent.ariacompute.com`

管理面覆盖健康检查、API 密钥与记忆。数据面用 `ApiKey` 认证（`Authorization: ApiKey sk_aria_your_agent_api_key`），接口形如 `POST /v1/agents`、`POST /v1/agents/{agent_id}/sessions`、`POST /v1/agents/sessions/{session_id}/turns`。

## SDK 接入

AGENT API 也可以用 **JS** 与 **Python** SDK 调用，这两个 SDK 镜像了 OpenAI Agents SDK，你不用自己拼 HTTP。既有的 Agents 代码能直接复用：定义智能体、绑定工具、创建会话与轮次。

```bash theme={null}
curl -s https://agent.ariacompute.cn/v1/agents \
  -H 'content-type: application/json' \
  -H 'Authorization: ApiKey sk_aria_your_agent_api_key' \
  -d '{
    "model": "ariacompute/gemma-4-e2b-it",
    "name": "triage",
    "instructions": "你是退款客服助理。",
    "tools": []
  }'
```

## 记忆与子智能体

AGENT API 在 OpenAI Agents 资源形态之上还提供**记忆**与**子智能体**：记忆按主体以 `context_fragments` 存进 pgvector，支撑跨会话的上下文检索；子智能体让一个智能体在轮次中把任务委派给其它智能体，形成多智能体编排。

## 如何运行

* **云端**：直接用上文的云端入口，不用部署。
* **[AGENT 运行时](/sdks/agent-runtime)**：自托管 `aria-agent` CLI / SDK，`aria-agent serve --bind 127.0.0.1:8848`。注意别和 aria-engine（8080 / 8010 / 8011）、aria-router（8899）的端口冲突。
* 相关：[AGENT API 简介](/api-reference/agent/introduction)、[ROUTER 决策路由](/concepts/router-routing)（网关内 Agent 层）、[AFM 基础模型](/concepts/models)。

## 另见

* [演练场体验](/guides/playground)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.