Comece a usar a implantação direta de código do Amazon Bedrock AgentCore Runtime
A implantação direta de código permite que você leve seu agente para o Amazon Bedrock AgentCore Runtime simplesmente empacotando o código do agente e suas dependências em um arquivo de arquivos.zip. Seu agente ainda precisa seguir os requisitos AgentCore de tempo de execução.
Para criar seu pacote de implantação como arquivamento de arquivos.zip, você pode usar a AgentCore CLIzip da linha de comando em um ambiente Linux ou MacOS. Para usar os mesmos comandos no Windows, você pode instalar o Windows Subsystem for Linux para
Observe que o AgentCore Runtime usa permissões de arquivo POSIX, portanto, talvez seja necessário definir permissões para a pasta do pacote de implantação
Tópicos
Conceitos de implantação direta de código
Saiba mais sobre os principais conceitos ao usar a implantação direta de código com o Amazon Bedrock AgentCore Runtime.
Tópicos
O Amazon Bedrock AgentCore Runtime com implantação direta de código usa um modelo de responsabilidade compartilhada semelhante ao AWS Lambda. AgentCore O Runtime gerencia o ambiente de execução da linguagem e aplica patches de segurança automaticamente, enquanto você se concentra no código e nas dependências do agente.
Se você estiver usando imagens de contêiner para implantar seus agentes, o AgentCore Runtime é responsável por corrigir somente o kernel de computação. Nesse caso, você é responsável por reconstruir a imagem do contêiner do seu agente a partir da imagem segura mais recente e reimplantar a imagem do contêiner.
Isso está resumido na seguinte tabela:
| Modo de implantação | AgentCore Responsabilidade do Runtime | Sua responsabilidade |
|---|---|---|
|
Modo de implantação direta |
Publique uma nova versão de tempo de execução da linguagem contendo os patches mais recentes para o tempo de execução da linguagem. Aplique patches de tempo de execução de linguagem à implantação direta AgentCore do Runtime existente. |
Atualize seu código de agente, incluindo dependências, para resolver quaisquer vulnerabilidades de segurança. |
|
Imagem do contêiner |
Corrija automaticamente o kernel do sistema operacional de computação subjacente com a versão mais recente. |
Atualize seu código de agente, incluindo dependências, para resolver quaisquer vulnerabilidades de segurança. Recompilar e reimplantar regularmente sua imagem de contêiner usando a imagem de base mais recente. |
Para obter mais informações sobre responsabilidade compartilhada com AWS, consulte Modelo de responsabilidade compartilhada
AgentCore O Runtime mantém cada tempo de execução de implantação de código direto atualizado com atualizações de segurança, correções de bugs, novos recursos, aprimoramentos de desempenho e suporte para versões menores. Essas atualizações de tempo de execução são publicadas como versões de tempo de execução. AgentCore O Runtime aplica código direto e implemente atualizações de tempo de execução aos agentes migrando os agentes de uma versão anterior do tempo de execução para uma nova versão do tempo de execução.
Para tempos de execução de implantação direta, o AgentCore Runtime aplica atualizações de tempo de execução automaticamente. Com as atualizações automáticas do tempo AgentCore de execução, o Runtime assume a carga operacional de corrigir as versões do tempo de execução. Para a maioria dos clientes, essa deve ser uma escolha segura, pois somente os patches de tempo de execução da linguagem serão aplicados automaticamente e os clientes são responsáveis por trazer e gerenciar suas dependências de código. Atualmente, o AgentCore Runtime não suporta a alteração desse comportamento automatizado de patches.
AgentCore O Runtime se esforça para fornecer atualizações de tempo de execução que sejam retrocompatíveis com as funções existentes. No entanto, como acontece com a aplicação de patches de software, há casos raros em que uma atualização de runtime pode afetar negativamente uma função existente. Por exemplo, os patches de segurança podem expor um problema subjacente em uma função existente que depende do comportamento inseguro anterior. Se, em casos extremamente raros, esse risco não for aceitável, use imagens de contêiner para implantar seu agente.
Algumas das dimensões de comparação para ver como uma opção difere da outra, por isso ajuda escolher a opção certa
-
Processo de implantação: a implantação direta de código implanta agentes usando arquivos ZIP em vez de contêineres, possibilitando iterações de desenvolvimento mais rápidas.
-
Tempo de implantação: embora não haja muita diferença durante a primeira implantação de um agente, as atualizações subsequentes do agente são significativamente mais rápidas com a implantação direta do código.
-
Personalização: suporte direto de código para dependências personalizadas por meio de ZIP-based empacotamento, mantendo a simplicidade da implantação, enquanto a base em contêiner depende de um arquivo Docker.
-
Tamanho do pacote: a implantação direta de código limita o tamanho do pacote a 250 MB, enquanto os pacotes baseados em contêiner podem ter até 2 GB.
-
Taxa de criação de sessão: a implantação direta de código permite uma maior criação de 25 novas sessões sessions/second em comparação com 1,6 novas sessions/second com implantações baseadas em contêineres.
Nossa orientação geral é
-
Se o tamanho do pacote de implantação exceder 250 MB e você tiver CI/CD pipelines de contêineres existentes e precisar de dependências e pacotes altamente especializados, as implantações baseadas em contêineres são uma boa opção.
-
Se o tamanho do pacote de implantação for pequeno, o código e o pacote não forem complexos de criar e usarem estruturas e linguagens comuns, e você precisar de prototipagem e iteração rápidas, a implantação direta de código seria a opção.
Também pode haver uma opção híbrida em que os desenvolvedores usam a implantação direta de código para experimentar e criar protótipos de agentes rapidamente e, em seguida, migrar para implantações baseadas em contêineres (pelos motivos acima) para desenvolver, testar e implantar na produção.
