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á.
# AI-powered análise ambiental
AWS Elastic Beanstalk A AI-powered análise da identifica as causas principais e recomenda soluções para problemas de saúde ambiental. Quando seu ambiente enfrenta problemas, você pode solicitar uma análise de IA usando as operações de `RetrieveEnvironmentInfo` API `RequestEnvironmentInfo` e com o tipo de `analyze` informação para obter AI-generated insights e soluções recomendadas.
**nota**
A análise de IA está disponível nas versões compatíveis das plataformas Amazon Linux 2 e AL2023 lançadas em ou após 26 de fevereiro de 2026. Para plataformas Windows Server, a análise de IA está disponível nas versões da plataforma lançadas em ou após 22 de abril de 2026.
## Como funciona
[Quando você solicita uma análise de IA, o Elastic Beanstalk executa um script em uma instância em seu ambiente que coleta eventos recentes, integridade da instância e registros (até 170.000 tokens de dados).](https://docs.aws.amazon.com/bedrock/latest/userguide/key-definitions.html) Em seguida, ele envia esses dados para o Amazon Bedrock em sua conta e retorna insights e as próximas etapas recomendadas.
## Pré-requisitos
Antes de usar a análise de IA, verifique se seu ambiente atende aos seguintes requisitos:
+ Ambiente executando uma [versão de plataforma compatível](#health-ai-analysis-supported-platforms)
+ [Perfil da instância](iam-instanceprofile.md) com as permissões necessárias (veja [Permissões obrigatórias](#health-ai-analysis-permissions) abaixo)
+ **Detalhes do caso de uso antrópico (regiões comerciais) — Em regiões** comerciais, a análise de IA usa modelos Anthropic Claude por meio do Amazon Bedrock. A Anthropic exige que você envie um formulário único de detalhes do caso de uso antes de poder invocar seus modelos. Para enviar esse formulário, selecione qualquer modelo antrópico do catálogo de modelos no [console do Amazon Bedrock](https://console.aws.amazon.com/bedrock/) ou ligue para a [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html)API. Você só precisa fazer isso uma vez por AWS conta. Se você enviar o formulário da conta de gerenciamento da AWS Organizations, ele cobrirá automaticamente todas as contas dos membros da organização. Para obter mais informações, consulte [Acesse os modelos básicos do Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html).
+ Mesmo depois de enviar o formulário de detalhes do caso de uso, a primeira invocação de um modelo Anthropic Claude em sua conta exige permissões do AWS Marketplace para concluir uma assinatura automática de modelo. Se seu perfil de instância não tiver essas permissões, a análise de IA falhará com o seguinte erro:
`AccessDeniedException: Model access is denied due to IAM user or service role is not authorized to perform the required AWS Marketplace actions (aws-marketplace:ViewSubscriptions, aws-marketplace:Subscribe) to enable access to this model.`
Para resolver isso, adicione`aws-marketplace:Subscribe`,`aws-marketplace:Unsubscribe`, e `aws-marketplace:ViewSubscriptions` permissões ao seu perfil de instância. Essas permissões são necessárias somente para a primeira invocação em uma conta. Depois que o modelo estiver ativado, você poderá removê-lo. Para obter mais informações, consulte [Conceder permissões do IAM para solicitar acesso aos modelos da Amazon Bedrock Foundation](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-permissions).
+ **GovCloud regiões** — Se você estiver usando regiões AWS GovCloud (EUA), a análise de IA usa o modelo NVIDIA Nemotron em vez do Anthropic Claude. Você deve solicitar acesso ao modelo NVIDIA Nemotron 3 Super 120B no Amazon Bedrock antes de usar a análise de IA. Para solicitar acesso, abra a página de acesso do [Amazon Bedrock Model](https://console.amazonaws-us-gov.com/bedrock/home#/modelaccess) no GovCloud console e solicite acesso ao NVIDIA Nemotron 3 Super 120B. O formulário de detalhes do caso de uso da Anthropic e as permissões do AWS Marketplace não são necessários para GovCloud regiões. Para obter mais informações sobre como habilitar o acesso ao modelo GovCloud, consulte [Acesse os modelos da Amazon Bedrock Foundation nos AWS GovCloud (EUA)](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-govcloud).
## Permissões obrigatórias
Para usar a análise de IA, o perfil de instância do Amazon EC2 para seu ambiente deve ter permissões para invocar o Amazon Bedrock. Adicione as seguintes permissões ao seu perfil de instância:
+ `bedrock:InvokeModel`
+ `bedrock:ListFoundationModels`
+ `elasticbeanstalk:DescribeEvents`
+ `elasticbeanstalk:DescribeEnvironmentHealth`
Para obter mais informações sobre como configurar perfis de instância, consulte[Gerenciar perfis de instância do Elastic Beanstalk](iam-instanceprofile.md).
**nota**
Em regiões comerciais, se essa for a primeira vez que um modelo Anthropic Claude está sendo invocado em sua conta, você também precisará das permissões do AWS Marketplace (`aws-marketplace:Subscribe`,`aws-marketplace:Unsubscribe`, e). `aws-marketplace:ViewSubscriptions` Essas permissões não são necessárias nas GovCloud regiões. Para mais detalhes, consulte [Pré-requisitos](#health-ai-analysis-prereqs).
## Usando a análise de IA no console
**Da visão geral do ambiente**
Quando o status de saúde do seu ambiente é **Advertido**, **Degradado ou **Grave****, um botão **Análise de IA** aparece na seção de visão geral do ambiente. Clique nesse botão para iniciar uma análise de IA do seu ambiente.
**Na página Registros**
Você também pode acessar a análise de IA na página **Registros** no painel de navegação. Clique no botão **Análise de IA** para solicitar uma AI-powered análise do estado atual do seu ambiente.
## Usando a análise de IA com o AWS CLI
Você pode usar a API do Elastic Beanstalk AWS CLI por meio do para solicitar e recuperar análises de IA programaticamente.
**Solicitar análise de IA**
Use a [https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html)operação com o `InfoType` parâmetro definido como`analyze`.
**Example AWS CLI - Solicitar análise de IA**
```
aws elasticbeanstalk request-environment-info \
--environment-name {{my-env}} \
--info-type analyze \
--region {{us-east-1}}
```
**Recupere a análise de IA**
Use a [https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html)operação com o conjunto de `InfoType` parâmetros `analyze` para recuperar os resultados da análise.
**Example AWS CLI - Recupere a análise de IA**
```
aws elasticbeanstalk retrieve-environment-info \
--environment-name {{my-env}} \
--info-type analyze \
--region {{us-east-1}}
```
A resposta inclui uma AI-generated análise do estado atual do ambiente, juntamente com soluções recomendadas para quaisquer problemas identificados.
## Usando a análise de IA com o EB CLI
Se você usar a CLI do EB, poderá solicitar a análise de IA com a opção `--analyze` (`-ai`) do **eb logs** comando. O comando solicita a análise, espera que ela seja concluída e exibe os resultados.
**Example EB CLI - Solicitar análise de IA**
```
$ eb logs --analyze
```
A `--analyze` opção não é compatível com`--instance`,`--all`,`--zip`, ou`--log-group`. Para obter a referência completa do comando, consulte[**eb logs**](eb3-logs.md).
**nota**
A `--analyze` opção requer o EB CLI versão 3.27 ou posterior.
## Considerações importantes
+ **Preços** — A análise de IA usa o Amazon Bedrock para processar os dados do seu ambiente, e os preços padrão do Amazon Bedrock se aplicam às invocações do modelo. Para obter detalhes de preço, consulte [Preços do Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
+ **Requisito de plataforma** — A análise de IA está disponível nas versões de plataforma baseadas em Amazon Linux 2 e AL2023 lançadas em ou após 26 de fevereiro de 2026. Para plataformas Windows Server, a análise de IA está disponível nas versões da plataforma lançadas em ou após 22 de abril de 2026. Para usar esse recurso, atualize seu ambiente para uma versão de plataforma compatível. Para obter mais informações, consulte [Atualizar a versão de plataforma do ambiente Elastic Beanstalk](using-features.platform.upgrade.md).
+ **Permissões** — Antes de usar a análise de IA, certifique-se de que seu perfil de instância tenha as permissões necessárias do Amazon Bedrock (`bedrock:InvokeModel`e`bedrock:ListFoundationModels`) e as permissões do Elastic `elasticbeanstalk:DescribeEvents` Beanstalk (e). `elasticbeanstalk:DescribeEnvironmentHealth`
+ **Privacidade de dados** — A análise envia eventos e registros do ambiente para o Amazon Bedrock em sua conta para processamento. Para obter informações sobre como o Amazon Bedrock lida com seus dados, consulte [Amazon Bedrock Security and](https://aws.amazon.com/bedrock/security-compliance/) Compliance.
+ **Cotas de serviço** — A análise de IA usa modelos básicos do Amazon Bedrock, que têm cotas padrão para solicitações por minuto e tokens por minuto. Nas regiões comerciais, os modelos Anthropic Claude são usados. Nas GovCloud regiões, o modelo NVIDIA Nemotron é usado. Se você encontrar erros de limitação, poderá solicitar um aumento de cota. Consulte [Solicitar um aumento de cota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)para ter mais informações.
## Versões compatíveis da plataforma
A análise de IA é suportada nas versões da plataforma baseadas em Amazon Linux 2 e AL2023 lançadas em ou após [26 de fevereiro de 2026](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-02-26-al2023.html). Para plataformas Windows Server, a análise de IA é suportada nas versões da plataforma lançadas em ou após [22 de abril de 2026](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-04-22-windows.html). Para verificar a versão da sua plataforma, consulte as notas de lançamento do [Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/welcome.html).