需将腾讯混元智能体接入业务系统，通过API调用实现客服工单、知识库等场景；获取Endpoint URL和7天有效期Access Token，后端代理调用更安全；解析answer文本、执行action动作、渲染结果到页面。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把开发好的腾讯混元智能体真正用进公司业务系统里，比如客服工单系统、内部知识库网页、ERP审批流程或微信公众号后台，而不是只停留在元器平台的测试对话框中。
获取智能体调用地址和认证凭证
登录腾讯元器控制台 → 进入已发布的智能体详情页 → 点击右上角「接入设置」→ 开启「API调用」开关。
复制页面中显示的 【Endpoint URL】（形如 https://api.yuanqi.tencent.com/v1/agents/abc123/chat），这是你业务系统唯一能发请求的地址；同时复制下方生成的 【Access Token】，它有效期7天，过期后必须重新生成——别用控制台首页的全局API密钥，那不适用于智能体API。
注意：Access Token 不可重放，每次调用必须带在 Authorization 请求头里，格式为 Bearer {token}。
在业务系统中发起标准HTTP请求
方法一：前端直连（仅限可信内网环境）
在你系统的JS代码中，使用 fetch 发起 POST 请求：
fetch('https://api.yuanqi.tencent.com/v1/agents/abc123/chat', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' // 替换为你复制的token
},
body: JSON.stringify({
message: '客户订单号 TP20260928001 为什么还没发货？',
session_id: 'sess_20260928_user7721'
})
});
方法二：后端代理（生产环境强制推荐）
在你业务系统的后端（如 Spring Boot 的 /api/v1/ai/customer-support 接口）中，用服务端语言（Java/Python/Node.js）构造请求，把 Access Token 存在配置文件或密钥管理服务中，绝不暴露给浏览器。请求体结构与前端一致，但由后端统一加签、限流、记录日志。
将响应结果嵌入业务流程
第一步：解析返回JSON中的 answer 字段，提取纯文本回复内容。
第二步：若智能体返回了 action 字段（例如 {"action": "create_ticket", "data": {"type": "物流异常", "order_id": "TP20260928001"}}），你的业务系统需提前约定好动作协议，自动触发对应子系统操作——比如调用工单系统REST API创建新工单，或向WMS系统发送查货指令。
第三步：把 answer 内容直接插入当前页面的聊天窗口 DOM 节点，或作为语音合成输入推送给TTS服务；若含结构化数据（如价格对比表格），用前端模板引擎渲染成 HTML 表格插入页面指定容器。
