GenAI 與雲端科技專區

使用 GitHub Actions 在 Amazon Bedrock AgentCore 部署 AI Agents

Published by
藍骨

隨着 Amazon Bedrock AgentCore 推出企業現在可以在一個框架無關(framework-agnostic)、具備自動擴展與內建安全機制的環境中部署與運行 AI 代理,AgentCore Runtime 作為核心運行環境提供安全、無伺服器(serverless)且專為代理設計的執行基礎設施,支援 LangGraph、Strands、CrewAI 等主流框架並可連接 Amazon Bedrock 或其他模型來源。開發團隊配合 GitHub Actions 建立 CI/CD 管線能將 AI 代理部署流程自動化,從程式碼提交到容器建置、安全掃描、部署與測試全程以企業級標準執行,大幅降低人工作業與安全風險。

 

為何選擇 AgentCore Runtime?

AgentCore Runtime 專為生產環境代理部署而設計,它支援多種大型語言模型例如 Amazon Bedrock 提供的基礎模型與 Anthropic Claude。 每個使用者會話會在獨立 microVM 中執行以確保 CPU、記憶體與檔案系統層面隔離,藉此強化多租戶安全性。系統亦支援即時互動與最長可達 8 小時的長時間工作負載,並內建驗證與可觀察性能力以迎合企業級應用場景。

 

解決方案架構與流程

整體 CI/CD 架構以 GitHub Actions 作為流程編排核心並結合多項 AWS 服務,形成完整自動化部署機制。 當開發者將程式碼提交至 GitHub 儲存庫後便會觸發工作流程(可設為手動或自動)。GitHub 透過 OpenID Connect(OIDC)與 AWS 建立信任關係,以無需長期憑證方式安全存取 AWS 資源。GitHub Actions 隨後會根據 Dockerfile 建置容器映像檔並推送至 Amazon ECR。Amazon Inspector 在映像檔上傳後會自動進行漏洞掃描以確保容器安全。AgentCore Runtime 最後使用該容器映像建立代理執行實例,並可進一步呼叫 Amazon Bedrock 模型與相關工具。這種流程將驗證、建置、安全掃描與部署整合為單一標準化管線,使代理開發與營運更具一致性與可控性。

 

儲存庫結構與代理實作

 

 

官方範例儲存庫提供完整專案架構當中包括代理程式碼、部署腳本與 GitHub Actions 工作流程設定,代理程式使用 Strands 框架與 BedrockAgentCoreApp 建立標準化應用容器。系統透過 @app.entrypoint 裝飾器標記主函式,當 AgentCore 收到 API 呼叫時便會自動將請求傳入該函式處理。範例代理整合 Claude Sonnet 模型與計算工具(calculator),並可選擇載入 Bedrock Guardrail 以進行內容過濾。當使用者透過 API 呼叫代理時 Runtime 會將包含 prompt 的 payload 傳入函式,代理再根據模型推理與工具選擇回傳結果。這種設計將代理邏輯與執行環境解耦,使開發者專注於業務邏輯而非基礎設施管理。

 

安全機制與 IAM 設計

這套方案在身份驗證方面透過 IAM OIDC Identity Provider 建立 GitHub 與 AWS 間的信任關係避免將 AWS 長期憑證存放於 GitHub Secrets, 這種「無金鑰」模式符合現代 DevSecOps 最佳實踐。AgentCore Runtime 需配置專用 IAM 執行角色並包含兩部分政策。第一是信任政策(Trust Policy)允許 bedrock-agentcore.amazonaws.com 服務在特定帳戶與來源 ARN 條件下 Assume Role。第二是執行角色權限授予 Bedrock 模型呼叫權限、ECR 映像拉取權限以及 CloudWatch Logs 寫入權限。此設計遵循最小權限原則(Least Privilege)僅開放必要資源。容器建置亦採用 SHA256 固定版本基礎映像、非 root 使用者執行以及 ECR 強化掃描功能,進一步提升安全性。

 

CI/CD 管線階段

 

 

整個部署流程通常分為四個階段,首先是驗證階段進行程式碼格式檢查、Linting 與相依套件驗證。接着是部署階段以完成 OIDC 驗證、IAM 角色設定、跨平台容器建置與 AgentCore 部署。第三階段為測試會透過獨立工作流程驗證代理回應與整合測試。最後是清理階段會刪除舊版 ECR 映像並保留最近數個版本,以控制儲存成本。AgentCore 同時亦支援自動版本管理與端點配置,使團隊可安全地管理多版本代理與環境分離。

 

企業部署優勢

這套 CI/CD 方案提供多項企業級優勢,首先它將基礎設施與部署細節抽象化使開發者專注於代理能力與業務邏輯。其次方案整合自動漏洞掃描與程式碼品質檢查以強化安全合規。企業再透過標準化流程與版本管理可在多團隊、多代理情境下維持一致性與可追蹤性。隨着生成式 AI 逐步成為企業核心能力,部署與營運效率同樣關鍵。企業透過 GitHub Actions 與 AgentCore Runtime 整合可建立安全、自動化且可擴展的 AI 代理交付流程,為大規模生成式 AI 應用奠定穩固基礎。

Published by
藍骨