方舟 Managed Agents 的代码调用不是一次 chat 请求。完整最小链路包括 Agent、Environment、Session 和事件流；尤其要先建立 SSE，再发送 user.message，否则可能漏掉早期事件。
开始前准备
- 安装最新 arkruntime 与 httpx，并配置 ARK_API_KEY。
- 确认 Managed Agents 和所选模型已开通。
- 只在测试项目创建临时资源，并准备记录 agent_id、environment_id、session_id。
按顺序完成操作
- 用 client.agents.create 创建 Agent，长期规则写入 system。
- 用 client.environments.create 创建云环境，再用 client.sessions.create 绑定 Agent 与 Environment。
- 打开 /sessions/{session_id}/events/stream，收到 ready 后再发送 user.message。
- 持续读取到 session.status_idle 或 session.status_terminated，并在测试完成后删除临时资源。
from arkruntime import Ark
import os
client = Ark(api_key=os.environ["ARK_API_KEY"],
base_url="https://ark.cn-beijing.volces.com/api/v3")
agent = client.agents.create(
name="demo-agent", model={"id": "your_model_id"},
system="只完成用户明确给出的只读任务。",
)
env = client.environments.create(name="demo-env", config={"type": "cloud"})
session = client.sessions.create(agent=agent.id, environment_id=env.id)
print(agent.id, env.id, session.id)怎样判断已经成功
- 日志里必须出现三个非空 ID，事件流先出现 ready，任务结束时出现 idle 或 terminated。
- 若生成了文件，核对文件路径和内容；随后确认测试资源已经按 ID 删除，避免持续占用。
常见失败与处理边界
- 创建 Session 后没有执行：创建只得到 idle 状态，仍需发送 user.message。
- 收不到开头消息：检查是否在发送事件之前就完成 SSE 订阅。
- 删除资源失败：按 Session、Environment、Agent 的依赖顺序清理，并保留错误响应。
适用限制
示例未使用真实方舟账号执行，模型 ID、云环境字段和 SDK 方法应以当前官方快速入门页面为准。
官方资料
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32310.html
