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á.
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 ao 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 arquivo de arquivos.zip, você pode usar a AgentCore CLI zip da linha de comando em um ambiente Linux ou MacOS. Para usar os mesmos comandos no Windows, você pode instalar o Subsistema Windows para Linux
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 da Runtime | Sua responsabilidade |
|---|---|---|
|
Modo de implantação direta |
Publique uma nova versão de tempo de execução de 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 o código do seu agente, incluindo dependências, para resolver qualquer vulnerabilidade de segurança. |
|
Imagem do contêiner |
Corrija automaticamente o kernel do sistema operacional computacional subjacente com a versão mais recente. |
Atualize o código do seu agente, incluindo dependências, para resolver qualquer vulnerabilidade 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 direta de código atualizado com atualizações de segurança, correções de erros, novos recursos, aprimoramentos de desempenho e suporte para versões secundárias. Essas atualizações de tempo de execução são publicadas como versões de tempo de execução. AgentCore O Runtime aplica atualizações diretas de tempo de execução de implantação de código aos agentes migrando os agentes de uma versão de tempo de execução anterior para uma nova versão de 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 atualizações automáticas de tempo AgentCore de execução, o Runtime assume a carga operacional de corrigir as versões de 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 compatíveis com versões anteriores das 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 é útil 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, permitindo 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 de código.
-
Personalização: suporte direto de código para dependências personalizadas por meio de ZIP-based empacotamento, mantendo a simplicidade de implantação, enquanto o contêiner é baseado em 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 de tamanho.
-
Taxa de criação de sessão: a implantação direta de código permite uma maior criação de sessões de 25 novas 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 do 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 prototipar agentes rapidamente e, em seguida, migrar para implantações baseadas em contêineres (pelos motivos acima) para desenvolver, testar e implantar na produção.
