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á.
# Modelos de atualização para solicitações de IA e agentes de IA
Quando você personaliza solicitações de IA ou agentes de IA no Amazon Connect, o modelo associado a cada solicitação de IA determina qual modelo de linguagem grande (LLM) processa as instruções. Com o tempo, modelos mais novos e mais capazes se tornam disponíveis. Este tópico descreve como atualizar modelos em alguns cenários comuns.
+ Você tem um agente de IA personalizado com um ou mais prompts de IA personalizados usando um modelo obsoleto
+ Você tem um agente de IA personalizado sem substituições imediatas
+ Você está usando versões mais antigas dos System AI Agents.
## Pré-requisitos
Antes de atualizar os modelos, verifique se você tem o seguinte:
+ Uma instância do Amazon Connect com o designer de agentes de IA ativado.
+ Uma conta de administrador ou uma conta com permissões de designer de agente de IA em seu perfil de segurança.
+ Familiaridade com [solicitações de IA](create-ai-prompts.md), [agentes de IA](create-ai-agents.md) e [solicitações e agentes de IA do sistema padrão.](default-ai-system.md)
## Quando fazer o upgrade
O Amazon Connect notifica você quando um modelo está programado para ser descontinuado. O Amazon Connect redireciona automaticamente a inferência do LLM para um modelo compatível depois que qualquer modelo passa da data de suspensão de uso, para que não haja interrupção do serviço. No entanto, a atualização manual antes da data de suspensão de uso permite escolher o modelo de substituição e testá-lo em seu ambiente. Use as etapas a seguir para determinar quais cenários se aplicam a você.
**Etapa 1: verifique se há agentes de IA personalizados.** No site do administrador, navegue até *Designer de agentes* de *IA, agentes de IA*. Veja a coluna *Tipo*. Os agentes do sistema exibem *- Sistema* após o nome do tipo (por exemplo, “Recomendação de resposta - Sistema”). Agentes sem esse sufixo são agentes personalizados que você criou.
+ Se você tiver um agente de IA personalizado com uma ou mais solicitações de IA personalizadas atribuídas a ele → Cenário 1 (se você substituiu apenas alguns tipos de solicitação, as solicitações não definidas são atualizadas automaticamente; você só precisa atualizar as solicitações personalizadas)
+ Se você tiver um agente de IA personalizado sem substituições de solicitação → Cenário 2 (solicita atualização automática, nenhuma ação é necessária)
+ Se você não tiver nenhum agente de IA personalizado, vá para a Etapa 2.
**Etapa 2: Verifique as configurações padrão do AI Agent.** Na mesma página de *agentes de IA*, vá até a seção *Configurações padrão do agente de IA*. Se algum caso de uso estiver fixado em uma versão específica (não definida como *Mais recente*), você poderá atualizá-la → Cenário 3. Isso se aplica a todos os clientes, mesmo que você não tenha agentes personalizados.
## Como funciona a resolução do modelo
Ao configurar um agente de IA individual, você tem a opção de permitir que o Connect escolha qual LLM usar para cada solicitação, escolha o modelo que deseja que cada solicitação use ou escolha uma combinação das duas opções.
+ Cada prompt de IA tem uma propriedade de modelo que especifica qual LLM usar.
+ Cada agente de IA faz referência a uma ou mais versões do prompt de IA. Uma versão é um instantâneo imutável do prompt, incluindo sua seleção de modelo.
+ Quando você cria um agente de IA personalizado e substitui somente alguns dos prompts associados ao agente, os tipos restantes são preenchidos a partir dos padrões do sistema em tempo de execução. As solicitações definidas explicitamente são fixadas na versão escolhida. Os prompts preenchidos pelo sistema usam o padrão mais recente do sistema. Essa resolução por solicitação se aplica a tipos de agentes de IA não agentes, como recomendação de resposta, pesquisa manual e autoatendimento. Non-Agentic
+ Os modelos disponíveis dependem da região da AWS da sua instância do Amazon Connect. Para obter uma lista de modelos compatíveis por região, consulte[Modelos compatíveis para system/custom solicitações](create-ai-prompts.md#cli-create-aiprompt).
## Cenário 1: agente de IA personalizado com solicitações personalizadas de IA
Nesse cenário, você criou um agente de IA personalizado e atribuiu um ou mais prompts de IA personalizados a ele. Os prompts personalizados são fixados no modelo selecionado ao publicá-los.
Os prompts personalizados não recebem automaticamente as atualizações do modelo. Você deve atualizar manualmente o modelo, publicar uma nova versão do prompt e atualizar o agente de IA.
### Se você tiver anulado apenas alguns tipos de prompt
Alguns tipos de agentes de IA oferecem suporte a vários tipos de prompts. Por exemplo, um agente de IA de recomendação de respostas oferece suporte a três tipos de solicitações: geração de rótulos de intenção, reformulação de consultas e geração de respostas. Se você definiu apenas alguns deles como prompts personalizados e deixou o resto sem definição, o seguinte se aplica:
+ Os tipos de prompt que você define explicitamente (por meio do site do administrador ou da CLI) são fixados na versão específica do prompt que você escolheu. Eles não mudam a menos que você os atualize. Siga as etapas de atualização abaixo para cada solicitação personalizada.
+ Os tipos de prompt que você deixou sem definir não são armazenados na configuração do agente de IA. Em tempo de execução, o Amazon Connect os resolve a partir dos padrões atuais do sistema. Esses tipos sempre usam as versões mais recentes do prompt do sistema, incluindo qualquer atualização de modelo. Nenhuma ação é necessária para tipos de prompt não definidos.
### Atualize usando o site de administração
**Etapa 1: criar uma nova versão do prompt com o modelo atualizado**
1. Faça login no site de administração do Amazon Connect.
1. No menu de navegação, escolha *Agent Designer*, *AI prompts.*
1. Na lista de *Solicitações*, selecione a solicitação personalizada de IA que você deseja atualizar.
1. Escolha *Editar no AI Prompt Builder* (canto superior direito).
1. O menu suspenso no canto superior direito mostra *Último*: Rascunho. Esta é a cópia de trabalho que você modificará.
1. Na seção *Modelos*, use o menu suspenso para selecionar o novo modelo.
1. Selecione *Publish*. Isso cria uma nova versão do prompt com o novo modelo.
1. Role para baixo até a seção *Versões* na mesma página. Você pode confirmar que a nova versão foi criada.
1. Para verificar a nova versão, volte para o *designer de agentes de IA*, *avisos de IA*. Selecione o prompt na lista e, em seguida, use o menu suspenso da versão (canto superior direito) para selecionar a nova versão. A seção *Visão geral* exibe o ID do modelo atualizado.
**Etapa 2: atualizar o agente de IA para usar a nova versão do prompt**
1. Navegue até o *designer de agentes* de *IA, agentes* de IA.
1. Escolha o agente de IA personalizado que faz referência a esse prompt.
1. Escolha *Editar no AI Agent Builder* para abrir a página do Agent Builder.
1. Escolha *Adicionar solicitação*. Um pop-up aparece com os prompts disponíveis.
1. Selecione a nova versão do prompt e escolha *Adicionar*. O pop-up é fechado e o prompt é adicionado ao agente.
1. Selecione *Publish*. Isso cria uma nova versão do agente de IA usando o prompt personalizado com o modelo atualizado.
1. Role para baixo até a seção *Versões* para confirmar se a nova versão do agente de IA aparece.
1. Opcionalmente, selecione a versão mais recente no menu suspenso superior direito. A seção *Prompts* exibe a nova versão do prompt.
**Etapa 3: definir a nova versão do agente de IA como padrão**
1. Navegue até o *designer de agentes* de *IA, agentes* de IA.
1. Na seção *Configurações padrão do agente de IA*, encontre o caso de uso que está usando o agente de IA personalizado e atualize-o para a nova versão.
1. Escolha o ícone de marca de seleção (✓) para salvar.
1. Para evitar a atualização manual da versão todas as vezes, selecione *Mais recente* no menu suspenso de versões. Isso usa automaticamente a versão publicada mais recentemente do agente de IA.
### Atualize usando a AWS CLI
Atualize o prompt de IA com o novo modelo:
```
aws qconnect update-ai-prompt \
--assistant-id {{assistant-id}} \
--ai-prompt-id {{custom-prompt-id}} \
--model-id {{new-model-id}}
```
Publique uma nova versão do prompt:
```
aws qconnect create-ai-prompt-version \
--assistant-id {{assistant-id}} \
--ai-prompt-id {{custom-prompt-id}}
```
Atualize o agente de IA para fazer referência à nova versão do prompt:
```
aws qconnect update-ai-agent \
--assistant-id {{assistant-id}} \
--ai-agent-id {{custom-agent-id}} \
--configuration '{
"{{agentTypeConfiguration}}": {
"{{promptTypeAIPromptId}}": "{{custom-prompt-id}}:{{new-version-number}}"
}
}'
```
Publique uma nova versão do agente de IA:
```
aws qconnect create-ai-agent-version \
--assistant-id {{assistant-id}} \
--ai-agent-id {{custom-agent-id}}
```
Defina a nova versão do agente de IA como padrão:
```
aws qconnect update-assistant-ai-agent \
--assistant-id {{assistant-id}} \
--ai-agent-type {{AGENT_TYPE}} \
--configuration '{
"aiAgentId": "{{custom-agent-id}}:{{new-version-number}}"
}'
```
## Cenário 2: agente de IA personalizado sem substituições imediatas
Nesse cenário, você criou um agente de IA personalizado para personalizar configurações como localidade ou configuração da base de conhecimento, mas não substituiu nenhum tipo de prompt. Todas as solicitações são resolvidas a partir dos padrões do sistema.
### Atualizações automáticas
Quando o Amazon Connect publica novas versões do agente de IA do sistema e do prompt com modelos atualizados, seu agente de IA personalizado seleciona automaticamente as versões mais recentes do prompt do sistema. Nenhuma ação é necessária.
Isso ocorre porque os tipos de prompt não definidos são resolvidos em tempo de execução a partir dos padrões atuais do sistema, que sempre apontam para as versões mais recentes do prompt do sistema.
### Forçar um modelo específico antes de uma atualização do sistema
Se você quiser usar um modelo mais novo antes de o Amazon Connect lançá-lo como padrão do sistema:
1. Crie um prompt de IA personalizado copiando o prompt do sistema que você deseja atualizar.
1. Mude o modelo para o modelo mais novo desejado.
1. Publique o prompt personalizado.
1. Edite seu agente de IA personalizado e adicione o prompt personalizado ao tipo desejado.
1. Publique o agente de IA.
Isso converte esse tipo de prompt em uma configuração do Cenário 1.
## Cenário 3: atualização das configurações padrão do agente de IA
A seção *Configurações padrão do agente* de *IA na página de visão geral dos agentes* de IA controla qual versão do agente de IA está ativa para cada caso de uso (recomendação de resposta, pesquisa manual, autoatendimento etc.).
Quando uma instância do Amazon Connect é criada, cada caso de uso é configurado automaticamente com uma versão específica do agente de IA do sistema. Essas versões são fixadas — elas não são atualizadas automaticamente quando o Amazon Connect publica novas versões do agente de IA do sistema ou quando você publica novas versões personalizadas do agente de IA. Você deve selecionar manualmente a nova versão.
### Atualize usando o site de administração
1. Navegue até o *designer de agentes* de *IA, agentes* de IA.
1. Na seção *Configurações padrão do agente de IA*, encontre o caso de uso que você deseja atualizar (por exemplo, Recomendação de resposta).
1. No menu suspenso da versão, selecione a nova versão do agente de IA.
1. Escolha *Salvar*.
1. Para evitar a atualização manual da versão todas as vezes, selecione *Mais recente* no menu suspenso de versões. Isso usa automaticamente a versão publicada mais recentemente do agente de IA.
### Atualize usando a AWS CLI
```
aws qconnect update-assistant-ai-agent \
--assistant-id {{assistant-id}} \
--ai-agent-type {{AGENT_TYPE}} \
--configuration '{
"aiAgentId": "{{ai-agent-id}}:{{new-version-number}}"
}'
```
{{AGENT\_TYPE}}Substitua pelo tipo de caso de uso (por exemplo`ANSWER_RECOMMENDATION`,`MANUAL_SEARCH`,,`SELF_SERVICE`).
## Resumo
| \# | Cenário | Auto-upgrades? | Ação necessária |
| --- | --- | --- | --- |
| 1 | Agente de IA personalizado com solicitações personalizadas de IA | Solicitações personalizadas: Não. Solicitações não definidas: Sim | Solicitação de edição, alteração de modelo, solicitação de publicação, agente de atualização, agente de publicação. A desativação solicita a atualização automática. |
| 2 | Agente de IA personalizado sem substituições imediatas | Sim | Nenhuma ação é necessária |
| 3 | Atualizando as configurações padrão do AI Agent | Casos de uso não definidos: Sim. Definido explicitamente: Não | Versões fixadas explicitamente: selecione a nova versão e salve |
## Considerações importantes
+ **Teste:** teste as atualizações do modelo em um ambiente que não seja de produção antes de implementar as alterações de forma ampla. Use a `update-session` API para definir versões do agente de IA para sessões específicas.
+ **Infraestrutura como código:** se você gerencia solicitações de IA e agentes de IA por meio de CloudFormation ou AWS CDK, atualize as propriedades do recurso em seu modelo (por exemplo, `ModelId` ativado`AWS::Wisdom::AIPrompt`) e implante a pilha. O comportamento do tipo de prompt descrito neste tópico se aplica da mesma forma: desative os tipos de prompt na `AWS::Wisdom::AIAgent` resolução dos padrões do sistema em tempo de execução.
+ **Disponibilidade regional:** a disponibilidade do modelo varia de acordo com a região da AWS. Verifique a tabela de modelos compatíveis antes de selecionar um modelo. Para obter mais informações, consulte [Modelos compatíveis para system/custom solicitações](create-ai-prompts.md#cli-create-aiprompt).
+ **Session-level substituições:** as versões do agente de IA definidas nas sessões têm precedência sobre os padrões de nível de assistente, que têm precedência sobre os padrões do sistema. Se você definir as versões do agente de IA no nível da sessão, também deverá atualizar essas referências.
+ **Revertendo aos padrões do sistema:** *para retornar um caso de uso para o agente de IA do sistema usando o site administrativo, navegue até o *designer do agente de IA*, agentes de IA.* *Na seção *Configurações padrão do agente de IA*, encontre o caso de uso, selecione o agente de IA do sistema no menu suspenso do agente, escolha a versão desejada ou a *mais recente* e escolha Salvar.* Usando a CLI, execute `list-ai-agents --origin SYSTEM` para encontrar o ID do agente de IA do sistema para o tipo de caso de uso e, em seguida, configure-o usando. `update-assistant-ai-agent`