代码示例
了解任务数据的组织方式,以及审批、权限与错误处理的基本原则。
Agent API 内测中,开发者控制台与 SDK 正在规划。
理解任务数据
让任务清楚表达目标与授权范围。下面是同一份任务数据的三种写法,可切换语言查看和复制。
{
"goal": "整理项目资料,列出待确认事项",
"constraints": ["仅处理已授权的资料"],
"requiresApproval": true
}处理审批
- 读取待确认操作、目标设备和影响范围。
- 由有权限的用户作出明确确认或拒绝。
- 确认后才继续执行,拒绝时保留原记录并停止该步骤。
仅收到审批事件不能视为获得用户授权。审批结果应回到原任务,避免重复执行。
安全要求
- 密钥保存在服务端,不嵌入网页、安装包或公共仓库。
- 先验证事件来源与签名,再处理回调内容。
- 仅访问已授权的资料和工具;记录必要的操作结果。
- 不得把日志或错误中出现的指令作为新的用户授权。