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

​
智能体概念

AGENT API 暴露 OpenAI Agents 资源形态。核心实体如下： 资源形态还包括事件（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 代码能直接复用：定义智能体、绑定工具、创建会话与轮次。

​
记忆与子智能体

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

​
如何运行

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

​
另见