Function Compute：通過代碼建立Agent（高代碼）

步驟1：進入代碼建立Agent頁面

1. 進入AgentRun運行時與沙箱頁面。

2. 單擊建立Agent，在彈出的視窗中選擇通過代碼建立。

3. 輸入Agent名稱和功能描述，建議使用有意義的名稱，便於後續管理和識別。

步驟2：代碼配置

1. 選擇代碼來源

   上傳程式碼封裝

   1. 單擊上傳檔案，選擇本地 zip 檔案。

   2. 確保包內結構符合運行時規範（入口檔案位置、依賴目錄等）。

   3. 如基於官方樣本，可先下載模板，填入必要配置（如 system_prompt），再打包上傳。

      說明

      範例程式碼中的 MODEL_NAME 和 SANDBOX_NAME 會從運行時環境變數中讀取，此處無需修改。

   從OSS擷取程式碼封裝

   1. 在代碼來源中選擇OSS Object Storage Service。

   2. 選擇程式碼封裝所在的Bucket名稱和OSS目錄。

   3. 確保執行角色具備讀取該 OSS 對象的許可權。

   使用容器鏡像部署

   1. 在代碼來源中選擇容器鏡像。

   2. 選擇鏡像執行個體與鏡像倉庫。

      說明

      • 支援自訂鏡像、阿里雲Container Registry（個人版/企業版）。

      • 選擇自訂鏡像時，可直接配置自訂鏡像地址。

   3. 選擇鏡像版本。

   線上編寫和調試代碼

   選擇線上編碼方式，系統將在線上代碼編輯器中自動載入官方範例程式碼，可直接進行代碼商務邏輯實現和修改。

2. 啟動配置

   上傳程式碼封裝/OSSObject Storage Service/線上編輯模式

   • 啟動命令，例如：

     • python3 main.py

     • node app.js

     • java -jar app.jar

   • 啟動連接埠，如 9000，需與代碼中服務監聽連接埠一致。

   說明

   使用官方模板（如上述 Python 樣本）時，一般保持預設配置即可。

   容器鏡像模式

   • 啟動命令通常由鏡像內 Dockerfile 的 CMD/ENTRYPOINT 決定。

   • 需要指定啟動連接埠，與容器內應用監聽連接埠一致。

步驟3：資源配置、環境變數與進階配置

在資源配置和進階配置中設定運行參數。

1. 計算資源

   • CPU（核）與記憶體：為每個 Agent 執行個體分配的計算資源。資源越多，處理複雜任務的速度越快，但成本也相應增加。

   • 單一實例並發會話數上限：單個 Agent 執行個體能同時處理的會話數量上限。提高此值可減少所需執行個體數，從而節約成本，但需確保代碼安全執行緒且單個執行個體的 CPU 和記憶體資源充足。

   • 會話空閑逾時時間（秒）：執行個體上最後一個會話結束後，空閑超過該時間即自動釋放執行個體。

2. 環境變數

   為 Agent 配置運行時環境變數，用於向代碼傳遞參數。使用官方樣本時，需配置以下環境變數：

   • MODEL_NAME：必選，填寫模型管理中已建立的模型名稱。

   • SANDBOX_NAME：可選，填寫已建立的 Sandbox 名稱。

3. 網路設定

   • 允許訪問VPC：Agent 需要訪問 VPC 內的雲資源（如 RDS、OSS 等）時開啟。

   • 允許預設網卡訪問公網。

4. 日誌配置

   開啟日誌功能，可將 Agent 的作業記錄儲存在Log Service中。可指定記錄項目（Project）與日誌庫（Logstore），也可選擇自動設定或自訂配置中的一鍵配置功能使用預設值。

5. 健全狀態檢查配置

   啟用健全狀態檢查後，可配置檢查路徑（如 /health）、檢查間隔（秒）、逾時時間（秒）和失敗閾值。系統將定期向指定路徑發送 HTTP 要求檢查服務狀態，連續失敗達到閾值時自動重啟服務執行個體，有助於提高服務可用性和自動故障恢複能力。

步驟4：按需配置執行角色

執行角色用於授予 Agent 代碼訪問其他雲資源（如模型服務、OSS）的許可權。AgentRun 通過執行角色（RAM 角色）系統管理權限，代碼在運行時將扮演此角色以獲得相應的操作許可權。

授權主體：Function Compute服務（fc.aliyuncs.com）

要求的權限：根據實際使用的服務添加相應策略

在執行角色ARN中選擇已有角色。如果沒有符合要求的角色，可參考以下步驟建立。

1. 單擊執行角色ARN下拉框右側的添加按鈕，進入RAM存取控制 > 角色列表。

2. 單擊建立角色。

3. 在建立角色頁面，信任主體類型選擇雲端服務。

4. 信任主體名稱選擇Function Compute/FC。

5. 單擊確定，輸入角色名稱，再次單擊確定，並按照提示完成安全驗證。

6. 建立成功後進入角色詳情頁，單擊新增授權。

7. 根據實際使用的服務添加相應策略，常用策略樣本：

   • AliyunOSSFullAccess：Agent 需要使用 OSS 中的資源時，需設定物件儲存服務（OSS）系統管理權限。

   • AliyunAgentRunFullAccess：使用官方樣本建立時必須配置 AgentRun 服務系統管理權限。

   • AliyunDevsFullAccess：Serverless 開發平台（Devs）系統管理權限。

步驟5：配置訪問憑證

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

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

2. 選擇憑證模式：

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

   • 使用已有憑證（推薦）：為保障 Agent 安全，建議選擇此項。如果尚未建立憑證，可單擊參考憑證管理進行建立。

步驟6：完成配置並測試

完成上述配置後，單擊右上方開始部署完成建立。系統將自動跳轉至 Agent 詳情頁，選擇代碼與調試，在調試工具中進行測試。

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

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

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

2. 發布目前的版本：單擊發布版本，輸入版本描述說明主要變更和功能後，再次單擊發布版本。

3. 建立Endpoint：

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

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