功能介紹
在AgentRun運行時中建立的Agent,支援被其他系統調用,將已開發好的 Agent 快速整合到前端網頁、後端服務等業務系統中
前提條件
-
已建立可用的 Agent (快速建立Agent(無代碼)/通過代碼建立Agent(高代碼))並完成發布;
-
為Agent配置了管理Serverless開發平台(Devs)的許可權(AliyunDevsFullAccess)。
操作步驟
進入整合與發佈頁面
-
進入AgentRun Runtime頁面;
-
在需要被整合的Agent卡片中,點擊详情;
-
在Agent詳情頁,選擇左側目錄的集成与发布,進入整合與發佈頁面。
此時可以在頁面中看到三種整合方式,按需選擇被整合方式,分別為:
UI整合:
-
支援一鍵產生前後端一體的 Agent 應用介面;
-
可以將該介面以 iframe、獨立網域名稱等形式嵌入到現有網頁或其他應用中;
-
適合快速提供“可視化對話介面”的情境(如內部工作台、門戶網站等)。
代碼整合:
-
提供標準的 HTTP API 介面(如相容 OpenAI Chat Completions 協議);
-
外部系統可以按標準協議API/SDK直接調用 Agent 的介面,適合多語言、多平台整合。
生態整合:
支援在Dify、n8n等平台整合Agent。
配置UI整合
-
選擇整合模板:通過整合模板,來指定UI整合方式與風格模板,選擇完成後,可以點擊預覽效果,查看當前配置的最終效果;
-
整合方式:全屏嵌入、浮窗聊天、側邊欄;
-
風格模板:簡約風格、商務風格、科技風格、溫馨風格。
-
-
開始整合:點擊開始整合後,需要指定整合的Agent對應版本的EndPoint,進行API綁定配置,配置完成後,單擊下一步;
-
等待部署完成:查看部署日誌,等待部署完成;
-
測試部署結果:部署成功後,會在頁面中顯示已部署的整合資源,並產生一個臨時的訪問地址,可以點擊訪問地址,進行Agent訪問和使用;
重要當前訪問地址是 CNCF SandBox 專案 Serverless Devs 社區所提供,僅供學習和測試使用,不可用於任何生產使用;社區會對該網域名稱進行不定期地撥測,並在網域名稱下發 1 天后進行回收,強烈建議您綁定自訂網域名以獲得更好的使用體驗。
-
綁定自訂網域名:點擊訪問地址右側的增加,可以選擇已有網域名稱或新增網域名稱進行正式網域名稱的綁定,自訂網域名配置可以參考配置自訂網域名。
代碼整合
按標準協議API/SDK直接調用 Agent 的介面,適合多語言、多平台整合,程式碼範例如下:
curl https://12**********.agentrun-data.ap-southeast-1.aliyuncs.com/agent-runtimes/agent-code-XVe7d/endpoints/Default/invocations/openai/v1/chat/completions -XPOST \
-H "content-type: application/json" \
-H "X-AgentRun-Session-ID: your-session-id" \
-d '{
"messages": [{"role": "user", "content": "Write a piece of code to query the current time."}],
"stream":true
}'
X-AgentRun-Session-ID header 用於實現會話親和功能。使用相同 Session ID 的請求會被路由到同一個 Agent 執行個體,適用於需要保持會話內容相關的情境。您可以使用任意唯一字串作為 Session ID(如 UUID)。