在百炼右侧预览窗能聊天，只证明当前配置可供你测试。要让自有服务调用通义千问智能体，需要先发布 Agent 2.0 应用，再取得应用 ID 和 API Key，在服务端做一次实际请求。本篇从已经创建并测试过的应用继续，不重复创建教程。
发布前做一个小验收
先固定两道问题：一个属于应用任务，一个故意超出范围。演示为“课程答疑助手”：提问“作业在哪里交？”以及“帮我预测这次考试分数”。检查预览结果是否符合你配置的提示词，且没有把猜测当成制度事实。若关联知识检索服务，还应检查来源文档是否正确、服务修改后是否已发布。
发布 Agent 2.0 版本
- 进入百炼应用配置页，点右上角“发布”。
- 在弹窗中核对自上次发布以来的配置变更，确认模型、提示词、工具和知识检索服务没有误选，再“确认发布”。
- 到应用卡片或发布渠道查看应用 ID；把 ID 与使用环境对应保存。不要把另一个应用的 ID 粘过来。
官方 Agent 2.0 指南明确应用发布是后续调用和集成的前提，并提供版本管理入口。修改了配置后须重新发布版本，不能以本地草稿状态推断外部 API 已更新。
先在线调试，再从服务端调用
在应用卡片进入“发布 > API 调试”，填写同一测试问题并运行。新版智能体 API 参考说明该接口适用于华北2（北京）地域；若你的应用位于别的地域，先核对当地支持情况和端点，不要直接照搬北京地址。API Key 放服务端环境变量 DASHSCOPE_API_KEY，应用 ID 放服务端配置。
下面是演示请求结构，占位的 APP_ID 需要换成你自己发布应用的 ID，DASHSCOPE_API_KEY 由服务器环境注入，不要把真实值放进网页脚本：
POST https://dashscope.aliyuncs.com/api/v1/apps/APP_ID/completion
Authorization: Bearer <从服务端环境变量读取的 API Key>
Content-Type: application/json
{"input":{"prompt":"作业在哪里交？"}}验证时记录 HTTP 状态与请求 ID，检查输出文本确实对应课程答疑，而不是另一个应用的通用回复；再发范围外问题，确认没有越界。若是 401/403，先核对 Key、地域、业务空间和应用权限；若是应用 ID 不存在，返回应用管理页重新复制 ID。单次请求成功仍需用固定测试集回归发布版本。
Agent 2.0 与旧版 Agent 1.0 的分享渠道不同；不要把旧版“微信/钉钉一键分享”教程套到新版。本文依据 2026 年 10 月 1 日官方文档整理，未持有你的百炼应用 ID、也未在你的账号实际发起调用。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/31029.html
