RealTimeDialog - 实时会话

更新时间:2025-01-16 15:02:21

实时会话,通过API CreateDialog创建会话后,可使用该API进行实时会话。

接口说明

请确保在使用该接口前,已充分了解通义点金产品的收费方式和价格。

前提条件

已开通百炼服务和通义点金服务。

获取到 workspaceId:获取 workspace 标识

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
操作访问级别资源类型条件关键字关联操作
dianjin:RealTimeDialognone
*全部资源
*

请求语法

POST /{workspaceId}/api/realtime/dialog/chat HTTP/1.1

请求参数

名称类型必填描述示例值
名称类型必填描述示例值
workspaceIdstring

业务空间 Id

llm-xxxxx
bodyobject

请求体参数。

bizTypestring

业务类型,默认 mixIntentChat。

mixIntentChat
analysisboolean

是否分析

false
recommendboolean

推荐意图

false
metaDataobject

元信息,用于封装提示词。

{ "phoneTailNumber": "机主尾号:98X1", "preScreeningQuota": "预审额度:3万", "generalInterest": "平台一般利息:20.4%" }
streamboolean

是否流式返回

false
conversationModelarray<object>

对话列表

conversationModelobject

对话

roleinteger

角色。0 表示客户,1 表示坐席。

0
customerServiceTypestring

坐席类型,0: 机器人,1: 人工。

0
customerServiceIdstring

客服 ID,必填

1374683645635
customerIdstring

对话角色的唯一标识,必填

98457834685635
contentstring

对话的具体内容

人工客服
typestring

对话内容的类型[text(文本),audio(音频),image(图片)]

audio
beginTimestring

这句话的开始时间

2024-11-08 09:51:16
begininteger

本句话的开始时间,相对于会话开始点的偏移时间 ms

5
endinteger

本句话的结束时间,相对于会话开始点的偏移时间 ms

10
sessionIdstring

会话 ID

237645726354
dialogMemoryTurnsinteger

携带的会话历史轮数

3

返回参数

名称类型描述示例值
名称类型描述示例值
object

IntentionChatResp

idstring

本次调用的唯一标识符。每个 chunk 对象有相同的 id。

eb2b6139-ddf1-91a0-a47f-df7617ae9032
choicesarray<object>

生成内容的数组,可包含一个或多个 choices 对象。

choiceobject

生成内容

indexinteger

在 choices 列表中的序列编号。

0
finishReasonstring

会话结束时为 stop,会话正在进行中为 null;当 success 为 false 时,为错误信息。

stop
messageobject

非流式时,返回的全量结果。流式时为空。

intentionCodestring

意图 code

1853360771162058752
intentionScriptstring

意图话术

抱歉,我没有明白您的意思,或者您可以拨打我们的客服热线,请客服人员为您解答。
intentionNamestring

意图名称

其它
recommendIntentionstring

推荐意图

null
recommendScriptstring

推荐话术

null
analysisProcessstring

分析过程

null
selfDirectedScriptstring

自主问答话术 增量数据。流式时为空。

null
callTimestring

time

1735139569523
hangUpDialogboolean

挂断对话

false
selfDirectedScriptFullContentstring

自主问答话术 全量数据

关于宇宙的大小,这是一个非常深奥的科学话题
deltaobject

流式时,返回的增量结果。非流式时为空。

intentionCodestring

意图 code

1853360771162058752
intentionScriptstring

意图话术

抱歉,我没有明白您的意思,或者您可以拨打我们的客服热线,请客服人员为您解答。
intentionNamestring

意图名称

其他
recommendIntentionstring

推荐意图

null
recommendScriptstring

推荐话术

null
analysisProcessstring

分析过程

null
selfDirectedScriptstring

自主问答话术 增量数据。

话题
callTimestring

time

null
hangUpDialogboolean

挂断对话

false
selfDirectedScriptFullContentstring

自主问答话术 全量数据

关于宇宙的大小,这是一个非常深奥的科学话题
createdstring

本次请求被创建的时间戳

1735139569523
successboolean

是否成功

true
requestIdstring

请求 id

5E3FBAF1-17AF-53B7-AF0A-CDCEEB6DE658

示例

正常返回示例

JSON格式

{
  "id": "eb2b6139-ddf1-91a0-a47f-df7617ae9032",
  "choices": [
    {
      "index": 0,
      "finishReason": "stop",
      "message": {
        "intentionCode": "1853360771162058752",
        "intentionScript": "抱歉,我没有明白您的意思,或者您可以拨打我们的客服热线,请客服人员为您解答。",
        "intentionName": "其它",
        "recommendIntention": "null",
        "recommendScript": "null",
        "analysisProcess": "null",
        "selfDirectedScript": "null",
        "callTime": "1735139569523",
        "hangUpDialog": false,
        "selfDirectedScriptFullContent": "关于宇宙的大小,这是一个非常深奥的科学话题\n"
      },
      "delta": {
        "intentionCode": "1853360771162058752",
        "intentionScript": "抱歉,我没有明白您的意思,或者您可以拨打我们的客服热线,请客服人员为您解答。",
        "intentionName": "其他",
        "recommendIntention": "null",
        "recommendScript": "null",
        "analysisProcess": "null",
        "selfDirectedScript": "话题",
        "callTime": "null",
        "hangUpDialog": false,
        "selfDirectedScriptFullContent": "关于宇宙的大小,这是一个非常深奥的科学话题"
      }
    }
  ],
  "created": "1735139569523",
  "success": true,
  "requestId": "5E3FBAF1-17AF-53B7-AF0A-CDCEEB6DE658"
}

错误码

访问错误中心查看更多错误码。

  • 本页导读 (1)
  • 接口说明
  • 调试
  • 授权信息
  • 请求语法
  • 请求参数
  • 返回参数
  • 示例
  • 错误码
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等