外部系统调用AgentSpace中Agent必须通过Developer API发起REST请求，需先创建启用OAuth的External Client App并勾选全部四个scope，再用Client Credentials Flow获取1小时有效期的Access Token，最后向/v1/agents/{agent_id}/chat端点发送含message字段的JSON请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让外部系统调用AgentSpace中已部署的Agent执行任务，必须通过Developer API发起标准REST请求，不能直接在UI界面点击触发。
前置准备：创建External Client App（ECA）
第一步：进入平台管理后台 → 点击左侧「Settings」→ 选择「External Client Apps Manager」→ 点击「New External Client App」。
第二步：填写应用名称（如“CRM集成客户端”）和联系邮箱，勾选「Enable OAuth」。
第三步：在OAuth Scopes区域，【必须一次性添加全部四个范围：api、refresh_token/offline_access、chatbot_api、sfap_api】——漏掉任意一个都会导致后续调用返回403错误。
第四步：启用「Client Credentials Flow」和「Issue JWT-based access tokens for named users」；取消勾选「Require secret for Web Server Flow」等三项——这些选项只适用于浏览器重定向场景，API直连不需要。
获取访问令牌（Access Token）
方法一：用curl直接请求（推荐测试阶段）
执行命令：curl -X POST "https://api.agentspace.dev/v1/oauth/token" -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=YOUR_CLIENT_ID" -d "client_secret=YOUR_CLIENT_SECRET" -d "grant_type=client_credentials" -d "scope=api chatbot_api"。
方法二：用Postman配置OAuth2.0 Client Credentials流程，填入ECA页面显示的Client ID与Client Secret，自动获取token。
【注意：token有效期为1小时，过期后需重新获取，不可刷新】——Agent API不支持refresh token机制，每次调用前请确认token未失效。
调用Agent执行会话
第一步：确定目标Agent的ID。进入对应Workspace → 点击「Agents」列表 → 找到目标Agent → 点击右侧「⋯」→ 选择「View Details」→ 复制页面URL末尾的UUID字符串，即为agent_id。
第二步：构造POST请求到/v1/agents/{agent_id}/chat端点，Header中加入Authorization: Bearer {access_token}。
第三步：Body使用JSON格式，必须包含message字段，例如：{"message": "查一下编号HT-2026-0897的合同签署方和金额"}。其他字段如session_id可选填，不填则系统自动生成新会话。
这一步操作起来很简单，直接把JSON发过去就行。但要注意：如果Agent绑定了私有数据源（比如合同PDF库），而调用方没有被授予该数据源的Read权限，API会静默返回空结果，不会报错提示——务必提前检查Data Sources页里的Permissions配置。
