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 lê em tempo de execução. Os pacotes separam 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
configurationobjeto com pares de valores-chave arbitrários. -
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 via
parentVersionIds, semelhante aos commits do git. -
As filiais 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.
Tópicos
