Prompt模板概述

更新時間:
Copy as MD

在構建大語言模型應用時,為不同業務情境反覆構建和調整結構相似的 Prompt 耗時且難以維護。通過使用 Prompt 模板,可將 Prompt 的固定結構與動態變數分離,建立可複用的模板,以實現Prompt的統一管理和最佳化,高效產生Prompt。

重要

本文檔僅適用於國際版(新加坡地區)。

工作流程

  1. 建立模板:在阿里雲百鍊控制台或通過 API 建立並儲存模板,擷取唯一模板 ID。

  2. 擷取模板:通過 API 和模板 ID 拉模數板內容。

  3. 產生Prompt:將業務資料填入模板變數,產生最終的Prompt。

  4. 使用模板:將產生好的Prompt發送給目標模型以擷取結果。

模板類型

Prompt模板分為預置Prompt模板自訂Prompt模板

維度

預置Prompt模板

自訂Prompt模板

來源

由阿里雲百鍊提供,涵蓋了多個不同的業務情境。

通過控制台或API建立自訂模板

效果

已經過最佳化,效果穩定。

使用者自己設計和測試,效果取決於設計品質。

易用性

無需額外開發,直接通過控制台或API調用即可。

在實際使用中,可能需要多次迭代最佳化。因此,使用者需要掌握Prompt設計原則及最佳化方法(如清晰指令、樣本引導、格式約束),具備一定的開發和技術能力。

適用情境

  • 適用於通用情境,如創意文案、辦公助理等。

  • Prompt設計經驗不足。

  • 適用於複雜或特定業務需求的情境,例如金融風控、醫學諮詢。

  • 對輸出格式有嚴格要求,例如JSON、列表。

是否支援修改

不支援。

根據實際需求修改。

預置Prompt模板

1. 查看

訪問提示詞頁面,可查看和使用阿里雲百鍊提供的針對不同情境的預置Prompt模板。

每個 Prompt 模板以卡片形式展示,包含模板內容摘要和模板 ID。卡片底部提供 查看詳情複製 prompt 和更多操作(···)按鈕。

image

2. 查看與管理

查看:單擊模板卡片上的查看详情,查看模板的名稱、內容、變數、ID等資訊。

管理:

  • 單擊复制prompt,可以複製模板內容。

  • 單擊创建应用,模板內容將自動填滿到智能体应用的提示詞編輯框中。可直接使用或基於業務情境修改。

    填充後的提示詞中包含自訂變數 ${number}${content},用於產生小紅書風格文案。

    image

  • 單擊复制模板,會在提示詞頁面建立一個自訂Prompt模板:“預置Prompt模板名稱_副本_時間戳記”。

    複製後的模板卡片展示模板內容預覽和模板 ID(可單擊右側表徵圖複製),底部提供編輯複製 prompt及更多操作按鈕。

    image

自訂Prompt模板

1. 建立

您可以通過控制台API 兩種方式建立自訂Prompt模板。

控制台

  • 基於預置Prompt模板修改

    預置Prompt模板卡片上,單擊复制模板,將會建立一個自訂Prompt模板副本:“預置Prompt模板名稱_副本_時間戳記”。

  • 基於業務需求建立

    提示詞頁面,單擊创建提示词,完成相關配置後,單擊保存即可完成模板建立。在Prompt範本管理員頁面,可通過類型篩選(全部、文本產生、圖片產生)和搜尋方塊尋找已有模板。單擊右上方+ 建立提示詞按鈕建立Prompt模板。已建立的模板以卡片形式展示,包含模板標題、內容預覽和模板ID,支援編輯複製prompt操作。

API

  1. 擷取業務空間ID:擷取APP ID 和 Workspace ID

  2. 建立自訂Prompt模板:使用CreatePromptTemplate - 建立Prompt模板介面。

2. 查看與管理

查看:自訂Prompt模板建立完成後,可在提示詞頁面查看。

管理:

  • 單擊模板卡片上的编辑,可修改模板內容。

  • 單擊复制prompt,可以複製模板內容。

  • 單擊创建应用,模板內容將自動填滿到智能体应用的提示詞編輯框中。可直接使用或基於業務情境修改。

  • 單擊复制模板,會在當前頁面建立一個自訂Prompt模板:“自訂Prompt模板名稱_副本_時間戳記”。

  • 單擊删除,可刪除已建立的模板。

使用Prompt模板

控制台

  1. 單擊預置Prompt模板或自訂Prompt模板中的使用prompt > 创建应用,模板內容將自動填滿到智能體應用的提示詞中。

    填充後的提示詞輸入框中可見模板變數(如 ${name}),輸入框右下角顯示字元計數,最大支援 6144 個字元。

    image

  2. 為應用設定模型,輸入問題測試提示詞效果。

    在模型調試介面左側,選擇模型(如通義千問-Plus-Latest 128K)並在提示詞地區編寫系統指令;右側在使用者輸入區輸入測試問題後單擊執行,下方展示模型回複內容及輸入/輸出token統計資訊。

API

  1. 開啟擷取Prompt模板介面調用文檔,單擊调试

  2. 参数配置介面分別輸入 workspaceId 和 promptTemplateId。

    • workspaceId:即業務空間ID。擷取方法參見擷取APP ID 和 Workspace ID

    • promptTemplateId:即預置Prompt模板或自訂模板ID。在模板卡片上擷取模板Id即可。

  3. 單擊發起調用即可線上調試介面。

    {   // Schema of Response
      "variables": [   // 模板變數列表
        "platform",   // 模板變數
        "topic",   // 模板變數
        "num1",   // 模板變數
        "num2"   // 模板變數
      ],
      "promptTemplateId": "cfec40c311f14f3e976403059d8f0116",   // 模板Id
      "requestId": "8C616xxx",   // 請求Id
      "name": "營銷文案產生",   // 模板名稱
      "content": "你是一名在${platform}平台具有豐富經驗的專業爆款營銷文案策劃人,現在請以\"${topic}\"為核心主題,撰寫一段極具吸引力的${platform}營銷內容。要求內容包括:一個引人入勝且符合SEO最佳化原則的標題,以及一段詳細且富有情感煽動力的本文。在本文中,請至少插入${num1}不同的emoji表情,以增加內容的互動性和視覺吸引力。此外,請根據該主題,設計並提供最多${num2}熱門推薦標籤,這些標籤需具有高度概括主題和吸引目標使用者群體的特點。",   // 模板內容
    }

SDK

  1. 開啟擷取Prompt模板介面調用文檔,單擊调试

  2. 参数配置介面分別輸入workspaceIdpromptTemplateId。配置完成後,workspaceIdpromptTemplateId將自動填滿至SDK樣本中。

    • workspaceId:即業務空間ID。擷取方法參見擷取APP ID 和 Workspace ID

    • promptTemplateId:即預置Prompt模板或自訂Prompt模板ID。在模板卡片上擷取模板 Id 即可。

  3. 在調試介面中單擊SDK樣本。

  4. 線上運行樣本,或下載完整工程,設定 accessKeyId 和 accessKeySecret 後運行。

    擷取方法請參見擷取 AccessKey 與 AgentKey

    在 OpenAPI 調試頁面右側,單擊 SDK樣本 頁簽,選擇 SDK 代系 V2.0(推薦) 及目標語言(如 Java),即可查看對應的 SDK 範例程式碼。

錯誤碼

如果調用失敗並返回報錯資訊,請參見錯誤碼進行解決。

常見問題

Q: 調用GetPromptTemplate介面和直接在代碼中拼接字串有什麼區別?

A: 使用GetPromptTemplate介面管理Prompt的優勢如下:

  • 邏輯與內容分離:可在阿里雲百鍊控制台更新和最佳化Prompt內容,無需修改或重新部署應用程式代碼。

  • 集中管理與協作:所有Prompt集中儲存,便於團隊(如Prompt工程師和開發工程師)協作、版本管理和複用。

  • 一致性保障:保證在應用的不同部分或不同服務間使用的Prompt版本和結構一致,避免因手動維護導致的不一致問題。