# 获取提示词 - ShowPrompt #### 功能介绍 获取提示词。 #### URI GET /v1/{project_id}/applications/{application_id}/uni-search/prompt/{prompt_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0022.html)。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 | | application_id | 是 | String | **参数解释：** 应用ID，获取方法请参见[获取应用ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0021.html)。 **约束限制：** 字符串 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 | | prompt_id | 是 | String | **参数解释：** 提示词ID。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线。 **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：[获取IAM用户Token](https://support.huaweicloud.com/api-koosearch/koosearch_06_0009.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 提示词id。 **取值范围：** 不涉及 | | name | String | **参数解释：** 提示词名称。 **取值范围：** 不涉及 | | detail | String | **参数解释：** 提示词描述。 **取值范围：** 不涉及 | | create_time | String | **参数解释：** 提示词创建时间，13位时间戳。 **取值范围：** 不涉及 | | update_time | String | **参数解释：** 提示词更新时间，13位时间戳。 **取值范围：** 不涉及 | | type | String | **参数解释：** 提示词类型。 **取值范围：** 不涉及 | | knowledge_repos | Array of [KnowledgeRepoItem] objects | **参数解释：** 本提示词关联的知识库。 **取值范围：** 不涉及 | | prompts | Array of [PromptItem] objects | **参数解释：** 提示词多语言列表，最大长度为20。 **取值范围：** 不涉及 | | freemarker_enabled | Boolean | **参数解释：** 是否启用FreeMarker模板引擎。 **取值范围：** - true: 启用 - false: 不启用 | | search_scope | String | **参数解释：** 搜索范围。 **取值范围：** - DOCUMENT 文档库 - FAQ 常见问题 - KEYWORD 关键词搜索 - MIX 混合搜索 - PANGU_WIKI 内置wiki库 - WEB web搜索引擎 - TABLE 仅表格 | | creator | String | **参数解释：** 提示词的创建者。 **取值范围：** 不涉及 | 表4KnowledgeRepoItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 知识库ID。 **取值范围：** 不涉及 | | name | String | **参数解释：** 知识库名称。 **取值范围：** 不涉及 | 表5PromptItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | language | String | **参数解释：** 语言名称。 **约束限制：** 不涉及 **取值范围：** - zh==CHINESE - en==ENGLISH - th==THAI - ar==ARABIC - es==SPANISH - pt==PORTUGUESE **默认取值：** 不涉及 | | prompt | String | **参数解释：** 提示词。 **约束限制：** 不涉及 **取值范围：** 最大长度为8192。 **默认取值：** 不涉及 | | attention | String | **参数解释：** 注意事项。 **约束限制：** 不涉及 **取值范围：** 最大长度为65535。 **默认取值：** 不涉及 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** [错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。 **取值范围：** 不涉及 | | error_msg | String | **参数解释：** 错误描述。 **取值范围：** 不涉及 | **状态码：500** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** [错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。 **取值范围：** 不涉及 | | error_msg | String | **参数解释：** 错误描述。 **取值范围：** 不涉及 | #### 请求示例 通过prompt_id获取提示词 ``` /v1/b25446daeb1a41a7953c5deba2b2677a/applications/5071b12e-8c5c-4181-a15b-41e6ae3915ea/uni-search/prompt/e7a7d1eb-865d-460a-939d-7310025047be ``` #### 响应示例 **状态码：200** 修改提示词返回体。 ``` { "id" : "e7a7d1eb-865d-460a-939d-7310025047be", "name" : "api-demo", "type" : "CHAT_PROMPT", "detail" : "", "create_time" : "1764072993255", "update_time" : "1764072993255", "knowledge_repos" : [ ], "prompts" : [ { "language" : "ar", "prompt" : "xxxx", "attention" : "xxx" }, { "language" : "en", "prompt" : "xxxx", "attention" : "xxx" }, { "language" : "es", "prompt" : "xxxx", "attention" : "xxx" }, { "language" : "pt", "prompt" : "xxxx", "attention" : "xxx" }, { "language" : "th", "prompt" : "xxxx", "attention" : "xxx" }, { "language" : "zh", "prompt" : "xxxx", "attention" : "xxx" } ], "search_scope" : "DOCUMENT", "creator" : "", "freemarker_enabled" : false } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 修改提示词返回体。 | | 400 | 请求体参数错误。 | | 500 | 内部异常。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。