概述
Prompt 管理 是 AI Registry（AI 治理中心）面向 AI 應用開發人員提供的核心能力之一，為 Prompt 提供統一的註冊、版本管理、調試、發布與治理能力。
通過 Prompt 管理，您可以：
將散落在代碼和配置中的 Prompt 集中託管，告別"改一次發一次"的發版流程。
通過多版本管理 + 標籤映射，實現 Prompt 的灰階發布和一鍵復原。
在控制台直接調試 Prompt，快速驗證效果。
藉助 AI 輔助最佳化能力，降低 Prompt 工程門檻。
本文檔指引您如何在 AI Registry 控制台完成 Prompt 的全生命週期管理操作。
前提條件
您已擁有阿里雲帳號，並已開通 AI Registry 服務。
您已建立至少一個工作空間。如尚未建立，請參考AI 治理中心工作空間管理指南。
當前帳號擁有 Prompt 相關操作許可權。如需為 RAM 子帳號授權，請參考 AI 治理中心 RAM 許可權配置指南。
一、核心概念
在開始操作前，先瞭解幾個關鍵概念：
概念 | 說明 |
Prompt | Prompt 資源實體，由 |
版本（Version） | Prompt 在不同時間點的快照，每個版本包含模板內容、變數定義和提交說明 |
草稿（Draft） | 未提交發布的版本，可隨時修改 |
線上（Online） | 發行的版本，可被用戶端拉取使用 |
標籤（Label） | 可移動的版本別名，如 |
二、進入 Prompt 管理頁面
登入 AI Registry 控制台。
在左側導覽列選擇Prompt，進入 Prompt 管理頁。
在Prompt 管理頁上方選擇工作空间，進入對應工作空间的 Prompt 列表頁。
三、建立 Prompt
操作步驟
在 Prompt 列表頁，點擊新建 Prompt。
在彈出的建立面板中，填寫以下配置項：
配置項 | 說明 | 是否必填 |
Prompt 名称 | 可讀性更好的展示名稱 | 是 |
Prompt 描述 | Prompt 用途的簡要說明 | 否 |
Prompt 内容 | 請輸入 Prompt 內容 | 是 |
标签 | 自訂業務標籤，用於分類和過濾 | 否 |
點擊立即创建完成建立。
建立成功後，系統會自動為該 Prompt 初始化一個 版本號碼為 0.0.1 的草稿版本，您可以直接進入草稿編輯頁面完善模板內容。
四、編輯 Prompt 草稿
草稿是 Prompt 版本的初始狀態，可以隨時修改，直到提交審核或發布。
操作步驟
在 Prompt 列表頁中，找到目標 Prompt，點擊详情。
點擊編輯草稿，進入其草稿版本編輯頁。
在編輯頁中，可以編輯以下內容：
編輯項 | 說明 |
Prompt 内容 | Prompt 模板本文，支援使用 |
变更说明 | 本次變更說明，便於版本追溯 |
編輯過程中可以點擊保存草稿保留修改，不會影響發行的線上版本。
變數詳解
變數（Variables）是 Prompt 模板中的動態預留位置，用於在運行時注入具體的業務資料，使同一個 Prompt 模板能夠複用於多種情境。
1. 變數文法
在模板內容中，使用雙大括弧 {{變數名}} 聲明一個變數預留位置。例如：
你是一個{{role}}，請用{{language}}回答以下問題：
{{question}}渲染時，用戶端傳入 role=客服專員、language=中文、question=如何退款？，最終發送給模型的 Prompt 為：
你是一個客服專員，請用中文回答以下問題：
如何退款？2. 變數命名規範
僅支援英文字母、數字和底線，且必須以字母開頭（如
userName、order_id）。區分大小寫，
{{Name}}與{{name}}是兩個不同的變數。建議使用小駝峰或底線命名，保持全域風格一致。
變數名不可與系統保留字衝突（如
system、context等）。
3. 變數定義欄位
在變數定義地區，每個變數包含以下屬性：
欄位 | 說明 | 是否必填 |
變數名（Name） | 與模板中 | 是 |
預設值（Default） | 用戶端未傳入該變數時使用的兜底值 | 否 |
描述（Description） | 對變數用途、取值範圍的說明，便於其他開發人員理解和正確使用 | 否 |
4. 變數自動識別
編輯模板內容時，系統會自動掃描 {{變數名}} 預留位置並在「變數定義」地區同步產生對應的變數條目，無需手動添加。您只需補充預設值、描述等附加資訊。
若模板中刪除了某個預留位置，對應的變數定義也會提示您確認是否移除，避免出現"定義了但未使用"或"使用了但未定義"的情況。
5. 最佳實務
變數粒度適中：避免將整段商務邏輯塞進一個變數，也不要把一句話拆成多個變數，以語義完整的最小單元為宜。
為變數填寫描述：清晰的描述能顯著降低其他開發人員的理解成本，也是 Prompt 智能最佳化時的重要上下文。
關鍵變數務必傳入：對於關鍵變數（如使用者身份、訂單號）用戶端應顯式傳入，避免依賴預設值導致線上出現"預設值兜底"的問題。
調試時覆蓋多種取值：在發布前通過調試面板用不同變數值測試 Prompt 行為，重點覆蓋空值、邊界值和異常值情境。
五、調試 Prompt
在發布前，您可以在控制台直接調試 Prompt，即時查看模型輸出效果。
操作步驟
在 Prompt 草稿編輯頁或版本詳情頁，點擊调试按鈕，進入調試面板。
在 Prompt 內容編輯框中動態調整 Prompt 內容。
在調試面板中，配置以下調試參數：
參數 | 說明 |
Prompt 版本 | 版本號碼 |
模型服务 | 從支援的模型列表中選擇調試使用的模型 |
Max Tokens | 產生的最大 token 數 |
TopP | 控制採樣範圍的參數，取值範圍 0~1 |
Temperature | 控制輸出隨機性的參數，取值範圍通常為 0~2 |
填寫用户输入，點擊生成回答，系統將以 SSE 流式輸出 方式返回模型響應結果。
六、Prompt 智能最佳化
如果您對 Prompt 的效果不滿意，可以使用內建的 AI 輔助最佳化能力對 Prompt 進行自動最佳化。
操作步驟
在 Prompt 草稿編輯頁，點擊Prompt 智能优化按鈕。
在彈出的面板中，可以填寫优化需求（选填）（如"讓輸出更簡潔"、"增加情感化表達"等）。
點擊开始优化，系統將以流式方式返回最佳化後的 Prompt 內容。您可以選擇採納最佳化結果，或保留原始內容。
七、提交發布
草稿完成後，通過提交發布流程讓該版本上線，用戶端即可拉取使用。
發布流程
AI Registry 目前支援以下發布路徑：
直接發布：無需審核，草稿直接變為線上版本。
後續會支援發布審核：
提交審核 → 發布上線：適用於需要審核流程的企業情境。
操作步驟
在Prompt詳情頁，點擊发布版本按鈕。
發布成功後，該版本變為已发布 狀態，用戶端即可通過版本號碼或標籤拉取到該版本。
八、版本管理
查看版本列表
進入 Prompt 詳情頁，可以查看該 Prompt 的所有版本：
列名 | 說明 |
版本號碼 | 發布時填寫的語義化版本號碼 |
狀態 | 草稿（Draft）/ 審核中（Reviewing）/ 發行（Online） |
版本标签 | 當前指向本版本的標籤，如 |
九、標籤映射管理
標籤（Label）是 可移動的版本別名，常見用法：
latest：指向最新發行版本，便於用戶端始終拉取最新內容。stable：指向經過驗證的穩定版本，用於生產環境。自訂標籤（如
experiment、canary）：用於灰階、AB 測試等情境。
操作步驟
進入 Prompt 詳情頁，切換到特定版本，點擊版本標籤的編輯按鈕。
對這個版本的標籤進行編輯，包括刪除，新增，標籤切換等操作。
儲存後，該標籤將立即指向指定版本。用戶端通過標籤拉取時，會擷取到映射的版本內容。
十、用戶端接入
Prompt 發布上線後，用戶端可通過以下方式拉取使用：
通過版本號碼拉取：
namespaceId + promptKey + version，擷取固定版本內容。通過標籤拉取：
namespaceId + promptKey + label（如stable），擷取標籤指向的版本內容。
用戶端接入前，請確保：
已根據應用部署位置選擇並完成網路接入配置：
本地開發、IDC 或未部署在阿里雲 VPC 內的應用，請參考 AI 治理中心公網訪問配置指南（待補協助中心 URL） 配置公網存取點和 IP 白名單。
部署在阿里雲 VPC 內的應用，請參考AI 治理中心 VPC 私網訪問配置指南配置私網訪問。
已為訪問帳號或 RAM 角色配置。
常見問題
Q：Prompt Key 可以修改嗎？
A：不可以。Prompt Key 作為唯一業務標識在建立後不可修改，如需變更請建立 Prompt 並逐步遷移用戶端引用。
Q：發行的線上版本可以刪除嗎？
A：為保障用戶端運行穩定，線上版本不允許直接刪除。如需下線，建議通過發布新版本覆蓋，或聯絡支援人員協助處理。
Q：用戶端如何?無感切換新版本？
A：推薦使用標籤映射。用戶端固定拉取 stable 標籤，發布新版本後在控制台將 stable 標籤指向新版本，即可實現用戶端無感切換。出現問題時，將標籤切回舊版本即可一鍵復原。
Q：一個 Prompt 最多可以有多少個版本？
A：版本數量無硬性上限，但建議及時清理不再使用的草稿版本，以保持版本列表的可讀性。