Function Compute：快速建立Agent（無代碼）

步驟1：進入建立頁面

1. 進入Agent運行時控制台，首次使用需要進行SLR授權，在彈出的提示框中點擊确认即可；

2. 在Agent 运行时頁面單擊建立Agent；

3. 選擇快速创建，即可進入可視化配置介面。

步驟2：選擇模型

為 Agent 指定一個名稱並選擇一個底層的語言模型

1. 輸入自訂的Agent名稱；

2. 選擇模型：在 選擇模型 地區，從 大語言模型 下拉式清單中選擇一個模型。

   • 快速開始：如果您是首次使用，可單擊 一鍵配置Qwen模型。系統將引導您使用阿里雲百鍊大模型服務的 API Key 快速部署一個預設模型（qwen-max）。您可以前往百鍊控制台免費開通服務並擷取 API Key。

   • 添加其他模型：單擊 添加模型，可參考模型管理進行添加。AgentRun 支援多種模型接入方式：

     • API 模型：通過 API 金鑰直接調用外部模型服務，如阿里雲百鍊、千問或第三方商業模型。此方式接入靈活，適用於已擁有外部模型 API Key 的情境。

     • 一鍵部署：將您自有的開源或自訓練模型，進行部署和託管。此方式能實現資料私人化和模型可控，適用於對模型有定製化需求的情境。

• 模型參數配置：調整模型的推理行為，配置推理模式、溫度、Token限制等參數；

  說明

  決策建議：溫度越低，模型回答越穩定、確定；溫度越高，回答越具創造性和多樣性。對於需要精確回答的情境，建議調低溫度（如 0.1-0.3）；對於創意性任務，可適當調高（如 0.7-0.9）。

  在快速建立模式下，為簡化配置，部分進階參數（如 top_k、seed 等）不可用。如需精細調參，將 Agent 轉為代碼方式建立Agent進行配置。

步驟3：編寫和最佳化提示詞

提示詞（Prompt）是您給 Agent 下達的指令，用於指導其如何行動、扮演什麼角色以及遵循哪些規則。

1. 系統提示詞編寫：定義 Agent 的核心職責和工作流程，可以直接使用系統預設的提示詞/Prompt，也可以在介面中自訂編寫；

2. 提示詞最佳化（可選）：在編寫提示詞後，建議使用AI Prompt助手，對提示詞的表達或結構進行調整，使其更清晰、更有效；

3. 配置提示詞變數：通過設定變數，使 Agent 能夠處理動態資訊。在提示詞中使用 {變數名} 的格式來定義變數，例如 {user_name}。

   樣本提示詞：

   ## 工作流程
   1. 理解客戶問題。
   2. 根據客戶 `{user_name}` 查詢其訂單資訊。
   3. 提供準確和有協助的回複。

步驟4：為Agent組態工具或沙箱

工具和沙箱可以擴充 Agent 的能力，使其能夠與外部世界互動或執行代碼，如：

• 通過配置網頁抓取工具，可以讓Agent能夠從網頁中搜尋和處理內容，並將HTML轉換為Markdown格式，以便於使用；

• 通過配置BrowserTool瀏覽器沙箱，可以讓Agent進行自動化測試和調試的瀏覽器執行個體；

• 通過配置Code Interpreter代碼解譯器沙箱，可以讓Agent在安全的沙箱環境中執行Python代碼、管理檔案系統、處理資料檔案等；

操作：

1. 建立工具和沙箱：如果當前沒有可用的工具，可以在資源配置>工具市場，搜尋需要的工具，點擊安裝按照控制台指引進行建立，也可以參考工具與Skills、Sandbox沙箱服務文檔進行工具和沙箱建立；

2. 選擇工具或沙箱

步驟5：配置訪問憑證

為 Agent 配置訪問入口的憑證（例如 API Key 等），用於保護您的 Agent，防止未經授權的調用。憑證由 AgentRun 的憑證管理統一管理和注入。

1. 在訪問憑證模組，點擊入站：訪問憑證

2. 選擇憑證模式：

   • 不使用憑證（不推薦）：Agent 的調用地址可被公網匿名訪問，存在安全風險。此模式僅適用於功能測試，嚴禁用於生產環境。

   • 使用已有憑證（推薦）：為了保障 Agent 安全，建議選擇此項。如果您還沒有憑證，可以選擇已有的憑證，可以點擊參考憑證管理進行建立。

步驟6：完成配置並測試

1. 完成上述步驟後，單擊右上方建立Agent，儲存配置並建立Agent；

2. 待建立完成後，可以在測試地區輸入測試資訊，與Agent進行互動，測試Agent功能；

步驟7：發布版本並進行灰階

AgentRun 支援版本管理與灰階發布。在對 Agent 的提示詞、工具或模型進行變更後，建議先 發布版本，然後通過 建立Endpoint 並 啟用次要版本（灰階發布），將一小部分 流量分配 給新版本。在監控確認新版本穩定可靠後，再逐步增加流量比例，最終完成全量上線。

1. 在左側目錄中選擇版本與灰階；

2. 發布目前的版本：點擊发布版本，並輸入版本描述，描述此版本主要變更和功能後，點擊发布版本；

3. 建立Endpoint：

   1. 輸入Endpoint名稱，主要版本下拉框中選擇上一步中發布的目前的版本號；

   2. 啟用次要版本（灰階發布）：勾選啟用次要版本（灰階發布），選擇次要版本，並為主要版本和次要版本配置流量分配百分比；

對比測試

可以使用對比測試功能對比不同模型、不同版本在同一輸入下的表現，測試結果將並排顯示，方便直觀對比並根據此調整模型、提示詞或工具配置。

1. 在左側目錄選擇配置與調試；

2. 點擊模型對比測試地區的對比測試按鈕；

3. 選擇測試類型和對比對象：

   • 模型測試：選擇不同的模型進行對比測試，查看不同模型的回答效果和效能差異；

   • Endpoint測試：選擇不同的Endpoint進行對比測試，查看不同提示詞、配置和工具的回答效果。

4. 選擇完成後，輸入同一問題將並排顯示測試結果，如：

轉換為代碼模式

當業務複雜度提升，需要更精細的邏輯時，可以將快速建立的Agent一鍵轉換為代碼模式，轉換後的代碼結構清晰，可在此基礎上進行二次開發，無需從零構建：

• 代碼編輯能力：可以直接編輯Agent的代碼實現，擁有更高的靈活性和控制力；

• 版本控制：支援代碼版本管理，可以追蹤每次修改的記錄。

操作：

1. 在Agent的配置與調試頁面右上方，點擊轉換為代碼模式；

2. 仔細閱讀提示資訊後，點擊轉換為代碼建立，如果您只是想查看該Agent的代碼詳情，可以點擊代碼預覽，將代碼下載到本地後，進行查看預覽。

   重要

   一旦轉換就不能再轉換回來，將失去可視化配置介面，需要參考通過代碼建立Agent（高代碼）通過代碼進行配置。

3. 等待轉換完成後，快速建立的Agent將由無代碼可視化介面配置轉換為高代碼模式。

在應用中整合Agent

在左側整合與發布模組參考Agent整合與發布文檔，將開發的 agent 快速整合到您的前端網頁、後端應用等，支援UI整合、代碼整合、生態整合三種方式。

運行時配置

資源配置

網路設定

網路模式：PUBLIC，允許預設網卡訪問公網。

Q1：快速建立的 Agent 是否可以直接用於生產環境？

A：

可以，但僅建議用於邏輯簡單、流量可控的情境。對於需要處理複雜商務程序或對高可用性有嚴格要求的生產環境，我們強烈建議您在完成原型驗證後，轉為高代碼模式以獲得更強的控制力、穩定性和可維護性。

Q2：快速建立的 Agent 的運行環境是什嗎？如何擴縮容？請求效能如何？

A：

Agent 運行在基於Function Compute（FC）的執行個體環境中。該環境會根據會話和請求量進行全自動的彈性擴縮容，您無需手動設定執行個體數量。冷啟動時間通常在毫秒級到秒級不等，具體效能受模型響應速度、工具調用耗時等多種因素影響。您可以在 Agent 的可观测性頁面查看詳細的效能指標。