
# 获取对话详情 - ShowChat
#### 功能介绍
获取对话详情。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0100.html)。
#### URI
GET /v1/{project_id}/chats/{chat_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0033.html)中获取。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-128\]个字符。 **默认取值**： 不涉及 |
| chat_id    | 是    | String | **参数解释**： 对话ID。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-128\]个字符。 **默认取值**： 不涉及                                                                                           |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0011.html)接口响应消息头中X-Subject-Token的值即为Token。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-32768\]个字符。 **默认取值**： 不涉及 |
   
#### 响应参数
**状态码：200**
表3响应Header参数 
| 参数              | 参数类型   | 描述                                                                                       |
|:---|:---|:---|
| X-Chat-Route-Id | String | **参数解释**： 对话路由ID。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-64\]个字符。 **默认取值**： 不涉及 |
   
表4响应Body参数 
| 参数            | 参数类型                                                                  | 描述                                                                                        |
|:---|:---|:---|
| id            | String                                                                | **参数解释**： 对话ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                 |
| title         | String                                                                | **参数解释**： 对话名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                 |
| alias         | String                                                                | **参数解释**： 对话别名。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                 |
| create_time   | String                                                                | **参数解释**： 对话创建时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                               |
| update_time   | String                                                                | **参数解释**： 对话更新时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                               |
| repo_ids      | Array of strings                                                      | **参数解释**： 绑定的知识库ID列表。 **约束限制**： 绑定的知识库数量范围为\[0-5\]。 **取值范围**： 不涉及 **默认取值**： 不涉及           |
| agent_type    | String                                                                | **参数解释**： 助手类型。 **约束限制**： 不涉及 **取值范围**： - auto：通用助手 - drug：药物助手 - gene：基因助手 **默认取值**： 不涉及 |
| agent_role    | String                                                                | **参数解释**： 助手角色。 **约束限制**： 不涉及 **取值范围**： - Common：对话助手角色 - Biomed：作业助手角色 **默认取值**： Common  |
| chat_messages | Array of [ChatMessageRsp] objects | **参数解释**： 对话问答列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                               |
   
 表5ChatMessageRsp 
| 参数            | 参数类型                                                    | 描述                                                                                                               |
|:---|:---|:---|
| id            | String                                                  | **参数解释**： 问答ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                        |
| role          | String                                                  | **参数解释**： 问答角色。 **约束限制**： 不涉及 **取值范围**： - user：用户问题的内容 - assistant：助手回答内容 **默认取值**： 不涉及                          |
| type          | String                                                  | **参数解释**： 问答类型。 **约束限制**： 不涉及 **取值范围**： - chat_call：普通问答 - tool_call：实验问答 - deepresearch_call：深度探究 **默认取值**： 不涉及 |
| create_time   | String                                                  | **参数解释**： 问答创建时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                      |
| update_time   | String                                                  | **参数解释**： 问答更新时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                      |
| feedback_type | String                                                  | **参数解释**： 反馈类型。 **约束限制**： 不涉及 **取值范围**： - upvote：点赞 - downvote：点踩 - none：取消反馈 **默认取值**： 不涉及                      |
| message       | [ChatMessage] object   | **参数解释**： 对话内容。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                        |
| addition      | [ChatAddition] object | **参数解释**： 对话额外信息。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                      |
   
 表6ChatMessage 
| 参数                | 参数类型                                                      | 描述                                                             |
|:---|:---|:---|
| content           | String                                                    | **参数解释**： 对话内容。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及      |
| reasoning_content | String                                                    | **参数解释**： 深度搜索思维链内容。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 |
| tool_calls        | Array of [ToolCall] objects | **参数解释**： 工具调用列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及    |
   
 表7ToolCall 
| 参数         | 参数类型                 | 描述                                                                                                   |
|:---|:---|:---|
| type       | String               | **参数解释**： 工具类型。 **约束限制**： 不涉及 **取值范围**： - drug_job：药物作业 - workflow：流程作业 **默认取值**： 不涉及                |
| name       | String               | **参数解释**： 工具名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                            |
| operation  | String               | **参数解释**： 工具操作。 **约束限制**： 不涉及 **取值范围**： - create：新增 - delete：删除 - update：修改 - query：查询 **默认取值**： 不涉及 |
| parameters | Map\<String,Object\> | **参数解释**： 工具调用所需参数列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                      |
   
 表8ChatAddition 
| 参数           | 参数类型   | 描述                                                                                                                                                         |
|:---|:---|:---|
| workspace_id | String | **参数解释**： 实验问答使用的空间ID，您可以从[获取空间ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0099.html)中获取。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 |
| job_id       | String | **参数解释**： 实验问答的作业ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                                                             |
| job_config   | String | **参数解释**： 实验问答的额外配置信息。 **约束限制**： 不涉及 **取值范围**： 取值范围为\[1-2048\]个字符。 **默认取值**： 不涉及                                                                           |
| tool_type    | String | **参数解释**： 实验类型。 **约束限制**： 不涉及 **取值范围**： - drug_job：药物实验作业 - workflow_job：流程实验作业 **默认取值**： 不涉及                                                              |
| job_type     | String | **参数解释**： 作业类型。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                                                                  |
| data_path    | String | **参数解释**： 深度探究生成报告存储路径。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                                                          |
   
#### 请求示例
获取对话详情。
```
https://{endpoint}/v1/{project_id}/chats/{chat_id}
```
#### 响应示例
**状态码：200**
OK
```
{
  "id" : "56e0f1b0-ac10-46a5-8fa7-b26831d7d488",
  "title" : "demo_title",
  "alias" : "alias",
  "create_time" : "2021-01-30T02:34:36Z",
  "update_time" : "2021-01-30T02:34:36Z",
  "agent_type" : "auto",
  "chat_messages" : [ {
    "id" : "56e0f1b0-ac10-46a5-8fa7-b26831d7d488",
    "type" : "chat_call",
    "create_time" : "2021-01-30T02:34:36Z",
    "update_time" : "2021-01-30T02:34:36Z",
    "message" : {
      "content" : "什么是定量构效关系"
    }
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ai4sservice/ErrorCode.html)。
