Open API
让业务系统直接调用智能体
工单系统、CRM 和内部工具都能通过 API 调用 Evose 里发布的智能体和工作流。可以同步等结果,也可以先拿到运行 ID,跑完再回调通知。
接进 现有 系统,不用重写 流程
调用
团队 已经 搭好的 团队在 Evose 里发布的智能体、编排智能体和工作流,都能从 API 调用。默认调用最新发布的版本,在 Evose 里改了提示词,代码不用跟着改。
长任务
不用 一直等 异步发起后马上拿到运行 ID。可以按 ID 查询结果,也可以留一个回调地址,跑完推给你。
一个 Key 管一件事
每个 API Key 只能调用指定的应用,可以设有效期,随时停用。
从发布到 第一次调用
- 01
发布
一个 应用 在 Evose 里搭好智能体、编排智能体或工作流,发布后就能从 API 调用。
- 02
创建 API Key
选好归属范围和可以调用的应用,把 Key 放进你们的服务里。
- 03
发起调用
同步等结果,或者异步拿到运行 ID,运行结束时回调通知。
接口一览
接口都在 /open/v1 下,请求头里带上 Bearer API Key 鉴权。
应用
- GET
/apps列出这个 Key 能调用的应用 - GET
/apps/agent/{app_id}/config读取智能体或编排智能体的调用配置 - GET
/apps/workflow/{app_id}/config读取工作流的输入变量
智能体和编排智能体
- POST
/apps/agent/run发起对话,支持流式返回 - POST
/apps/agent/async-run异步发起,可传回调地址 - GET
/apps/agent/async-runs/{run_id}查询异步运行的状态和回答
工作流
- POST
/apps/workflow/run运行工作流,以事件流返回进度 - POST
/apps/workflow/sync-run同步运行,等最终输出后返回 - POST
/apps/workflow/async-run异步运行,可传回调地址 - GET
/apps/workflow/async-runs/{run_id}查询异步运行的结果
文件
- POST
/files/upload上传文件,供运行输入引用
可以 这样用
新工单
自动分诊 工单系统每来一张新工单,就调用分诊智能体,把建议写回工单。
提示词 “按紧急程度给这张工单分级,推荐负责的小组。只填建议字段,不要直接回复客户。”
在 CRM 里起草
跟进 邮件 销售点一下按钮,CRM 调用智能体,按最近的沟通记录起草邮件。
提示词 “根据这条商机最近三次的沟通记录,起草一封跟进邮件,用销售本人的口吻。不要承诺折扣,草稿留给销售确认。”
夜里跑
一遍 对账 定时任务调用工作流,第二天一早拿到异常清单。
提示词 “把今天的订单导出和库存表对一遍,列出库存撑不过 7 天的商品。只出清单,不要自动下采购单。”
给每个 Key 划定 范围
API Key 和成员在 Evose 里的权限分开管理。
- 只开放指定的应用创建 Key 时选好归属范围和能调用的应用,超出范围的调用会被拒绝。
- 有效期和停用可以设到期时间,随时停用或删除。列表里能看到每个 Key 最近一次使用的时间。
- 用量按 Key 统计每个 Key 产生的成本和配额用量,都能在观测里单独查看。