幫助中心
首頁 Alibaba Cloud Model Studio 使用者指南（應用） Prompt Prompt模板概述

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. 在参数配置介面分別輸入workspaceId和promptTemplateId。配置完成後，workspaceId和promptTemplateId將自動填滿至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版本和結構一致，避免因手動維護導致的不一致問題。

上一篇：Prompt下一篇：自訂Prompt模板