View a markdown version of this page

將繫帶匯出至程式碼 - Amazon Bedrock AgentCore
何時使用匯出目前支援的內容CLI 用量EXPORT_NOTES.md部署選項

將繫帶匯出至程式碼

匯出工具到程式碼會採用受管工具組態，並使用 Strands 架構產生對等代理程式做為可編輯的 Python 原始程式碼。產生的代理程式是正常的 AgentCore 執行期代理程式：您擁有程式碼、可以自由修改，以及像任何其他代理程式一樣進行部署。產生的代理程式會鏡像繫帶的模型、工具、技能、記憶體、執行限制和檔案系統掛載。

何時使用匯出

當您有工作範圍並想要：

  • 超出繫帶組態允許的自訂 - 新增自訂工具邏輯、變更代理程式迴圈、注入中介軟體/掛鉤，或整合繫帶未公開的程式庫

  • 擁有程式碼 - 從宣告式組態移至您控制、檢閱的原始程式碼，以及像其他應用程式一樣的版本。

  • 研究原型 - 從繫帶快速開始，然後在您準備好投資手動維護的代理程式時匯出。

如果繫帶組態已執行您所需的一切，您不需要匯出 - 繼續將其作為繫帶執行。

目前支援的內容

  • 架構 - 字串，以及即將推出的其他架構，例如 Claude Agents SDK

  • 語言 - 僅限 Python

  • 組建類型 - CodeZip （預設） 和 Container

繫結至產生的代理程式的功能：

  • 模型提供者和組態 (Bedrock、OpenAI、Gemini - 包括模型 ID 和 API 金鑰參考）

  • 工具 - 遠端 MCP 工具、閘道、內嵌函數工具、AgentCore 瀏覽器、AgentCore Code Interpreter、內建shell和file_operations工具

  • 記憶體

  • 執行限制

  • 對話截斷

  • 技能 （路徑、S3、Git)

  • VPC 繫帶的檔案系統掛載 （工作階段儲存、EFS、S3)

  • 授權方組態

CLI 用量

命令語法

範例
AgentCore CLI
agentcore export harness --arn <arn> [options]

選項

旗標 描述 預設

--arn <arn>

要匯出之繫帶的 ARN （匯出在目前 CLI 專案外建立的繫帶時使用）

arn 或name必要

--name <name>

要匯出的繫帶名稱 （匯出在相同 CLI 專案中建立的繫帶時使用）

arn 或name必要

--target-agent-name <name>

產生的執行時間代理程式名稱

<harnessName>Agent

--build <type>

組建類型： CodeZip 或 Container

CodeZip

--json

輸出結果為 JSON

False

範例

具有預設值的基本匯出：

範例
AgentCore CLI
# Export harness with ARN - generates MyHarnessAgent using CodeZip
agentcore export harness --arn arn:aws:bedrock-agentcore:us-east-1:123456789012:harness/MyHarness
# Export harness created within CLI project - generates MyHarnessAgent using CodeZip
agentcore export harness --name MyHarness
# Export with a custom agent name
agentcore export harness --name MyHarness --target-agent-name MyProductionAgent
# Export as a Container build (generates Dockerfile)
agentcore export harness --name MyHarness --build Container
Interactive

agentcore export harness 不使用 執行 --name 以啟動互動式匯出精靈。

  1. 如果專案有多個繫帶，請選取要匯出的繫帶。（使用單一繫帶，精靈會略過此步驟。)

    選取要匯出的繫帶

  2. 輸入產生的執行時間代理程式名稱，或接受預設的 <harness>Agent 。

    為產生的執行期代理程式命名

  3. 選擇建置類型：CodeZip （封裝 Python 來源作為 zip，預設值） 或 Container （透過 ECR 和 CodeBuild 建置 Docker 映像）。

    選取建置類型

  4. 檢閱匯出組態並確認。

    檢閱並確認匯出

匯出之後，請檢閱 EXPORT_NOTES.md ，然後執行 agentcore deploy以部署產生的代理程式。

匯出後

使用 AgentCore CLI 部署產生的執行期代理程式。

範例
AgentCore CLI
agentcore deploy

匯出的代理程式會新增為正常執行時間，因此會與 AgentCore CLI 專案的其餘部分一起部署。

EXPORT_NOTES.md

每次匯出後， EXPORT_NOTES.md 都會寫入列出需要手動追蹤的項目。匯出會將備註寫入 EXPORT_NOTES.md 的代理程式目錄中，列出每個項目、需要注意的原因，以及確切的處理方式。部署之前，請務必閱讀 EXPORT_NOTES.md。

部署選項

匯出之後，您可以將代理程式部署到多個託管環境：

  • AgentCore 執行期 （受管） - agentcore deploy用於在 AgentCore 執行期中託管，自動管理基礎設施、擴展和登入資料佈建。

  • 自我託管 - 在支援 Python 3.12+ 的任何位置部署產生的 Python 代理程式：

    • AWS 服務：Lambda、ECS/Fargate、EC2

    • Kubernetes 叢集

    • 內部部署伺服器

    • 任何容器化環境