在構建大語言模型應用時,為不同業務情境反覆構建和調整結構相似的 Prompt 耗時且難以維護。通過使用 Prompt 模板,可將 Prompt 的固定結構與動態變數分離,建立可複用的模板,以實現Prompt的統一管理和最佳化,高效產生Prompt。
本文檔僅適用於國際版(新加坡地區)。
工作流程
建立模板:在阿里雲百鍊控制台或通過 API 建立並儲存模板,擷取唯一模板 ID。
擷取模板:通過 API 和模板 ID 拉模數板內容。
產生Prompt:將業務資料填入模板變數,產生最終的Prompt。
使用模板:將產生好的Prompt發送給目標模型以擷取結果。
模板類型
Prompt模板分為預置Prompt模板和自訂Prompt模板。
維度 | 預置Prompt模板 | 自訂Prompt模板 |
來源 | 由阿里雲百鍊提供,涵蓋了多個不同的業務情境。 | |
效果 | 已經過最佳化,效果穩定。 | 使用者自己設計和測試,效果取決於設計品質。 |
易用性 | 無需額外開發,直接通過控制台或API調用即可。
| 在實際使用中,可能需要多次迭代最佳化。因此,使用者需要掌握Prompt設計原則及最佳化方法(如清晰指令、樣本引導、格式約束),具備一定的開發和技術能力。 |
適用情境 |
|
|
是否支援修改 | 不支援。 | 根據實際需求修改。 |
預置Prompt模板
1. 查看
訪問提示詞頁面,可查看和使用阿里雲百鍊提供的針對不同情境的預置Prompt模板。

2. 查看與管理
查看:單擊模板卡片上的查看詳情,查看模板的名稱、內容、變數、ID等資訊。
管理:
單擊,可以複製模板內容。
單擊,模板內容將自動填滿到智能體應用的提示詞編輯框中。可直接使用或基於業務情境修改。

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

自訂Prompt模板
1. 建立
您可以通過控制台或 API 兩種方式建立自訂Prompt模板。
控制台
基於預置Prompt模板修改
在預置Prompt模板卡片上,單擊,將會建立一個自訂Prompt模板副本:“預置Prompt模板名稱_副本_時間戳記”。
基於業務需求建立
在提示詞頁面,單擊建立提示詞,完成相關配置後,單擊儲存即可完成模板建立。

API
擷取業務空間ID:擷取APP ID 和 Workspace ID。
建立自訂Prompt模板:使用CreatePromptTemplate - 建立Prompt模板介面。
2. 查看與管理
查看:自訂Prompt模板建立完成後,可在提示詞頁面查看。
管理:
單擊模板卡片上的編輯,可修改模板內容。
單擊,可以複製模板內容。
單擊,模板內容將自動填滿到智能體應用的提示詞編輯框中。可直接使用或基於業務情境修改。
單擊,會在當前頁面建立一個自訂Prompt模板:“自訂Prompt模板名稱_副本_時間戳記”。
單擊,可刪除已建立的模板。
使用Prompt模板
控制台
單擊預置Prompt模板或自訂Prompt模板中的,模板內容將自動填滿到智能體應用的提示詞中。

為應用設定模型,輸入問題測試提示詞效果。
API
開啟GetPromptTemplate - 擷取Prompt模板介面調用文檔,單擊調試。
在參數配置介面分別輸入 workspaceId 和 promptTemplateId。
workspaceId:即業務空間ID。擷取方法參見擷取APP ID 和 Workspace ID。
promptTemplateId:即預置Prompt模板或自訂模板ID。在模板卡片上擷取模板Id即可。
單擊發起調用即可線上調試介面。
SDK
開啟GetPromptTemplate - 擷取Prompt模板介面調用文檔,單擊調試。
在參數配置介面分別輸入workspaceId和promptTemplateId。配置完成後,workspaceId和promptTemplateId將自動填滿至SDK樣本中。
workspaceId:即業務空間ID。擷取方法參見擷取APP ID 和 Workspace ID。
promptTemplateId:即預置Prompt模板或自訂Prompt模板ID。在模板卡片上擷取模板 Id 即可。
在調試介面中單擊SDK樣本。
線上運行樣本,或下載完整工程,設定 accessKeyId 和 accessKeySecret 後運行。
擷取方法請參見擷取 AccessKey 與 AgentKey。
錯誤碼
如果調用失敗並返回報錯資訊,請參見錯誤資訊進行解決。
常見問題
Q: 調用GetPromptTemplate介面和直接在代碼中拼接字串有什麼區別?
A: 使用GetPromptTemplate介面管理Prompt的優勢如下:
邏輯與內容分離:可在阿里雲百鍊控制台更新和最佳化Prompt內容,無需修改或重新部署應用程式代碼。
集中管理與協作:所有Prompt集中儲存,便於團隊(如Prompt工程師和開發工程師)協作、版本管理和複用。
一致性保障:保證在應用的不同部分或不同服務間使用的Prompt版本和結構一致,避免因手動維護導致的不一致問題。