View a markdown version of this page

Exportar arnês para código - Amazon Bedrock AgentCore
Quando usar a exportaçãoO que é suportado hojeUso da CLIEXPORTAÇÃO_ NOTES.mdOpções de implantação

Exportar arnês para código

A exportação do harness para código usa uma configuração gerenciada e gera o agente equivalente como código-fonte editável do Python usando a estrutura Strands. O agente gerado é um agente AgentCore de tempo de execução normal: você possui o código, pode modificá-lo livremente e implantá-lo como qualquer outro agente. O agente gerado reflete o modelo, as ferramentas, as habilidades, a memória, os limites de execução e as montagens do sistema de arquivos do chicote.

Quando usar a exportação

Use a exportação quando tiver um arnês funcional e quiser:

  • Personalize além do que a configuração do chicote permite: adicione lógica de ferramenta personalizada, altere o loop do agente middleware/hooks, injete ou integre bibliotecas que o equipamento não expõe

  • Seja proprietário do código - passe de uma configuração declarativa para o código-fonte que você controla, revisa e versiona, como o resto do seu aplicativo.

  • Crie um protótipo: comece rapidamente com um arnês e exporte quando estiver pronto para investir em um agente de manutenção manual.

Se a configuração do chicote já faz tudo o que você precisa, você não precisa exportar - continue executando-a como um chicote.

O que é suportado hoje

  • Framework - Strands, com outras estruturas como Claude Agents SDK em breve

  • Linguagem - somente Python

  • Tipos de compilação - CodeZip (padrão) e contêiner

Aproveite os recursos transportados para o agente gerado:

  • Provedor e configuração do modelo (Bedrock, OpenAI, Gemini - incluindo referências de ID do modelo e chave de API)

  • Ferramentas - ferramentas MCP remotas, gateways, ferramentas de funções embutidas, AgentCore navegador, intérprete de AgentCore código, ferramentas integradas shell file_operations

  • Memória

  • Limites de execução

  • Truncamento de conversas

  • Habilidades (Path, S3, Git)

  • Montagens de sistemas de arquivos (armazenamento de sessão, EFS, S3) para equipamentos de VPC

  • Configuração do autorizador

Uso da CLI

Sintaxe de comando

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

Opções

Sinalizador Description Padrão

--arn <arn>

ARN do chicote a ser exportado (use ao exportar um arnês criado fora do projeto CLI atual)

arnou name obrigatório

--name <name>

Nome do equipamento a ser exportado (use ao exportar um equipamento criado no mesmo projeto CLI)

arnou name obrigatório

--target-agent-name <name>

Nome do agente de tempo de execução gerado

<harnessName>Agent

--build <type>

Tipo de construção: CodeZip ou Container

CodeZip

--json

Resultados de saída como JSON

Falso

Exemplos

Exportação básica com padrões:

exemplo
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

Execute agentcore export harness sem --name iniciar o assistente de exportação interativo.

  1. Se o projeto tiver mais de um chicote, selecione o chicote a ser exportado. (Com um único arnês, o mago pula essa etapa.)

    Selecione o arnês a ser exportado

  2. Insira um nome para o agente de tempo de execução gerado ou aceite o padrão<harness>Agent.

    Nomeie o agente de tempo de execução gerado

  3. Escolha o tipo de compilação: CodeZip(empacotar a fonte do Python como um zip, o padrão) ou Container (criar uma imagem do Docker via ECR e). CodeBuild

    Selecione o tipo de construção

  4. Revise a configuração de exportação e confirme.

    Revise e confirme a exportação

Depois de exportarEXPORT_NOTES.md, revise e execute agentcore deploy para implantar o agente gerado.

Depois da exportação

Implante o agente de tempo de execução gerado usando a AgentCore CLI.

exemplo
AgentCore CLI
agentcore deploy

O agente exportado é adicionado como um tempo de execução normal, então ele é implantado junto com o resto do seu projeto de CLI AgentCore .

EXPORTAÇÃO_ NOTES.md

Depois de cada exportação, EXPORT_NOTES.md é escrito listando os itens que requerem acompanhamento manual. Export grava notas em EXPORT_ NOTES.md no diretório do agente, listando cada item, por que ele precisa de atenção e exatamente o que fazer. Sempre leia EXPORT_ NOTES.md antes de implantar.

Opções de implantação

Depois de exportar, você pode implantar seu agente em vários ambientes de hospedagem:

  • AgentCore Tempo de execução (gerenciado) - Use agentcore deploy para hospedar no AgentCore Runtime, que gerencia a infraestrutura, o escalonamento e o provisionamento de credenciais automaticamente.

  • Self-hosted- Implante o agente Python gerado em qualquer lugar que ofereça suporte ao Python 3.12+:

    • AWS serviços: Lambda, EC2 ECS/Fargate

    • Clusters Kubernetes

    • On-premise servidores

    • Qualquer ambiente em contêineres