更新时间:2025-07-30 GMT+08:00
分享

使用API调用多智能体应用

Agent开发平台支持将创建好的应用进行API调用。在调用应用前,请先参考创建多智能体应用,完成创建多智能体应用操作。

获取调用路径:

  1. 登录Agent开发平台。
  2. 在“我的工作台 > 应用管理->多智能体应用”页面,单击所需应用的 > 调用路径。
    图1 获取应用调用路径
  3. 在“调用路径”页面,单击“复制路径”即可获取调用路径。

    其中,conversation_id参数为会话ID,唯一标识每个会话的标识符,可将会话ID设置为任意值,使用标准UUID格式。

    图2 应用调用路径详情页面

调用API

  1. 请求样例
    curl 'http://ip:port/v1/{project_id}/agents/{agent_id}/conversations/{conversation_id}?type=controller' \
      -H 'Cache-Control: no-cache' \
      -H 'Connection: keep-alive' \
      -H 'Content-Type: application/json' \
      -H 'x-user-id=:user_id' \
      -H 'x-project-id=:project_id' \
      -H 'stream: true' \
      --data-raw '{"inputs":{"name":"小明","query":"你好"}}' \
      --insecure

    上面"{}"中均为变量,需要根据实际取值填写。

    project_id:Agent归属projectid,参考获取项目ID

    agent_id: 实际要运行的多智能体id。左侧导航栏选择“应用管理 > 多智能体应用(beta)”,在所需Agent中单击“... > 复制ID”。可获取多智能体ID。

    conversation_id:会话ID,唯一标识每个会话的标识符,可将会话ID设置为任意值,使用标准UUID格式。

    user_id:指定访问用户ID。用户ID可在控制台右上角单击当前账号 >,在弹出的对话框选择“我的凭证 > IAM用户ID”获取 。

  2. 响应样例
    data:{"event":"message","data":{"text":"您好,这里是工商银行智能助手,感谢您的接听,如果通话给您带来不便,您可以直接告诉我。请问您是小明先生/女士吗?","index":0,"node_id":"node_1747035601714","node_type":"Questioner","workflow_id":"17aa0ef8-7fbb-4a93-acf1-172d7a10524b"}}
    data:{"event":"message","data":{"text":"","node_id":"node_1747035601714","node_type":"Questioner","is_finished":true,"workflow_id":"17aa0ef8-7fbb-4a93-acf1-172d7a10524b"}}
    data:{"event":"end"}

相关文档