Qoder Cloud Agents 使用说明官方链接Qoder Cloud 首页: https://qoder.com/cloud/Qoder Cloud Quickstart: https://qoder.com/cloud/quickstartAPI Base:https://api.qoder.com/api/v1/cloud一、先看整体流程Qoder Cloud 的最短路径可以记成一句话PAT - Environment - Agent - Session - Message - Stream对应关系如下对象作用PAT登录并调用 Cloud API 的凭证EnvironmentAgent 运行的云环境Agent智能体本体定义模型、工具和系统提示词SessionAgent 的一次运行实例Event消息输入、工具调用、回复输出都会以事件形式流动图1展示的是 Cloud Agents 首页。左侧是功能区右侧是快速开始流程按照页面提示依次完成 4 步就能跑通第一个 Agent。二、前置条件1. 账号先准备一个 Qoder 账号。登录后进入控制台再创建个人访问令牌也就是QODER_PAT。2. 终端建议使用以下环境之一macOSLinuxWSLWindows 用户如果用 PowerShell建议注意两点环境变量写法是$env:QODER_PATyour-token真实的 curl 要写成curl.exe如果你打算格式化 JSONjq也很方便wingetinstalljqlang.jq三、第一步: 获取 PAT在控制台里进入个人访问令牌页面创建后把 token 立刻保存好。这个值通常只显示一次。示例:exportQODER_PATyour-personal-access-tokenPowerShell 示例:$env:QODER_PATyour-personal-access-token四、第二步: 选择或创建 EnvironmentEnvironment 是 Agent 的运行容器。你可以先查询现有环境curl-shttps://api.qoder.com/api/v1/cloud/environments\-HAuthorization: Bearer$QODER_PAT如果返回空数组说明账号下还没有环境可以手动创建一个默认环境curl-s-XPOST https://api.qoder.com/api/v1/cloud/environments\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{ name: default, config: { type: cloud, networking: { type: unrestricted } } }界面上对应的是环境配置页。图2和图3对应的是 Agent 配置区。这里要填名称、描述并选择模型。实际可见的模型项会受到账号权限和当前可用模型的影响。五、第三步: 创建 AgentAgent 负责定义“这个智能体是谁、会用什么模型、能用哪些工具”。一个最小化的示例curl-s-XPOST https://api.qoder.com/api/v1/cloud/agents\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{ name: my-first-agent, model: ultimate, system: 你是一个高效的编程助手擅长代码编写和问题排查。, tools: [ { type: agent_toolset_20260401, enabled_tools: [Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch] } ] }界面上这一步通常会看到Agent 名称模型下拉框系统提示词工具开关图4展示的是 Environment 配置页。这里的环境名可以按自己的习惯命名只要后面创建 Session 时能选对就行。六、第四步: 创建 SessionSession 是 Agent 的一次运行实例。创建 Session 时要同时带上agent和environment_id。curl-s-XPOST https://api.qoder.com/api/v1/cloud/sessions\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{\agent\:\AGENT_ID\,\environment_id\:\ENV_ID\}Session 创建后一般处于idle状态真正开始执行要等你发第一条消息。图5对应的是“创建 Session - 发送消息 - 接收事件”的核心链路。右侧是在线测试输入框底部卡片区则是常见能力入口。界面里也可以直接从会话页创建。可能出现的问题七、第五步: 发送消息并收事件流先向 Session 发送一条用户消息curl-s-XPOSThttps://api.qoder.com/api/v1/cloud/sessions/$SESSION_ID/events\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{ events: [ { type: user.message, content: [ { type: text, text: 你好告诉我你能做什么。 } ] } ] }然后用 SSE 流实时接收结果curl-s-Nhttps://api.qoder.com/api/v1/cloud/sessions/$SESSION_ID/events/stream\-HAuthorization: Bearer$QODER_PAT常见事件包括user.messagesession.status_runningagent.thinkingagent.messageagent.tool_useagent.tool_resultsession.status_idleheartbeat八、把页面当成操作地图看如果你更习惯先看页面再看 API可以按这个顺序理解首页先选起点进入 Agent 配置页填名称和模型进入 Environment 配置页选环境进入 Session 页创建会话并发第一条消息图7是一个常见问题提示。如果在线测试区出现You have no available credit通常说明当前账号额度不足需要检查套餐、配额或资源包。九、常见问题1. 401 Unauthorized先检查QODER_PAT是否设置正确是否过期。2. 400 Bad Request通常是 JSON 格式有问题或者model、tools、environment_id传错了。3. Session 一直是 idle这是正常的。Session 只有在收到user.message后才会进入执行流程。4. 事件流中断可以用Last-Event-ID做断点续传如果想查历史事件再看事件列表接口。5. 环境列表为空新账号可能还没有预置环境手动创建一个默认环境就行。十、最小可执行顺序你可以把整个流程记成下面这 5 条命令链1.exportQODER_PAT...2.curlGET /environments3.curlPOST /agents4.curlPOST /sessions5.curlPOST /sessions/{id}/events curl-N/events/stream十一、补充说明Environment管运行空间Agent管能力定义Session管一次执行过程Event管上下文流转如果你只是想先跑通第一个 Demo优先记住这条链路就够了先拿 PAT再建 Environment再建 Agent再建 Session最后发消息看流。
Qoder Cloud Agents 使用说明官方链接Qoder Cloud 首页: https://qoder.com/cloud/Qoder Cloud Quickstart: https://qoder.com/cloud/quickstartAPI Base:https://api.qoder.com/api/v1/cloud一、先看整体流程Qoder Cloud 的最短路径可以记成一句话PAT - Environment - Agent - Session - Message - Stream对应关系如下对象作用PAT登录并调用 Cloud API 的凭证EnvironmentAgent 运行的云环境Agent智能体本体定义模型、工具和系统提示词SessionAgent 的一次运行实例Event消息输入、工具调用、回复输出都会以事件形式流动图1展示的是 Cloud Agents 首页。左侧是功能区右侧是快速开始流程按照页面提示依次完成 4 步就能跑通第一个 Agent。二、前置条件1. 账号先准备一个 Qoder 账号。登录后进入控制台再创建个人访问令牌也就是QODER_PAT。2. 终端建议使用以下环境之一macOSLinuxWSLWindows 用户如果用 PowerShell建议注意两点环境变量写法是$env:QODER_PATyour-token真实的 curl 要写成curl.exe如果你打算格式化 JSONjq也很方便wingetinstalljqlang.jq三、第一步: 获取 PAT在控制台里进入个人访问令牌页面创建后把 token 立刻保存好。这个值通常只显示一次。示例:exportQODER_PATyour-personal-access-tokenPowerShell 示例:$env:QODER_PATyour-personal-access-token四、第二步: 选择或创建 EnvironmentEnvironment 是 Agent 的运行容器。你可以先查询现有环境curl-shttps://api.qoder.com/api/v1/cloud/environments\-HAuthorization: Bearer$QODER_PAT如果返回空数组说明账号下还没有环境可以手动创建一个默认环境curl-s-XPOST https://api.qoder.com/api/v1/cloud/environments\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{ name: default, config: { type: cloud, networking: { type: unrestricted } } }界面上对应的是环境配置页。图2和图3对应的是 Agent 配置区。这里要填名称、描述并选择模型。实际可见的模型项会受到账号权限和当前可用模型的影响。五、第三步: 创建 AgentAgent 负责定义“这个智能体是谁、会用什么模型、能用哪些工具”。一个最小化的示例curl-s-XPOST https://api.qoder.com/api/v1/cloud/agents\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{ name: my-first-agent, model: ultimate, system: 你是一个高效的编程助手擅长代码编写和问题排查。, tools: [ { type: agent_toolset_20260401, enabled_tools: [Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch] } ] }界面上这一步通常会看到Agent 名称模型下拉框系统提示词工具开关图4展示的是 Environment 配置页。这里的环境名可以按自己的习惯命名只要后面创建 Session 时能选对就行。六、第四步: 创建 SessionSession 是 Agent 的一次运行实例。创建 Session 时要同时带上agent和environment_id。curl-s-XPOST https://api.qoder.com/api/v1/cloud/sessions\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{\agent\:\AGENT_ID\,\environment_id\:\ENV_ID\}Session 创建后一般处于idle状态真正开始执行要等你发第一条消息。图5对应的是“创建 Session - 发送消息 - 接收事件”的核心链路。右侧是在线测试输入框底部卡片区则是常见能力入口。界面里也可以直接从会话页创建。可能出现的问题七、第五步: 发送消息并收事件流先向 Session 发送一条用户消息curl-s-XPOSThttps://api.qoder.com/api/v1/cloud/sessions/$SESSION_ID/events\-HAuthorization: Bearer$QODER_PAT\-HContent-Type: application/json\-d{ events: [ { type: user.message, content: [ { type: text, text: 你好告诉我你能做什么。 } ] } ] }然后用 SSE 流实时接收结果curl-s-Nhttps://api.qoder.com/api/v1/cloud/sessions/$SESSION_ID/events/stream\-HAuthorization: Bearer$QODER_PAT常见事件包括user.messagesession.status_runningagent.thinkingagent.messageagent.tool_useagent.tool_resultsession.status_idleheartbeat八、把页面当成操作地图看如果你更习惯先看页面再看 API可以按这个顺序理解首页先选起点进入 Agent 配置页填名称和模型进入 Environment 配置页选环境进入 Session 页创建会话并发第一条消息图7是一个常见问题提示。如果在线测试区出现You have no available credit通常说明当前账号额度不足需要检查套餐、配额或资源包。九、常见问题1. 401 Unauthorized先检查QODER_PAT是否设置正确是否过期。2. 400 Bad Request通常是 JSON 格式有问题或者model、tools、environment_id传错了。3. Session 一直是 idle这是正常的。Session 只有在收到user.message后才会进入执行流程。4. 事件流中断可以用Last-Event-ID做断点续传如果想查历史事件再看事件列表接口。5. 环境列表为空新账号可能还没有预置环境手动创建一个默认环境就行。十、最小可执行顺序你可以把整个流程记成下面这 5 条命令链1.exportQODER_PAT...2.curlGET /environments3.curlPOST /agents4.curlPOST /sessions5.curlPOST /sessions/{id}/events curl-N/events/stream十一、补充说明Environment管运行空间Agent管能力定义Session管一次执行过程Event管上下文流转如果你只是想先跑通第一个 Demo优先记住这条链路就够了先拿 PAT再建 Environment再建 Agent再建 Session最后发消息看流。
