logo
当前页

主动调用 LLM


描述

本接口可用于,以用户身份主动调用 LLM 服务,并基于 LLM 的响应内容,以智能体身份主动调用 TTS 服务,向用户发送语音消息。

  • 当调用此接口时,若会话中的智能体正在说话,则该智能体的说话进程会被打断;
  • 调用本接口传入的文本信息及 LLM 生成的回复会被记录在会话消息历史之中,作为上下文输入给 LLM,同时这些消息还会通过 RTC 房间消息下发。

接口原型

  • 请求方法:POST
  • 请求地址:https://aigc-aiagent-api.zegotech.cn?Action=SendAgentInstanceLLM
  • 传输协议:HTTPS
  • 调用频率限制:10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数

参数类型是否必选描述
AgentInstanceIdString智能体实例的唯一标识,通过 创建智能体实例 接口的响应参数获取。
TextString发送给 LLM 服务的文本内容。
SystemPromptString是否需要临时修改本次对话的智能体系统提示(prompt),若需要则填写本字段。若填空,则不改动本轮对话的system。

请求示例

  • 请求地址 URL:

    Untitled
    https://aigc-aiagent-api.zegotech.cn?Action=SendAgentInstanceLLM
    &<公共请求参数>
    
    1
    Copied!
  • 请求消息体:

    Untitled
    {
        "AgentInstanceId": "1907755175297171456",
        "Text": "今天天气怎么样?"
    }
    
    1
    Copied!

响应参数

参数类型描述
CodeInt返回码。0 表示成功,其他值表示失败。如需了解错误码及响应处理建议,请参考 返回码
MessageString请求结果的说明信息。
RequestIdString请求 ID。
DataObject此请求结果为 null

响应示例

Untitled
{
    "Code": 0,
    "Message": "Succeed",
    "RequestId": "1843985617336143872",
    "Data": null
}
1
Copied!

Previous

删除智能体实例

Next

主动调用 TTS