文档

智能体通话记录

更新时间:

通过阅读本文,您可以了解如何查看智能体的通话记录。

功能概述

智能体通话记录功能旨在为您提供一种高效且便捷的方式,以记录和管理其通讯过程中的语音数据。该功能运用先进的语音识别技术,能够自动转录通话内容,从而便于您对通话记录进行审核、模型训练等操作。

通话记录字段说明

参数名

类型

描述

instanceId

String

通话记录的唯一实例ID

startTime

Float

通话开始时间(UNIX时间戳,单位秒)

dialog

Array

对话记录数组

  • id

Int

对话编号,按输出(包括智能体和用户)的顺序递增,方便识别时序以及追踪对话

  • begin

Float

开始相对时间(单位:秒)

  • role

String

说话者角色:

  • 用户(user)

  • 智能体(agent)

说明

由于存在打断情况,实际agent的对话可能播报不完整

  • type

String

对话类型:

  • 欢迎语(greeting)

  • 正常对话 (normal)

  • 主动播报(speech)

  • text

String

对话文本,表示说话内容

结构示例如下:

{
  "instanceId": "xxx", // 实例ID
  "startTime": 123456789.123 // 通话起始绝对时间(UNIX时间戳,单位秒)
  "dialog": [ // 对话记录数组
    {
      "id": 1, // 对话编号
      "begin": 0.340, // 开始相对时间,单位秒
      "role": "agent", // 角色,agent代表智能体,user代表用户
      "type": "greeting", // 对话类型:greeting(欢迎语),normal(正常对话),speech(主动播报)
      "text": "你好,有什么可以帮助你的?" // 对话文本
    },
    {
      "id": 2,
      "begin": 2.784,
      "role": "user",
      "type": "normal",
      "text": "今天星期几?"
    },
    {
      "id": 3,
      "begin": 4.051,
      "role": "agent",
      "type": "normal",
      "text": "今天是星期天。"
    }
  ]
}

获取通话记录Demo

Python

#!/usr/bin/env python
#coding=utf-8

import os
import json
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest
from aliyunsdkcore.auth.credentials import AccessKeyCredential
from aliyunsdkcore.auth.credentials import StsTokenCredential

# Please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set.
credentials = AccessKeyCredential("YOUR_AK", "YOUR_SK")
# use STS Token
# credentials = StsTokenCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'], os.environ['ALIBABA_CLOUD_SECURITY_TOKEN'])
client = AcsClient(region_id='cn-hangzhou', credential=credentials)

request = CommonRequest()
request.set_accept_format('json')
request.set_domain('ice.cn-hangzhou.aliyuncs.com')
request.set_method('POST')
request.set_protocol_type('https') # https | http
request.set_version('2020-11-09')
request.set_action_name('DescribeAIAgentInstance')

request.add_query_param('InstanceId', "YOUR_INSTANCE_ID")

response = client.do_action(request)
response_dict = json.loads(response)

instance_status = response_dict['Instance']['CallLogUrl']
print(instance_status)