全部產品
Search
文件中心

Agent Run:低代碼建立Agent快速入門

更新時間:Sep 19, 2026

低代碼 Agent 建立功能提供所見即所得 (WYSIWYG)的流程畫布,通過拖拽節點、串連流程即可完成 Agent 配置,大幅降低開發門檻。

重要

低代碼建立 Agent 功能已進入維護期,不再演化。建議新使用者停止建立新的 Agent,已有使用者可繼續使用,後續會提供升級方案。

工作原理

低代碼 Agent 建立基於流程畫布(Flow)模式,採用可視化編排方式構建 Agent 工作流程。流程畫布支援多種節點類型,包括開始節點、LLM 節點、MCP服務節點、代碼執行節點等。通過串連節點構建完整的工作流程,系統會自動將畫布配置轉換為可執行檔流程定義。流程支援交談模式和工作流程模式兩種執行方式。

主要能力包括:

  • 模型編排:支援千問系列及 OpenAI 相容模型

  • 工具支援:支援編排基於 OpenAPI 規範和 MCP 協議的工具

  • Agent 編排:支援編排 agentrun agent 及內建的 function calling agent

  • 知識庫整合:支援對接百鍊知識庫

  • 自訂代碼執行:內建代碼執行節點,同時支援編排Function Compute節點

  • 完備的流程式控制制結構:分支、迴圈、迭代、並行

  • 多用戶端協議整合:OpenAI、dify workflow、dify chatflow

  • 版本管理與灰階發布:便於在逐步最佳化的過程中控制上線範圍

核心概念

在使用Flow建立 Agent 前,建議先瞭解如下核心概念,如已經提前瞭解,可以直接進入Agent建立:

核心概念

說明

模型

Agent 可以直接使用在 AgentRun 平台配置的千問及 OpenAI 協議相容的模型,包括:

  • API 直連模型:通過標準 API 接入的第三方大模型;

  • FunModel 託管模型:託管在 AgentRun / Function Compute環境中的自建或開源模型;

  • LiteLLM 模型治理:通過 LiteLLM 方式接入並治理的模型服務。

Agent

使用Flow建立的 Agent 支援在流程 Agent 節點中添加在AgentRun平台通過其他方式建立的Agent:

交談模式/工作流程模式

  • 交談模式下支援會話變數概念,同時支援為流程執行傳入 conversation id,相同 conversation id 的流程可以共用工作階段變數的訪問。

  • 工作流程模式在執行時不指定 sys.conversation_id,適用於無需在多次執行間共用工作階段變數的情境。

環境變數

使用環境變數來儲存您的應用特定的敏感資訊,如 API 金鑰、資料庫密鑰等。支援在流程維度配置環境變數,流程中的節點可以訪問流程的環境變數。

版本與灰階

快速建立的 Agent 支援版本管理與灰階發布:

  • 可以為 Agent 建立多個版本,每個版本對應一組模型、提示詞、工具等配置;

  • 可以按一定比例或策略將請求流量灰階路由到新版本,用於逐步驗證新配置的穩定性和效果。

適用範圍

使用低代碼 Agent 建立功能需要具備以下許可權:

權限原則

說明

AliyunFCInvocationAccess

流程中調用函數節點需要此許可權

AliyunFCFunctionAIReadOnlyAccess

流程中調用 MCP、工具需要此許可權

AliyunBailianDataFullAccess

流程中調用百鍊知識檢索需要此許可權

AliyunAgentRunReadOnlyAccess

流程中調用 agentrun agent 需要此許可權

AliyunEventBridgePutEventsPolicy

流程中調用 EventBridge 需要此許可權(功能目前不支援,未來可能開放)

AliyunFnFFullAccess

流程中調用其他流程需要此許可權(功能目前不支援,未來可能開放)

前置條件:

  • 確保已配置模型。在模型管理頁面配置千問或 OpenAI 相容模型。當前支援千問和 OpenAI 模型。

通過Flow建立Agent

通過流程畫布建立 Agent,配置模型、工具等節點,完成一個可啟動並執行 Agent。

操作步驟

  1. 登入AgentRun 控制台,在Agent 運行時頁面點擊建立Agent。

  2. 選擇通過Flow建立,進入 Flow Agent 建立頁面。

  3. 配置基本資料:

    • Flow名稱:輸入有意義的名稱,便於後續管理和識別(如:agent-flow-0RUvK)

    • 功能描述(可選):詳細描述 Flow 的功能、用途和特點

  4. 配置執行角色:

    • 從下拉式清單中選擇執行角色(如:AliyunFnFExecutionRole)

    • 如果角色缺少權限原則,點擊一鍵授權完成授權

    • 執行角色用於授予工作流程服務訪問其他阿里雲服務的許可權,需要以下許可權:AliyunFCInvocationAccess、AliyunFCFunctionAIReadOnlyAccess、AliyunFnFFullAccess、AliyunAgentRunReadOnlyAccess、AliyunEventBridgePutEventsPolicy、AliyunBailianDataFullAccess

  5. 配置訪問憑證:

    • 入站:訪問憑證:選擇匿名訪問或添加憑證(推薦使用憑證以保障安全)

  6. 點擊下一步,進入流程畫布頁面。

  7. 在流程畫布中配置流程:

    • 畫布預設包含開始節點和結束節點

    • 在開始與結束節點之間依次添加 LLM 節點(模型選擇 qwen3-max)和流式回複節點,各節點通過連線依次串聯形成完整工作流程。

    • 點擊開始節點,在右側配置面板的下一步地區添加節點

    • 或直接在畫布上右鍵點擊,選擇 添加節點,然後選擇節點類型

  8. 配置節點:

    • 點擊節點開啟配置面板

    • 對於 LLM 節點:

      • 選擇模型:點擊模型選擇地區,從下拉式清單中選擇已配置的模型(如:qwen3-model 的 qwen3-max),並配置模型其他參數(如溫度、最大標記等,可選)

      • 配置提示詞:在 SYSTEM 訊息中編寫提示詞,在USER中配置參數(必填)

    • 對於流式回複節點:配置流式回複相關參數

    • 串連節點:確保開始節點串連到中間節點,中間節點串連到結束節點

  9. 點擊建立Agent,等待建立完成。

建立成功後,頁面顯示Flow 建立成功提示,並跳轉到 Agent 詳情頁。

測試回合

在 Agent 詳情頁,使用測試回合功能驗證 Agent 是否正常工作。

  1. 在畫布工具列點擊測試回合按鈕。

  2. 在測試回合面板中:

    • 選擇執行模式:工作流程模式或交談模式

    • 填寫輸入參數:

      • sys.query(選填):輸入測試問題,如"你好,請介紹一下你自己"

      • sys.conversation_id(選填):會話 ID,用於會話變數共用

      • sys.user_id(選填):使用者識別碼

  3. 點擊開始運行,等待運行完成。

  4. 查看運行結果

發布版本

為 Agent 發布版本,用於版本管理和灰階發布。

只有流程有新的變更的情況下才能發布新的版本。

操作步驟

  1. 在 Agent 詳情頁,點擊左側導覽列的版本與灰階。

  2. 在版本管理地區,點擊發布版本。

  3. 填寫版本描述(可選),如"初始版本,包含基本的 LLM 對話流程"。

  4. 點擊發布版本,等待發布完成。

發布成功後,版本列表中顯示新發布的版本,包含版本號碼、描述和發布時間。

通過 API 呼叫

使用 curl 命令調用 API,您可以在Agent詳情頁裡的頁面查看相關調用樣本。

發布為聊天框

將 Agent 發布為聊天框,提供 Web 介面供使用者互動。

操作步驟

  1. 在 Agent 詳情頁,點擊左側導覽列的整合與發布。

  2. 在整合模板地區,選擇整合方式和風格模板:

    • 整合方式:全屏嵌入、浮窗聊天、側邊欄、自訂

    • 風格模板:簡約風格、商務風格、科技風格、溫馨風格

  3. 點擊開始整合,開啟 API 綁定配置對話方塊。

  4. 配置 API 綁定:

    • 選擇執行角色(如:AliyunAgentRunDefaultRole)

    • 選擇 Endpoint(如:Default (ACTIVE))

    • 點擊下一步

  5. 等待整合資源部署完成。

部署完成後,頁面顯示部署完成! 提示。可以在已部署的整合資源 地區查看聊天框 URL。

查看流程 trace

查看 Agent 流程執行的 trace 資訊,用於調試和監控。

操作步驟

  1. 在 Agent 詳情頁,點擊左側導覽列的可觀測性。

  2. 查看流程執行記錄和 trace 資訊:

    • 基礎監控:查看執行次數、執行耗時、執行錯誤次數、LLM 調用次數、Token 使用方式、執行成功率等統計資訊

    • LLM 監控:查看 LLM 調用相關的監控資訊

    • 鏈路追蹤:查看詳細的執行鏈路資訊(需要先開啟鏈路追蹤功能)

基礎監控頁面顯示的資訊包括:

  • 執行次數

  • 執行耗時平均值(毫秒)

  • 執行耗時最大值(毫秒)

  • 執行錯誤次數

  • LLM 調用次數

  • Token 輸入

  • Token輸出

  • 執行成功率

  • 節點執行總耗時(毫秒)