Evose

Open API

让业务系统​直接调用智能体

工单系统、CRM 和内部工具都能通过 API 调用 Evose 里发布的智能体和工作流。可以同步等结果,也可以先拿到运行 ID,跑完再回调通知。

阅读 API 文档

接进现有系统,不用重写流程

  • 调用团队已经搭好的

    团队在 Evose 里发布的智能体、编排智能体和工作流,都能从 API 调用。默认调用最新发布的版本,在 Evose 里改了提示词,代码不用跟着改。

  • 长任务不用一直等

    异步发起后马上拿到运行 ID。可以按 ID 查询结果,也可以留一个回调地址,跑完推给你。

  • 一个 Key 管一件事

    每个 API Key 只能调用指定的应用,可以设有效期,随时停用。

从发布到第一次调用

  1. 01

    发布一个应用

    在 Evose 里搭好智能体、编排智能体或工作流,发布后就能从 API 调用。

  2. 02

    创建 API Key

    选好归属范围和可以调用的应用,把 Key 放进你们的服务里。

  3. 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 产生的成本和配额用量,都能在观测里单独查看。

常见问题

从第一次 API 调用开始

在 Evose 里搭好智能体,创建一个 Key,几行代码就能接进你们的系统。

联系销售