创建Prompt优化任务

更新时间：2025-04-18

注意： 为提升开发者使用体验，本文内容已合并至对应API文档，请查看API鉴权及调用-Prompt工程-Prompt工程V1-创建Prompt优化任务文档；本文档已于2024年6月28日在平台文档中心下线，内容不再更新。

功能介绍

用于用于创建Promp优化任务。

注意事项

调用本文API，需使用安全认证AK/SK鉴权，调用流程及鉴权介绍详见SDK安装及使用流程。

调用示例

Python

import os
from qianfan.resources import Prompt

# 使用安全认证AK/SK鉴权，通过环境变量方式初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

resp = Prompt.create_optimiztion_task(
    content="帮我写一份{job}年终总结", 
    operations=[
        {"opType":1,"payload":1},
        {"opType":2,"payload":0},
        {"opType":3,"payload":1},
        {"opType":4,"payload":0}
    ],
)
print(resp)

返回示例

Python

QfResponse(
    code=200,
    headers={...},
    body={
        'log_id': '13d4th5mh73dqmwi',
        'result': {'id': 'task-up1pwjkph1bx85mt'},
        'status': 200,
        'success': True
    },
    statistic={...},
    request=QfRequest(...)
)

参数说明

请求参数

名称	类型	必填	描述
content	string	是	原始prompt内容
operations	list[object]	是	算子类型及其设置值。说明：（1）4种算子必须都包括，有且仅有一条，不可重复、缺项（2）算子设置的值见operations 说明
appID	int	否	选择的应用AppID。通过以下方法获取该字段值：在控制台-模型服务-应用接入列表中查看
serviceName	string	否	选择的模型服务名称，包括预置服务和自定义服务。示例：ERNIE-Bot，可以通过以下方式获取该字段值：在控制台-Prompt优化-在线优化页面，查看支持的模型服务列表。例如，支持的预置服务，部分模型名称如下图所示，

operations 说明

名称	类型	描述
opType	int	优化算子的类型。说明：（1）该字段每个值对应一种算子，目前共4种算子（2）各算子说明如下 · 1：质量优化；启用此功能会提供可能更好质量的提示词，但花费更长的时间优化 · 2：缩短提示词；可以省去“的”、“吧”等含义不强的文本实体，精炼语料内容并降低推理成本 · 3：迭代轮次；反复迭代Prompt优化，更多的迭代次数意味着优化效果越强，但也需要花费更长时间 · 4：思维链条；开启后将指引模型拆解Prompt内容，逐步进行推理。建议仅在数学计算、逻辑推理等场景下开启使用
payload	int	各类型优化算子对应的输入参数，说明：（1）当opType值为3，该字段取值1或2 （2）当opType值为1、2或4时，该字段可选值如下： · 1：开启 · 0：关闭

返回参数

名称	类型	描述
log_id	string	操作记录id
result	dict	返回结果
status	int	状态码
success	bool	是否操作成功，说明： · true：成功 · false：失败

result说明

名称	类型	描述
id	string	prompt优化任务id