更新时间:2025-11-28 GMT+08:00
分享

获取提示词 - ShowPrompt

功能介绍

获取提示词。

URI

GET /v1/{project_id}/applications/{application_id}/uni-search/prompt/{prompt_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

application_id

String

参数解释:

应用ID,获取方法请参见获取应用ID

约束限制:

字符串

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

prompt_id

String

参数解释:

提示词ID。

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线。

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

接口鉴权使用的Token,Token获取方式参考:获取IAM用户Token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释:

提示词id。

取值范围:

不涉及

name

String

参数解释:

提示词名称。

取值范围:

不涉及

detail

String

参数解释:

提示词描述。

取值范围:

不涉及

create_time

String

参数解释:

提示词创建时间,13位时间戳。

取值范围:

不涉及

update_time

String

参数解释:

提示词更新时间,13位时间戳。

取值范围:

不涉及

type

String

参数解释:

提示词类型枚举值

DEFAULT_CHAT_PROMPT 默认搜索增强提示词

DEFAULT_QA_ANSWER_PROMPT 默认qa答案生成提示词

DEFAULT_QA_QUESTION_PROMPT 默认qa问题生成提示词

CHAT_PROMPT 搜索增强提示词

QA_QUESTION_PROMPT qa问题生成提示词

QA_ANSWER_PROMPT qa答案生成提示词

MLLM_PROMPT 多模态模型提示词

取值范围:

  • DEFAULT_CHAT_PROMPT 默认搜索增强提示词

  • DEFAULT_QA_ANSWER_PROMPT 默认qa答案生成提示词

  • DEFAULT_QA_QUESTION_PROMPT 默认qa问题生成提示词

  • CHAT_PROMPT 搜索增强提示词

  • QA_QUESTION_PROMPT qa问题生成提示词

  • QA_ANSWER_PROMPT qa答案生成提示词。

  • MLLM_PROMPT 多模态模型提示词。

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

参数解释:

提示词的创建者。

取值范围:

不涉及

表4 KnowledgeRepoItem

参数

参数类型

描述

id

String

参数解释:

知识库ID。

取值范围:

不涉及

name

String

参数解释:

知识库名称。

取值范围:

不涉及

表5 PromptItem

参数

参数类型

描述

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

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

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

内部异常。

错误码

请参见错误码

相关文档