View a markdown version of this page

Pacotes de configuração - Base da Amazônia AgentCore

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á.

Pacotes de configuração

Um pacote de configuração é um instantâneo versionado e imutável da configuração dinâmica do seu agente — solicitações do sistema, IDs de modelo, descrições de ferramentas e quaisquer outros pares de valores-chave que seu agente leia em tempo de execução. Os pacotes dissociam o comportamento do agente do código, permitindo que você altere a forma como seu agente responde sem reimplantar o código.

Principais conceitos

  • Os componentes são codificados pelo ARN do AgentCore recurso que eles configuram (por exemplo, um ARN de tempo de execução). Cada componente contém um configuration objeto com pares arbitrários de valores-chave.

  • As versões são imutáveis. Cada atualização cria uma nova versão com um UUID exclusivo. As versões formam uma cadeia viaparentVersionIds, semelhante ao git commits.

  • As ramificações organizam a linhagem da versão (por exemplo,mainline,experiment-1).

  • Os nomes dos pacotes devem começar com uma letra e podem conter letras, dígitos e sublinhados (sem hífens). Padrão:[a-zA-Z][a-zA-Z0-9_]{0,99}.

Quando usar pacotes de configuração

  • A/B testando. Cada variante em um A/B teste faz referência a uma versão específica do pacote. O gateway injeta a referência do pacote em cada solicitação.

  • Recomendações. A API Recommendations pode ler a configuração atual de um pacote e gravar a configuração otimizada como uma nova versão do pacote.

  • Reversão. Como as versões são imutáveis, você pode reverter para qualquer versão anterior fazendo referência ao ID da versão.

  • Trilha de auditoria. A cadeia de versões fornece um histórico completo das alterações de configuração.