View a markdown version of this page

Exportar chicote para código - Base da Amazônia AgentCore
Quando usar a exportaçãoO que é suportado hojeUso da CLIEXPORTAR_ NOTES.mdOpções de implantação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exportar chicote para código

A exportação do equipamento para código usa uma configuração gerenciada do equipamento e gera o agente equivalente ao código-fonte editável do Python usando a estrutura Strands. O agente gerado é um agente AgentCore de tempo de execução normal: você é o proprietário do 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 equipamento.

Quando usar a exportação

Use a exportação quando tiver um equipamento de trabalho e quiser:

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

  • Seja dono do código - mude de uma configuração declarativa para o código-fonte que você controla, revisa e cria versões, como o resto do seu aplicativo.

  • Crie um protótipo: comece rapidamente com um equipamento 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 o Claude Agents SDK, em breve

  • Linguagem - somente Python

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

Aproveite as características transportadas para o agente gerado:

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

  • Ferramentas - Ferramentas MCP remotas, gateways, ferramentas de função em linha, 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 sistema 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 equipamento a ser exportado (use ao exportar um equipamento criado fora do projeto CLI atual)

arnou name necessário

--name <name>

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

arnou name necessário

--target-agent-name <name>

Nome do agente de tempo de execução gerado

<harnessName>Agent

--build <type>

Tipo de compilaçã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 para iniciar o assistente de exportação interativo.

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

    Selecione o equipamento 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 (empacote a fonte Python como zip, o padrão) ou Container (crie uma imagem 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 e, portanto, é implantado junto com o restante do seu projeto AgentCore CLI.

EXPORTAR_ NOTES.md

Após 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 dimensionamento 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 ECS/Fargate, EC2

    • Clusters Kubernetes

    • On-premise servidores

    • Qualquer ambiente em contêineres