ChatGPT Business 工作区 Agent 怎么用 API 触发？状态查询与结果验收

已发布的 ChatGPT 工作区 Agent 可以通过官方 API 通道由外部系统触发，但接收请求不等于已经完成业务任务。 需要先准备对应通道和专用访问令牌，再分别核对请求是否接收、运行是否完成、结果是否符合要求。云岚API Key 不能替代这个官方通道的凭据。

本文解决“团队已有工作区 Agent，想让表单、CRM 或工单事件启动它”的问题，官方资料核对于 2026 年 11 月 5 日。具体功能仍受工作区开放范围、管理员设置和你的访问权限约束；先查看官方 Workspace Agents 帮助及账号内的实际入口。

先确认你要触发的是工作区 Agent

这些入口的凭据、返回内容和权限不相同。不能把 GPT 链接、工作区 Agent 通道 ID 和模型名称互换，也不能只替换 Base URL 就假定整个工作流已经迁移。

配置前，先用预览完成一次真实的任务验证

先在 Agent 的预览中检查它能否读取允许的资料、执行所需工具，并把结果放到指定位置。输入应包含外部事件需要提供的信息，不能依赖你此刻打开的聊天或文件。此步骤的目的，是把工作流问题和外部调用问题分开。官方接入示例的验证流程

建议用一条无敏感信息的测试工单：给出事件编号、问题摘要、期望输出位置，以及“仅生成处理建议，暂不执行实际业务操作”的边界。记录在哪里看到产物、产物里有没有事件编号。本文没有执行真实触发，下面提供的是实施与验收方案。

正式触发前要准备哪些东西？

1. 已发布的 API 通道。 在 Agent 中配置 API channel，并确认修改已发布；保存通道标识，不用草稿链接代替。
2. Workspace Agent access token。 管理员先启用工作区 Agent 和创建个人访问令牌的权限，再通过 Admin → Access tokens 创建包含 Workspace Agents scope 的令牌。它用于 api.chatgpt.com，不是 OpenAI Platform API Key。官方认证说明
3. Agent 与目标位置的权限。 能触发 Agent，不代表它能写入目标文件；检查连接使用的账号及审批要求。不要为了让流程看起来自动运行而一律取消写入确认。连接与审批说明

令牌放在服务器的密钥配置中，验收台账只记凭据名称或脱敏标识。外部网页表单先把事件交给自己的后端，不把访问令牌放进公开页面。

触发、查状态和取结果，是三个步骤

当前官方触发入口为 POST https://api.chatgpt.com/v1/workspace_agents/{id}/trigger，其中 {id} 是 API 通道的 agtch_... 标识。提交 input 文本；成功接收时返回 202 和 conversation_url，但不返回最终答案。启用 OpenAI-Beta: workspace_agent_runs=v1 后，可以取得 agent_trigger_run_id，再用 GET /v1/workspace_agents/{id}/runs/{run_id} 查询状态。最新接口参考

状态包括排队、运行中、等待外部动作、完成和失败；可查询运行状态，仍不等于可通过该 API 读取最终回答。 当前以新接口参考为准，较早示例中“没有 run ID”的描述不能直接沿用。

conversation_url 可能为空；有链接时也只交给有权限的人查看。自动化流程若需要结果，应在 Agent 工作流中设计并验证可读取的输出位置，再由业务系统核对，不能把状态查询接口当作答案读取接口。官方 API channel 说明

同一条工单重试，怎样避免重复执行？

给业务事件生成稳定的 source_event_id，并在触发输入和产物中保留它。对同一个事件、同一个通道的网络重试，复用同一个 Idempotency-Key；新事件使用新键。可选的 conversation_key 用于延续对话，不能代替防重复提交的幂等键。幂等与会话字段说明

以下是假设的工单流程设计，不是实际运行记录：

• 工单事件 ticket-104-created 首次提交，记录所用通道和幂等键。
• 网络超时、无法确认接收结果时，复用原键重试，不重新生成随机键。
• 已收到 202 后，进入状态与产物检查，不把“暂时没看到结果”当作再次创建任务的理由。
• 业务人员补充材料后产生新事件 ticket-104-updated-2，分配新幂等键；需要延续原对话时，再复用相应 conversation_key。

下载工作区 Agent 触发与结果验收表。表格记录事件、接收、状态与产物证据；链接可能涉及内部资料，应按团队权限保存，不填访问令牌。

收到 202，却没找到结果，先查什么？

先看是否仍在排队或运行；若等待外部动作，检查需要完成的工具连接或审批。已经失败则保存错误信息交给负责该工作流的人。查询显示完成却没有预期产物时，回到任务定义检查目标位置、写入权限及实际输出，而不是继续重复触发。

还应检查两个业务问题：本次输入是否明确说明了目标位置；生成内容有没有带回源事件编号。前者缺失可能让结果出现在不易找到的位置，后者缺失会让多个并行工单难以对账。建议设置符合业务时效的等待上限，超时转人工复核，保留原事件和运行记录。

如果要的是程序直接拿到模型输出呢？

若你需要在自建程序里取得模型响应，自行安排上下文、重试和写回，可以使用模型 API 架构。这样需要自己实现工作流；官方工作区里的连接、审批和共享设置不会随 Key 一起迁入新服务。

云岚API可作为独立模型调用的选项。先核对当前模型与协议，确定符合任务后注册云岚API，按新手接入教程验证一个短文本任务。已有账号直接进入控制台。如果已有的官方工作区 Agent 路径已经满足任务，就继续使用已验证的通道，不必为触发它另买中转 Key。

常见问题

能用云岚API Key 调这个 Workspace Agents 地址吗？

不能。官方工作区 Agent 通道使用专用 Workspace Agent access token；云岚API Key 用于本站对应的模型服务，两者不互换。

状态 completed，是否就可以把工单标为处理完毕？

还需要业务验收。核对事件编号、产物位置、内容和必要审批，再决定是否关闭工单。completed 表示运行成功完成，但业务产物仍须按团队的交付标准检查。