问答接口

请求参数

返回数据

{
    "failMessage": "fail msg",//转人工成功提示语
    "skillGroup": "groupId",//客服组id
    "successTip": "success msg",//转人工成功提示语
    "ttpType":"SOLUTION_TTP",//表示转人工类型。可选值有INSTRUCT_TTP("指令转人工"),SOLUTION_TTP("答案直连人工"),GLOBAL_KEYWORD("全局关键词转人工"),STRATEGY("命中转人工策略");
    "type": "LIVEAGENT"//contentType
}

{
    "content": "test msg",
    "type": "TEXT"
}

{
    "imgUrl": "http://test.aliyuncdn.com/xxx.png",
    "type": "IMAGE"
}

{
  "type": "NO_ANSWER",
  "noAnswerType": "MISS_SCENE"
}

{
    "code": "ORDER_SELECT",
    "type": "SELECTOR"
 }

1.场景来源：单轮：singleRound， 多轮：multiRounds ，

2.上下模块（多轮模式下补充）：context_scene_inherit（场景继承）、context_scene_semantic （基于语义的上下文）、context_scene_rule（基于知识的上下文）、context_scene_e2e（端到端的上下文）

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeMessage
&RobotCode=1cY9drMec4b2uzS2
&SessionId=aUeafnr-scgyw28f4
&ChatId=c8jd-2ncpocs
&Round=2
&Content=你好
&ContentType=TEXT
&UserNick=买家账号
&UserId=12345678
&StaffNick=智能助理测试账号:客服
&StaffId=12341
&SellerNick=智能助理测试账号
&SellerId=124234
&ServiceMode=AUTO
&FocusOrderId=987654321
&FocusItemId=13579
&Orders=[{"OrderId":"987654321","ParentOrderId":"1234567890","CreateTime":1611130298820,"PayTime":1611130298820,"BuyerId":"123445","SellerId":"124321143","PayStatus":"STATUS_PAID","RefundStatus":"STATUS_WAIT_SELLER_AGREE","LogisticsStatus":"STATUS_CONSIGNED","BuyerRateStatus":"RATE_STATUS_RATED","ItemId":"13579","ItemTitle":"xxx商品","ItemPic":"https://image.alicdn.com/xxxxx","Price":123.45,"Count":1,"SkuProperty":"颜色:红;材质:棉"}]
&ExpectedSlots=[{"SlotKey":"sys.number.bodyheight"}]
&Items=[{"ItemId":"13579","SellerId":"124321143","Title":"xxx商品","CategoryId":"3333333","ShopCategoryIds":["12343421"],"Price":123.45,"PicUrl":"https://img.alicdn.com/xxxxx","Property":{"key":"颜色:红"}}]
&Packages=[{"PackageCode":"common","PackageVersion":"2"}]
&ClientInfo={"ClientVersion":"2.0.5","ClientApp":"taobao","ClientOs":"ios"}
&StressTesting=false
&PlatformCode=RETAILBOT_PAAS
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizeMessageResponse>
    <RequestId>59C3CCE4-24B1-4277-A4A0-C0EFE4C14E0A</RequestId>
    <Data>
        <Scene>
            <SceneDTOs>
                <SceneKey>sc_wenhou</SceneKey>
                <SceneSource>singleRound</SceneSource>
                <contextModule>context_scene_e2e</contextModule>
            </SceneDTOs>
            <EmotionTag>fq_fennu</EmotionTag>
            <SemanticComplete>SEMANTIC_COMPLETE</SemanticComplete>
            <ItemId>13579</ItemId>
            <OrderId>987654321</OrderId>
        </Scene>
        <Knowledges>
            <KnowledgeId>1</KnowledgeId>
            <KnowledgeTitle>测试知识</KnowledgeTitle>
            <SceneKey>sc_wenhou</SceneKey>
            <Solutions>
                <SolutionId>3</SolutionId>
                <KnowledgeId>1</KnowledgeId>
                <SolutionType>text</SolutionType>
                <SolutionSource>source</SolutionSource>
                <SolutionContent>你好</SolutionContent>
                <Conditions>
                    <ConditionType>EffectiveMode</ConditionType>
                    <ConditionValue>auto</ConditionValue>
                </Conditions>
                <ExtraContent>["emoji1","emoji2"]</ExtraContent>
                <SolutionVariables>
                    <VariableName>变量名称</VariableName>
                    <VariableType>系统变量</VariableType>
                </SolutionVariables>
            </Solutions>
        </Knowledges>
        <OutputMessages>
            <OutputContentType>ASK_TEXT</OutputContentType>
        </OutputMessages>
        <UnitSlots>
            <UnitSpans>
                <Start>0</Start>
                <End>4</End>
                <SlotKey>sys.number.bodyheight</SlotKey>
                <SlotValue>170cm</SlotValue>
                <Source>model</Source>
                <Score>0.8</Score>
                <Alias>身高</Alias>
                <NumericSlotValue>
                    <Num>170</Num>
                    <Unit>
                        <UnitKey>length_si_cm</UnitKey>
                        <UnitName>厘米</UnitName>
                    </Unit>
                </NumericSlotValue>
            </UnitSpans>
        </UnitSlots>
    </Data>
    <Success>true</Success>
    <Code>200</Code>
    <Message>successful</Message>
</RecognizeMessageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "59C3CCE4-24B1-4277-A4A0-C0EFE4C14E0A",
  "Data" : {
    "Scene" : {
      "SceneDTOs" : [ {
        "SceneKey" : "sc_wenhou",
        "SceneSource" : "singleRound",
        "contextModule" : "context_scene_e2e"
      } ],
      "EmotionTag" : "fq_fennu",
      "SemanticComplete" : "SEMANTIC_COMPLETE",
      "ItemId" : "13579",
      "OrderId" : "987654321"
    },
    "Knowledges" : [ {
      "KnowledgeId" : 1,
      "KnowledgeTitle" : "测试知识",
      "SceneKey" : "sc_wenhou",
      "Solutions" : [ {
        "SolutionId" : 3,
        "KnowledgeId" : 1,
        "SolutionType" : "text",
        "SolutionSource" : "source",
        "SolutionContent" : "你好",
        "Conditions" : [ {
          "ConditionType" : "EffectiveMode",
          "ConditionValue" : "auto"
        } ],
        "ExtraContent" : "[\"emoji1\",\"emoji2\"]",
        "SolutionVariables" : [ {
          "VariableName" : "变量名称",
          "VariableType" : "系统变量"
        } ]
      } ]
    } ],
    "OutputMessages" : [ {
      "OutputContentType" : "ASK_TEXT"
    } ],
    "UnitSlots" : {
      "UnitSpans" : [ {
        "Start" : 0,
        "End" : 4,
        "SlotKey" : "sys.number.bodyheight",
        "SlotValue" : "170cm",
        "Source" : "model",
        "Score" : 0.8,
        "Alias" : "身高",
        "NumericSlotValue" : {
          "Num" : 170,
          "Unit" : {
            "UnitKey" : "length_si_cm",
            "UnitName" : "厘米"
          }
        }
      } ]
    }
  },
  "Success" : true,
  "Code" : "200",
  "Message" : "successful"
}

错误码

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