调用Associate接口给出推荐

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String Associate

系统规定参数。取值:Associate。

InstanceId String chatbot-cn-eEf

机器人实例ID

Utterance String 干货

用户表述

SessionId String 25670484f2ab4b42ba90acbfbf86d4cd

会话ID,用于标识一个访问者的会话和保持上下文信息。对于一个新的访问者,首次调用Chat接口时无需传递此字段,机器人会开启一个会话,并在Chat接口的响应中返回该会话的SessionId。对于该访问者的后续轮次的会话,调用Chat接口时传递当前会话的SessionId,机器人即可基于SessionId继续该轮次会话。

Perspective.N RepeatList FZJBY3raWr

视角编码,用于调用同一知识标题下不同视角的答案。在拼装请求参数时,需要以Perspective={视角编码}的格式传递参数。如:&Perspective="FZJBY3raWr"。使用SDK时以SDK中定义的参数为准。目前仅支持一个视角答案的调用。 (公有云)

RecommendNum Integer 1

推荐问题数量,1-10,当出推荐的时候才生效,返回不大于RecommendN

RegionId String cn-shanghai

地域id

返回数据

名称 类型 示例值 描述
Associate Array of Associate

联想推荐的列表

Title String 初级干货

关联问题的标题

MessageId String 11bab7a2e34c4e02bcf0ebcb76bb812d

本条会话应答消息的ID

RequestId String 402FCD5F-518E-4C8E-8A6B-EFEADA69D757

请求id

SessionId String 25670484f2ab4b42ba90acbfbf86d4cd

本次会话的ID

示例

请求示例

http(s)://[Endpoint]/?Action=Associate
&InstanceId=584
&Utterance=干货
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>402FCD5F-518E-4C8E-8A6B-EFEADA69D757</RequestId>
<Associate>
    <Title>初级干货</Title>
</Associate>
<Associate>
    <Title>中级干货</Title>
</Associate>
<Associate>
    <Title>注会干货</Title>
</Associate>
<SessionId>25670484f2ab4b42ba90acbfbf86d4cd</SessionId>
<MessageId>11bab7a2e34c4e02bcf0ebcb76bb812d</MessageId>

JSON 格式

{
    "RequestId": "402FCD5F-518E-4C8E-8A6B-EFEADA69D757",
    "Associate": [
        {
            "Title": "初级干货"
        },
        {
            "Title": "中级干货"
        },
        {
            "Title": "注会干货"
        }
    ],
    "SessionId": "25670484f2ab4b42ba90acbfbf86d4cd",
    "MessageId": "11bab7a2e34c4e02bcf0ebcb76bb812d"
}

错误码

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