文档中心 > API类目 > Skill开放

taobao.top.skill.open.chat.submit (淘宝TOP Skill开放提交Chat)

淘宝TOP Skill开放提交Chat

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query String 可选 今天天气怎么样 用户输入的查询内容
session_id String 可选 sess_1234567890abcdef 会话ID
history String 可选 [{"role":"user","content":"你好"},{"role":"assistant","content":"您好!"}] 会话历史记录
file_input String 可选 file_abc123xyz 上传的附件信息
client_version String 可选 1.0.0 端版本
out_conversation_id String 可选 xxx 外部会话id
client_request_id String 可选 xxx 端请求id

响应参数

名称 类型 示例值 描述
op_done Boolean true 操作是否完成

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopSkillOpenChatSubmitRequest req = new TopSkillOpenChatSubmitRequest();
req.setQuery("今天天气怎么样");
req.setSessionId("sess_1234567890abcdef");
req.setHistory("[{\"role\":\"user\",\"content\":\"你好\"},{\"role\":\"assistant\",\"content\":\"您好!\"}]");
req.setFileInput("file_abc123xyz");
req.setClientVersion("1.0.0");
req.setOutConversationId("xxx");
req.setClientRequestId("xxx");
TopSkillOpenChatSubmitResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<top_skill_open_chat_submit_response>
    <op_done>true</op_done>
</top_skill_open_chat_submit_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部