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á.
# Crie, personalize e implante agentes de bate-papo com inteligência artificial no Amazon Quick
Os agentes de bate-papo no Amazon Quick ajudam os usuários a explorar dados, analisar informações e realizar ações. Os usuários podem interagir com agentes de bate-papo usando a interface de bate-papo rápido. Os agentes de bate-papo fornecem assistência por meio de conversas abertas apoiadas por metas específicas, fontes de conhecimento e quaisquer ferramentas conectadas. Os agentes de bate-papo podem evoluir de interfaces simples de resposta a perguntas para funções mais avançadas que orquestram fluxos de trabalho complexos.
Você pode usar agentes de chat para:
+ Gere conteúdo e forneça respostas por meio de conversas em linguagem natural
+ Analise e resuma informações de espaços conectados, painéis, tópicos, conjuntos de dados e arquivos enviados
+ Invoque ações para executar etapas predefinidas para obter resultados consistentes e repetíveis
**nota**
Para saber mais sobre como conversar usando agentes de bate-papo, consulte [Usando o Amazon Quick Chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html).
**Topics**
+ [Tipos de agentes de chat](#agent-types)
+ [Amazon Quick: interação do usuário com agentes de bate-papo](#user-agent-actions)
+ [Permissões de usuário do Amazon Quick para agentes de bate-papo](#user-agent-permissions)
+ [Permissões personalizadas para agentes de chat](#custom-permissions-chat-agents)
+ [Agente de bate-papo do sistema](default-assistant.md)
+ [Agentes de chat personalizados](custom-agents.md)
+ [Fontes de contexto e melhores práticas do agente de chat](agent-knowledge-sources-best-practices.md)
+ [Use um agente de chat](use-agents.md)
## Tipos de agentes de chat
O Amazon Quick oferece suporte a dois tipos de agentes de chat:
+ **Agente de bate-papo do sistema** — Esse agente de bate-papo (“Meu assistente”) está automaticamente disponível para todos os usuários por padrão. O agente de bate-papo do sistema serve como um planejador básico sem dados ou ações inerentes. Ele acessa dinamicamente os recursos disponíveis para cada usuário durante o bate-papo, permitindo que ele seja adaptado às permissões individuais do usuário e ao conteúdo disponível. Os usuários administradores controlam as configurações do agente de bate-papo do sistema atribuindo usuários específicos como proprietários para que eles possam personalizar sua personalidade e outras configurações.
O agente de bate-papo do sistema está habilitado com todos os recursos de bate-papo, incluindo funcionalidade de upload de arquivos, acesso ao conhecimento do LLM, toxicidade e outras barreiras de proteção e pesquisa na web. Também inclui mecanismos de escopo de dados de bate-papo que fornecem acesso a espaços, tópicos, painéis, bases de conhecimento e ações com base nas permissões do usuário.
+ **Agentes de chat personalizados** — Esses agentes de chat podem ser criados e personalizados para casos de uso específicos por usuários com recursos de criação de agentes de chat no Amazon Quick e compartilhados com qualquer pessoa. Os administradores podem optar por impedir que usuários e grupos específicos criem agentes de bate-papo personalizados e, ao mesmo tempo, permitir que os usuários usem agentes de bate-papo por meio do chat. Os agentes de chat retornam respostas com escopo específico para o qual seus usuários invocadores têm permissões.
Agentes de chat personalizados podem interagir com os recursos do Amazon Quick das seguintes formas:
+ **Pré-configurados com recursos** — Esses agentes de bate-papo usam somente os recursos configurados (por exemplo, espaços como fontes de conhecimento, conectores de ação como ferramentas) ao procurar respostas ou orquestrar ações como seu comportamento padrão. Durante o bate-papo, os usuários podem anexar recursos adicionais de acordo com suas necessidades ou invocar ações diretamente. Por exemplo, agentes de chat configurados somente com espaços contendo arquivos não podem realizar ações por padrão, a menos que os usuários os invoquem explicitamente. Da mesma forma, os agentes de bate-papo configurados apenas com ações dependem do conhecimento do LLM, a menos que os usuários anexem um espaço ou painel para respostas específicas da empresa. No entanto, os usuários podem anexar espaços adicionais ou invocar diretamente outras ações às quais possam ter acesso na interface de bate-papo.
+ **Não opinativos no momento da criação** — Esses agentes de bate-papo não são inicialmente configurados com recursos quando são criados (espaços, conectores de ação ou ambos). O chat determina o limite de recursos para o agente de chat. Por exemplo, se nenhum espaço estiver configurado para o agente de bate-papo, o chat usará como padrão todos os espaços ou conhecimento do LLM até que o usuário faça uma alteração. Se nenhum conector de ação estiver configurado para o agente de chat, durante o chat, todas as ações às quais um usuário tem acesso estarão disponíveis para o agente até que o usuário faça uma seleção de recursos que não inclua ações.
A seleção de recursos do usuário durante o bate-papo afeta o comportamento do agente de bate-papo. Se um usuário selecionar um espaço, o agente de bate-papo responderá apenas com dados dentro desse espaço e tomará as ações disponíveis nesse espaço (se não for opinativo no momento da criação). Se um usuário selecionar um painel, tópico ou base de conhecimento, o agente de chat responderá somente dessa fonte e não realizará nenhuma ação, pois o foco foi alterado para uma fonte de dados específica. Espera-se que os usuários selecionem todos os recursos relevantes no chat para obter assistência abrangente.
**nota**
O agente de bate-papo do sistema é um agente de bate-papo imparcial por design. Se você quiser que os agentes de chat acessem todas as ações, independentemente do foco nos dados, configure os agentes de chat com conectores de ação.
## Amazon Quick: interação do usuário com agentes de bate-papo
A tabela a seguir mostra o que você pode fazer com agentes de chat no console de administração versus como usuário do Amazon Quick. Para obter mais informações sobre quais funções podem acessar esses recursos, consulte o documento de [preços do Amazon Quick](https://aws.amazon.com/quicksuite/pricing/).
| Nível de acesso | Capacidades |
| --- | --- |
| Console de administração | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
| Usuário Amazon Quick | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
## Permissões de usuário do Amazon Quick para agentes de bate-papo
O que você pode fazer com um agente de chat também depende das permissões atribuídas a ele. Há dois tipos de permissão que podem ser atribuídos aos usuários:
+ **Proprietário** — Os proprietários podem editar, compartilhar e excluir o agente de chat.
+ **Visualizador** — Os espectadores podem ver e usar o agente de bate-papo.
**nota**
Se você não tiver acesso a um recurso vinculado como visualizador ou proprietário, os recursos adicionados ao agente de bate-papo por outro proprietário aparecerão como “Recurso indisponível”. Você pode excluir esses recursos como proprietário, mas não pode listá-los ou adicioná-los porque o compartilhamento em nível de recurso é necessário.
Os administradores rápidos devem dar aos usuários a permissão para criar agentes de chat. Para obter informações sobre quais funções podem criar agentes de chat, consulte a documentação de [preços do Amazon Quick](https://aws.amazon.com/quicksuite/pricing/). Para obter informações sobre como fornecer acesso a esses recursos, consulte [Permissões personalizadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) no Guia rápido do administrador.
A tabela a seguir descreve como as permissões do usuário determinam o que você pode fazer com um agente de chat Amazon Quick:
| Tipo de permissões | Permissões |
| --- | --- |
| Proprietários | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
| Espectadores | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
## Permissões personalizadas para agentes de chat
Por padrão, o Amazon Quick habilita todos os novos recursos disponíveis para a conta Amazon Quick, para que os usuários possam acessá-los imediatamente com base em sua assinatura. Você pode usar [permissões personalizadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) para restringir recursos específicos. Como administrador, ao criar um perfil de permissões personalizado, você pode criar dois tipos de restrições para agentes de chat:
+ Você pode desativar completamente todas as funcionalidades do agente de chat para os usuários, incluindo conversar com o agente padrão, conversar com agentes personalizados e criar novos agentes. Isso pode ser feito restringindo a capacidade do **agente do Chat**.
+ Você também pode restringir especificamente a capacidade de criar agentes sem afetar o bate-papo com agentes. Isso pode ser feito criando um perfil de permissão personalizado e restringindo somente o recurso **Criar agentes de chat**.
**nota**
Se você quiser que seus usuários possam conversar usando o agente do sistema, mas não quiser que eles criem agentes de chat, restrinja somente suas habilidades de criação de agentes de chat.
As permissões dos agentes no Amazon Quick podem ser configuradas em várias combinações para atender às necessidades da sua organização. Para ajudar você a entender como configurar permissões, a seção a seguir fornece uma abordagem baseada em casos de uso que agrupa cenários comuns:
| Cenário de caso de uso | O que os usuários podem fazer |
| --- | --- |
| Agente com todos os recursos(Sem restrições sobre agentes de bate-papo, espaços, bases de conhecimento, ações ou fluxos) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
| Acesso somente por chat aos agentes(Recursos do agente ativados, mas a criação do agente de chat é restrita) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
| Acesso limitado a outros recursos(Agentes de chat habilitados, mas recursos específicos restritos) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
| Sem acesso ao agente de chat(Capacidades do agente completamente restritas) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/working-with-agents.html) |
# Agente de bate-papo do sistema
O agente de bate-papo do sistema Amazon Quick é criado automaticamente quando você se inscreve no Quick. Ele serve como a interface principal para que todos os usuários interajam com seus dados e executem várias tarefas no ambiente Quick. Ele vem equipado com grades de proteção padrão.
A propriedade do agente de bate-papo do sistema é gerenciada pelo administrador do Quick. Os administradores podem desativar o bate-papo com agentes de bate-papo, incluindo o agente de bate-papo do sistema, usando permissões [personalizadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html). Se ativado, os usuários com funções não administrativas (autores e leitores) podem visualizar, listar, invocar e usar o agente de chat do Quick Chat. Suas respostas são filtradas com base nas permissões do usuário para os ativos.
O agente de bate-papo do sistema Quick está configurado para usar todos os recursos de bate-papo prontos para uso, com o mínimo de personalização necessária. Embora esses recursos também estejam disponíveis para agentes de chat personalizados, eles devem ser configurados durante a criação do agente de chat. O agente de bate-papo do sistema inclui:
+ Persona padrão como assistente rápido, com tom profissional e estilo de resposta
+ Carregamento de arquivo no recurso de bate-papo ativado
+ Chat de conhecimento do modelo de linguagem grande (LLM) ativado
+ Usa grades de proteção padrão configuradas para bate-papo no console de administração
+ Acesso a todos os espaços, tópicos, painéis, bases de conhecimento e ações com base nas permissões do usuário
+ Capacidades de pesquisa na web
Para saber como personalizar um agente de chat do sistema como administrador proprietário, consulte [Gerenciamento da personalização do agente de chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-agent.html). Para saber como controlar o acesso ao agente de bate-papo do sistema, consulte [Gerenciar ativos](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-qs-assets.html).
# Agentes de chat personalizados
Agentes de bate-papo personalizados permitem que os usuários do Amazon Quick criem interfaces de conversação personalizadas para necessidades comerciais específicas. Ao contrário do agente de bate-papo do sistema, que está disponível para todos os usuários com permissões de bate-papo por padrão, os agentes de bate-papo personalizados podem ser compartilhados e configurados seletivamente por usuários autorizados.
Os usuários com recursos de criação de agentes de chat podem personalizar a personalidade, o estilo de resposta e os recursos do agente por meio de uma interface de linguagem natural ou por meio do fluxo de configuração do agente builder. Esses usuários também podem configurar esses agentes de bate-papo com fontes de conhecimento específicas (como espaços) e fluxos de trabalho (como ações), mantendo o controle sobre as permissões de compartilhamento e acesso para cada um desses recursos separadamente. Ou, os agentes de chat podem ser deixados desvinculados para uso geral, o que permite que os usuários finais usem o agente com todos ou alguns de seus recursos.
Os administradores rápidos devem dar aos usuários a permissão para criar agentes de chat. Para obter informações sobre quais funções podem criar agentes de chat, consulte a documentação de [preços do Amazon Quick](https://aws.amazon.com/quicksuite/pricing/). Para obter informações sobre como fornecer ou restringir o acesso a esses recursos, consulte [Permissões personalizadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) no Guia rápido do administrador.
**Topics**
+ [Crie e visualize agentes de chat personalizados](#create-custom-agents)
+ [Compartilhe agentes de bate-papo personalizados](#share-custom-agents)
+ [Incorpore agentes de bate-papo personalizados](#embed-custom-agents)
+ [Atualizar agentes de chat personalizados](#update-custom-agents)
+ [Gerencie o acesso a um agente de chat personalizado](#remove-access-custom-agents)
+ [Veja os agentes de chat](#view-agents)
+ [Exibir detalhes do agente de chat](#view-agent-details)
+ [Agentes de bate-papo personalizados duplicados](#duplicate-agents)
+ [Excluir agentes de chat](#delete-agents)
## Crie e visualize agentes de chat personalizados
Você pode criar agentes de chat personalizados no Amazon Quick a partir do menu **Agentes de chat** na página inicial do Amazon Quick. Você pode visualizar e testar seu agente de chat à medida que o cria. Quando você cria um agente de chat personalizado, você é designado como seu proprietário por padrão. O procedimento a seguir descreve como criar um agente de chat personalizado.
------
#### [ Using natural language ]
**Para criar um agente de bate-papo personalizado usando um prompt de linguagem natural**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes de chat** e, em seguida, selecione **Criar agente de chat**.
1. Em **Novo agente de chat**, faça o seguinte:
1. Na caixa de entrada de texto, insira uma descrição em linguagem natural para o tipo de agente de bate-papo que você deseja criar. Esse é o prompt que o Amazon Quick usará para criar seu agente de chat. Você também pode usar os exemplos de instruções sugeridos na página para criar seu agente de chat.
1. Em seguida, selecione **Gerar**. Selecionar **Gerar** pega a instrução ou meta fornecida e a expande para as instruções e configurações do agente de chat. Ele também verifica os recursos disponíveis do usuário (espaços e conectores de ação) e encontra as correspondências mais relevantes com base na intenção fornecida pelo agente de bate-papo. A interface de usuário expandida do construtor é aberta com essas configurações para que o usuário revise, personalize, teste e inicie.
1. Na página **Configurar agente de chat**, certifique-se de que seu agente de chat tenha as configurações corretas e personalize-o ainda mais. Clique em **Atualizar visualização** para garantir que todas as alterações sejam salvas antes de você experimentar o agente de chat na visualização prévia.
1. Quando estiver pronto, selecione **Iniciar agente de chat** para publicar seu agente de chat personalizado na biblioteca de agentes de chat e usá-lo no chat.
**nota**
Até você selecionar **Iniciar agente de chat**, seu agente de chat não estará disponível na biblioteca de agentes de chat. Se você sair do processo de criação sem iniciar, a versão prévia será excluída e o agente de chat não será salvo.
Quando você inicia um agente de chat, ele permanece privado por padrão. O agente de chat só fica disponível nas bibliotecas de outros usuários depois que você o compartilha. Depois de compartilhados, edições e lançamentos subsequentes publicarão as alterações no mesmo agente de bate-papo para todos os usuários que tiverem acesso.
------
#### [ Using builder view directly ]
**Para criar um agente de chat personalizado usando o modo construtor**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes de chat** e, em seguida, selecione **Criar agente de chat**.
1. No **Agent Creator**, selecione **Ignorar**. Isso abre a página de configuração do agente de chat a partir da qual você pode criar e personalizar seu agente de chat.
1. Adicione um nome para seu agente de chat personalizado. Esse é o nome pelo qual seu agente de chat será identificado.
1. (Opcional) Adicione uma descrição para seu agente de chat personalizado que ajude os usuários a entender a finalidade do agente de chat.
1. (Opcional) Selecione um ícone para seu agente de chat.
1. Em **Configurar agente de chat**, personalize as seguintes seções:
1. No **AGENT PERSONA**, configure a personalidade, a identidade, o tom e o estilo de resposta do seu agente de chat:
+ Para **identidade do agente** — defina a identidade do seu agente de chat. Por exemplo, você pode dar instruções sobre o nome e a personalidade. O Amazon Quick usará padrões se for deixado em branco.
+ Para **instruções do Persona** — Adicione instruções sobre como seu agente de bate-papo interage com os usuários durante o bate-papo. Por exemplo, você pode definir quais são as principais tarefas do seu agente de chat. O Amazon Quick os usa para personalizar a personalidade do seu agente de chat.
1. Em **Estilo de comunicação**, em **Escolha uma predefinição de estilo de resposta** — Escolha um estilo de resposta. Você pode escolher entre as seguintes predefinições de estilo de resposta ou adicionar instruções personalizadas:
+ **Executivo** — Otimizado para comunicação comercial de alto nível e insights estratégicos.
+ **Técnico** — Otimizado para explicações técnicas detalhadas e solução técnica de problemas.
+ **Criativo** — Configuração padrão para interações de uso geral.
Cada predefinição tem as seguintes configurações:
+ Para **tom** — adicione uma solicitação de linguagem natural para definir o tom do seu agente. O Amazon Quick o usará para personalizar a personalidade do seu agente de bate-papo.
+ Para **formato de resposta** — adicione uma solicitação em linguagem natural para definir o estilo de resposta do seu agente de chat. O Amazon Quick o usará para personalizar o estilo de resposta do seu agente de chat. Defina o formato das respostas do seu agente de chat, por exemplo: “Use bullet points para listas com mais de 3 itens”.
+ Para **tamanho** — especifique o tamanho das respostas do seu agente de chat. Defina o tamanho das respostas do seu agente de chat, por exemplo: “Mantenha as respostas com menos de 100 palavras”.
Quando você escolhe uma predefinição para usar, o Amazon Quick preenche automaticamente as instruções de **tom**, **formato de resposta** e **duração** das respostas do seu agente de chat com base no estilo escolhido. Você pode personalizar ainda mais os prompts existentes usando linguagem natural ou criar novos.
1. Nos **documentos de referência**, faça upload de arquivos que permaneçam ativos na memória do seu agente de chat para orientar todas as interações. Para obter mais informações sobre como os documentos de referência funcionam com outros tipos de contexto, consulte [Tipos de contexto do agente](quicksuite/latest/userguide/agent-knowledge-sources-best-practices.html).
+ Selecione **Fazer upload de arquivos** ou arraste e solte seus documentos para anexar arquivos que guiarão as respostas do seu agente de chat.
+ Você pode anexar documentos no formato.pdf, .txt, .html, .md, .csv, .doc ou .docx. Até 100.000 caracteres de texto serão extraídos e aceitos dos documentos enviados.
1. (Opcional) Em **Fontes de conhecimento**, escolha entre as seguintes opções:
+ Continue sem vincular fontes de conhecimento
+ Seu agente de chat gerará respostas com base no conhecimento do Large Language Model (LLM) e de todos os recursos do Amazon Quick aos quais o usuário interativo tem acesso. Você pode escolher selecionar uma fonte de conhecimento específica para se concentrar durante o bate-papo. Escolha essa opção se quiser criar um agente de chat de uso geral.
+ Para vincular espaços específicos existentes
+ Selecione **Link**.
+ No modal **Link spaces**, selecione os espaços que você deseja vincular ao seu agente de chat e, em seguida, selecione **Link**.
O sistema exibe uma mensagem de sucesso para indicar uma vinculação bem-sucedida.
Se você vincular um agente de chat a uma fonte de conhecimento, seu agente de chat gerará respostas a partir do conhecimento do modelo de linguagem grande (LLM) e dados somente de recursos vinculados. Você pode adicionar até mais uma fonte de conhecimento a esse agente de bate-papo como contexto temporário durante o bate-papo.
+ Para criar e vincular um novo espaço
+ Escolha **Criar**.
+ Na janela **Criar espaço** que se abre, selecione os ativos que você deseja adicionar ao seu espaço e, em seguida, selecione **Criar**.
Se você vincular um agente de chat a uma fonte de conhecimento, seu agente de chat gerará respostas a partir do conhecimento do modelo de linguagem grande (LLM) e dados somente de recursos vinculados. Você pode adicionar até mais uma fonte de conhecimento a esse agente de bate-papo como contexto temporário durante o bate-papo.
**nota**
Para obter mais informações sobre como criar e usar espaços, consulte Como [trabalhar com espaços no Amazon Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-spaces.html).
O sistema exibe uma mensagem de sucesso para indicar a criação bem-sucedida do espaço. Volte para a janela de criação do agente de chat.
+ Na janela de criação do agente de chat, em **Fontes de conhecimento**, selecione **Link**.
+ No modal **Link spaces**, selecione o espaço que você acabou de criar e, em seguida, selecione **Link**.
O sistema exibe uma mensagem de sucesso para indicar uma vinculação bem-sucedida.
1. (Opcional) Em **Ações**, para **Ações** — Escolha entre as seguintes opções:
+ Para vincular ações específicas existentes
+ Selecione **Link**.
+ **No modal **Vincular conectores de ação**, selecione os conectores de ação que você deseja vincular ao seu agente de chat e, em seguida, selecione Avançar.**
+ Em **Ações**, selecione as ações que você deseja adicionar e, em seguida, selecione **Link**.
O sistema exibe uma mensagem de sucesso para indicar uma vinculação bem-sucedida.
+ Para criar um conector de ação e vincular novas ações
+ Escolha **Criar**.
+ Na página inicial de **Ações**, selecione **Nova ação**.
+ Na janela **Nova ação**, em **Fontes**, selecione o conector de ação que você deseja adicionar e, em seguida, selecione **Avançar**.
+ Em **Ações**, revise as ações disponíveis e selecione **Avançar**.
+ Em **Detalhes da conexão**, insira os detalhes da conexão necessários e selecione **Adicionar**.
**nota**
Para obter mais informações sobre como criar e usar conectores de ação, consulte [Ações no Amazon Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/qbs-actions.html).
O sistema exibe uma mensagem de sucesso para indicar a adição bem-sucedida da ação. Volte para a janela de criação do agente de chat.
+ Na janela de criação do agente de chat, em **Ações**, selecione **Link**.
+ **No modal **Link action connectors**, selecione o conector de ação que você acabou de criar e, em seguida, selecione Link.**
O sistema exibe uma mensagem de sucesso para indicar uma vinculação bem-sucedida.
1. Em **Personalização**, faça o seguinte:
1. Para **mensagem de boas-vindas** — Adicione uma mensagem de boas-vindas para seu agente de chat exibir ao usuário final.
1. Para **solicitações sugeridas** — adicione exemplos de solicitações para iniciar uma conversa para informar seus usuários finais sobre os recursos dos agentes de bate-papo.
1. Selecione **Iniciar agente de chat** para criar seu agente de chat personalizado.
**nota**
Até você selecionar **Iniciar agente de chat**, seu agente de chat não estará disponível na biblioteca de agentes de chat. Se você sair do processo de criação sem iniciar, a versão prévia será excluída e o agente de chat não será salvo.
Quando você inicia um agente de chat, ele permanece privado por padrão. O agente de chat só fica disponível nas bibliotecas de outros usuários depois que você o compartilha. Depois de compartilhados, edições e lançamentos subsequentes publicarão as alterações no mesmo agente de bate-papo para todos os usuários que tiverem acesso.
------
## Compartilhe agentes de bate-papo personalizados
Quando você cria um agente de chat, você é designado como seu proprietário por padrão. Você pode optar por compartilhar um agente de chat que você possui com outros usuários do Amazon Quick usando as seguintes permissões:
+ Permissões do *proprietário* — O usuário pode editar, compartilhar, usar e excluir o agente de chat.
+ Permissões do *visualizador* — O usuário pode visualizar e usar o agente de bate-papo.
Você também pode definir permissões de acesso para um agente de bate-papo globalmente, concedendo a todos os usuários acesso a um agente de bate-papo e, em seguida, definindo permissões de acesso mais granulares para usuários e grupos específicos.
O procedimento a seguir mostra como compartilhar e atribuir permissões aos agentes de chat.
**Para compartilhar agentes de chat personalizados**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na coluna **Ações** do agente de chat que você deseja compartilhar, selecione o ícone do menu e, em seguida, selecione **Compartilhar**.
1. No modal **Compartilhar agente de bate-papo** que se abre, insira o nome do usuário ou grupo com o qual você deseja compartilhar o agente de bate-papo. Quando o nome do usuário ou grupo aparecer, selecione-o. Repita a ação para todos os grupos ou usuários com os quais você deseja compartilhar o agente de chat. O modal exibe os usuários e grupos que você está adicionando.
1. Atribua permissões e informações de acesso para cada usuário ou grupo com o qual você está compartilhando seu agente de chat usando o menu suspenso ao lado do nome do usuário ou grupo. Você pode atribuir uma das duas funções:
+ **Proprietário — O** usuário pode editar, compartilhar e excluir o agente de bate-papo.
+ **Visualizador** — O usuário pode visualizar e usar o agente de bate-papo.
1. Selecione **Compartilhar**.
## Incorpore agentes de bate-papo personalizados
Você pode incorporar um agente de bate-papo personalizado em um site ou aplicativo externo para que os usuários possam interagir com ele fora do console do Amazon Quick. Para incorporar um agente de chat, você deve primeiro permitir o domínio de hospedagem nas configurações administrativas do Amazon Quick e, em seguida, gerar o código de incorporação a partir das opções de compartilhamento do agente de chat.
A incorporação de um agente de chat envolve duas etapas:
1. **Permitir o domínio de hospedagem** — Um administrador do Amazon Quick deve adicionar o domínio (e, opcionalmente, seus subdomínios) em que o agente de chat incorporado será hospedado à lista de permissões do domínio.
1. **Gere o código de incorporação** — O proprietário do agente de chat ou um usuário autorizado gera o código de incorporação a partir das opções de compartilhamento do agente de chat.
### Permitir um domínio para agentes de bate-papo incorporados
Antes de incorporar um agente de chat em um site externo, um administrador do Amazon Quick deve adicionar o domínio de hospedagem à lista de permissões. Você deve ser um administrador do Amazon Quick para concluir esse procedimento. Isso garante que somente domínios aprovados possam hospedar agentes de chat incorporados.
**Para permitir a incorporação de um domínio**
1. Faça login no console Amazon Quick.
1. Escolha o ícone do perfil.
1. Escolha **Gerenciar conta**.
1. No painel de navegação, em **Segurança**, escolha **Gerenciar domínios**.
1. No campo **Domínio**, insira o nome do domínio em que você deseja hospedar o agente de bate-papo incorporado (por exemplo,`https://example.com`).
1. (Opcional) Selecione **Incluir subdomínios** para permitir agentes de bate-papo incorporados em todos os subdomínios do domínio especificado.
1. Escolha **Adicionar**.
O domínio agora aparece na lista de domínios permitidos. Você pode editar ou excluir domínios existentes escolhendo os ícones de edição ou exclusão ao lado de cada domínio na lista.
### Gere o código de incorporação para um agente de chat
Depois de permitir o domínio de hospedagem, você pode gerar o código de incorporação para um agente de chat.
**Para gerar o código de incorporação para um agente de chat**
1. Faça login no console Amazon Quick.
1. No painel de navegação, escolha **Agentes do Chat**.
1. Na coluna **Ações** do agente de chat que você deseja incorporar, escolha o ícone do menu e, em seguida, escolha **Editar**.
1. No editor do agente de chat, escolha **Compartilhar**.
1. Nas opções de compartilhamento, escolha **Compartilhar via incorporação**.
1. Copie o código de incorporação fornecido e cole-o no HTML do seu site ou aplicativo onde você deseja que o agente de bate-papo apareça.
O agente de bate-papo incorporado agora está disponível em seu site. Os usuários que visitam a página podem interagir diretamente com o agente de bate-papo.
## Atualizar agentes de chat personalizados
Você pode atualizar agentes de chat personalizados no Amazon Quick a partir do menu **Agentes** na página inicial do Amazon Quick. O procedimento a seguir descreve como fazer isso.
**nota**
Você pode visualizar o desempenho das atualizações de personalização do seu agente de chat, conforme você configura o agente de chat, na interface de pré-visualização do chat. Certifique-se de selecionar **Pré-visualização da atualização** antes de testar uma alteração. Depois que todas as alterações forem testadas na versão prévia, selecione **Iniciar** para publicar as alterações no agente de chat atualmente em uso.
**Para atualizar um agente de chat personalizado**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na coluna **Ações** do agente de chat que você deseja compartilhar, selecione o ícone do menu e selecione **Editar**. Isso cria uma versão prévia do seu agente de chat para atualizar e testar antes de publicar.
1. Em **Editar agente**, atualize as configurações do agente de chat e selecione **Iniciar**.
## Gerencie o acesso a um agente de chat personalizado
Se você for o proprietário de um agente de chat, você pode optar por alterar as permissões de acesso do usuário para um agente de chat. Você também pode remover o acesso de usuários e grupos a um agente de chat. O procedimento a seguir mostra como fazer isso.
**Para gerenciar o acesso a agentes de chat personalizados**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na coluna **Ações** do agente de chat que você deseja compartilhar, selecione o ícone do menu e, em seguida, selecione **Compartilhar**.
1. No modal **Compartilhar agente de bate-papo** que se abre, selecione o usuário e o grupo para os quais você deseja alterar as permissões. Quando o nome do usuário ou grupo aparecer, selecione-o e altere as permissões. Repita a ação para todos os grupos ou usuários para os quais você deseja alterar as permissões. O modal exibe as permissões de usuários e grupos que você está alterando. Você pode realizar as três ações a seguir:
+ Alterar para **proprietário — O** usuário pode editar, compartilhar e excluir o agente de bate-papo.
+ Alterar para **Visualizador** — O usuário pode visualizar e usar o agente de bate-papo.
+ **Remover acesso** — Remova o acesso de usuário ou grupo a um agente de chat.
**nota**
Você também pode definir permissões de acesso a um agente de bate-papo globalmente, concedendo a todos os usuários acesso a um agente de bate-papo e, em seguida, definindo permissões de acesso mais granulares para usuários e grupos específicos. Para fazer isso, escolha **Configurações** e, em seguida, use **Configurações globais** para ativar ou desativar esse recurso.
1. Selecione **Compartilhar**.
## Veja os agentes de chat
Você pode ver uma lista dos agentes de chat que você criou ou aos quais tem acesso. O procedimento a seguir mostra como fazer isso.
**Para visualizar agentes de chat personalizados**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Os agentes de chat que você criou ou aos quais tem acesso serão exibidos na página inicial dos **agentes do Chat**.
## Exibir detalhes do agente de chat
Você pode ver os detalhes dos agentes de chat criados por você ou compartilhados com você, incluindo todos os espaços e ações anexados a cada agente de chat.
**Para ver os detalhes do agente de chat**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na lista de agentes de chat, na coluna **Nome**, clique no nome do agente de chat do qual você deseja ver detalhes. Um modal detalhado será aberto.
**nota**
Você também pode visualizar os detalhes do agente de chat navegando até a coluna **Ações** do agente de chat que você deseja compartilhar, selecionando o ícone do menu e, em seguida, selecionando **Exibir detalhes do agente de chat**.
1. No modal de detalhes do agente de bate-papo que se abre, você verá os seguintes detalhes:
1. **Descrição** — A descrição do agente de chat.
1. **Resumo da instrução** — Um resumo das instruções definidas para o agente de chat.
1. **Criado por** — Detalhes sobre se o agente de chat foi criado por você ou por outra pessoa.
1. **Última modificação** — A hora em que o agente de chat foi modificado pela última vez.
1. Em **Capacidades**:
+ **Conhecimento** — As fontes de conhecimento às quais o agente de chat está vinculado ou às quais tem acesso. Se seu agente de chat estiver vinculado a um espaço, você poderá ver a qual espaço ele está vinculado.
+ **Ações** — As ações às quais o agente de chat está vinculado ou às quais tem acesso. Você também pode ver isso clicando nas **informações** ao lado do nome do agente no seletor de agentes da interface de usuário do chat.
## Agentes de bate-papo personalizados duplicados
Você pode duplicar agentes de chat personalizados existentes sem criar um agente de chat do zero. Os usuários podem duplicar agentes de chat da página da lista usando o botão **Duplicar** ação. Quando você duplica um agente de chat, o Amazon Quick cria um novo agente de chat com o formato de nome “[Nome original] (cópia)”, que você pode editar. Todos os campos e configurações do agente de bate-papo original são copiados para a nova versão do agente de bate-papo. Depois de duplicado, você pode atribuir permissões personalizadas de acesso do usuário ao agente de bate-papo duplicado e compartilhá-lo.
O procedimento a seguir descreve como duplicar agentes de chat.
**Para duplicar agentes de chat personalizados**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na coluna **Ações** do agente de chat que você deseja compartilhar, selecione o ícone do menu e, em seguida, selecione **Duplicar**.
Você será redirecionado para um modal de duplicação do agente de bate-papo com campos pré-preenchidos.
1. Faça as alterações necessárias, incluindo adicionar as permissões corretas de usuário e grupo e vinculá-las aos ativos desejados e, em seguida, selecione **Iniciar para iniciar** seu agente de chat duplicado.
## Excluir agentes de chat
Você pode excluir um agente de chat Amazon Quick de sua propriedade. O procedimento a seguir mostra como fazer isso.
**Para excluir um agente de chat personalizado**
1. Faça login no console Amazon Quick.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na coluna **Ações** do agente de chat que você deseja compartilhar, selecione o ícone do menu e selecione **Excluir**.
# Fontes de contexto e melhores práticas do agente de chat
Ao criar agentes de bate-papo personalizados no Amazon Quick, você tem várias opções para influenciar o comportamento do agente de bate-papo e estruturar os fluxos de trabalho do agente de bate-papo. A maneira como você configura o contexto e as instruções do agente de bate-papo afeta significativamente o desempenho e a resposta do agente de bate-papo às interações do usuário. Entender quando usar instruções, documentos de referência e espaços é crucial para criar agentes de bate-papo eficazes que atendam às suas necessidades comerciais específicas e forneçam resultados consistentes e confiáveis. As seções a seguir descrevem a melhor forma de usar o contexto e o conhecimento do agente de chat para seu caso de uso.
**Topics**
+ [Tipos de contexto do agente](#knowledge-source-types)
## Tipos de contexto do agente
O Amazon Quick fornece três métodos distintos para configurar o comportamento do agente de chat, cada um servindo a propósitos diferentes no desenvolvimento do agente de chat. Entender como cada método processa o conteúdo e quando usá-lo forma a base de uma configuração eficaz do agente de chat chat.
Os três tipos de contexto disponíveis no Amazon Quick são:
+ **Instruções de persona** — orientação de alto nível que o Amazon Quick aprimora usando generativas AI
+ **Documentos de referência** — Documentos que fornecem instruções exatas e permanecem ativos na memória do agente de bate-papo
+ **Spaces** — Coleções de recursos e documentos pesquisáveis do Amazon Quick a partir dos quais agentes de chat recuperam informações para responder perguntas
A seção a seguir detalha o que são e as melhores práticas para usá-las.
**Topics**
+ [Instruções pessoais do agente de chat](#agent-instructions)
+ [Documentos de referência do agente de chat](#in-context-files)
+ [Agentes e espaços de bate-papo](#spaces)
### Instruções pessoais do agente de chat
Você fornece instruções de persona do agente de chat no campo **Instruções de persona** ao criar seu agente de chat personalizado. Essas instruções de persona são refinadas usando IA generativa para garantir que funcionem com todos os recursos de bate-papo e os recursos configurados para o agente de bate-papo. Essa abordagem é ideal quando você deseja que o sistema se baseie em sua direção fundamental. Quando você usa instruções pessoais, o Amazon Quick usa o generativo AI para interpretar e expandir suas instruções de persona no back-end, ampliar a orientação simples com contexto e recursos adicionais, otimizar a solicitação para melhorar o desempenho do agente de chat e aumentar a eficácia por meio de melhorias orientadas. AI
**Use instruções pessoais para:**
+ Forneça orientações de alto nível sobre comportamento e metas, que são aprimoradas pelo Amazon Quick AI para personalizar as respostas dos agentes
+ Instrua como utilizar documentos de referência para interações detalhadas
+ Fornecer orientação geral sobre o uso de espaços e conectores de ação em suas respostas
Essa abordagem funciona melhor para agentes de chat de uso geral e casos de uso exploratório em que você deseja se beneficiar da AI assistência no design de agentes de chat.
**nota**
O processo de AI aprimoramento pode modificar sua redação e estrutura originais para melhorar o desempenho do agente de bate-papo. Em vez disso, diretrizes críticas que devem permanecer inalteradas devem ser colocadas em documentos de referência.
### Documentos de referência do agente de chat
Os documentos de referência fornecem modelos específicos de processos e respostas que os agentes de chat precisam seguir. Esses documentos de referência fazem parte do contexto permanente do agente de bate-papo e incluem hand-in-hand instruções pessoais e estilo de resposta para informar seu comportamento geral.
Os documentos de referência fornecem controle total sobre o comportamento do agente de bate-papo, preservando seu conteúdo exatamente como está escrito. Essa abordagem é essencial quando a precisão e a consistência são fundamentais. Quando você carrega documentos de referência, o Amazon Quick preserva o texto preciso e as instruções específicas, mantém a formatação e a estrutura exatas, fornece controle direto sobre o comportamento do agente de bate-papo e garante a consistência em todas as interações.
**Use documentos de referência quando precisar:**
+ Controle exato onde palavras precisas e instruções específicas devem ser preservadas
+ Consistência da marca com tom, terminologia ou formatos de resposta específicos
+ Fluxos de trabalho complexos com processos de várias etapas que devem seguir sequências exatas
+ Comportamento previsível com respostas consistentes em todas as interações
**Formatos de arquivo suportados:**
+ `.pdf`,`.txt`,`.html`, `.md` — Instruções, modelos e diretrizes
+ `.csv`— Dados de referência, tabelas de pesquisa e exemplos
+ `.doc`, `.docx` — Documentação detalhada do processo
Você pode anexar até 10 arquivos de tamanho total de 50 MB como documentos de referência. O Amazon Quick extrai texto desses documentos e aplica um limite de 100 mil caracteres após o processamento.
**Priorização e comportamento de arquivos**
As estruturas comportamentais e os dados de referência dos arquivos permanecem ativos mesmo quando os usuários anexam conteúdo alternativo.
Os modelos de resposta podem ser ajustados temporariamente se os usuários fornecerem instruções de formatação conflitantes.
Os documentos de referência servem como manual operacional do agente de chat, fornecendo a estrutura comportamental que permanece constante em todas as interações do usuário com o agente de chat.
### Agentes e espaços de bate-papo
Os espaços fornecem repositórios de conhecimento dinâmicos e pesquisáveis que os agentes de bate-papo consultam durante as conversas para recuperar informações específicas. Quando você vincula espaços a agentes de chat, os agentes de chat do Amazon Quick procuram respostas dentro do espaço para gerar respostas. O Spaces é excelente no gerenciamento do conhecimento organizacional que evolui com o tempo, permitindo que vários membros da equipe contribuam e atualizem informações, mantendo os limites de segurança adequados por meio do sistema de permissões do Amazon Quick.
Use espaços com agentes de bate-papo para:
+ Permitindo que agentes de chat pesquisem e recuperem dados comerciais atuais
+ Fornecendo aos agentes de bate-papo acesso aos repositórios de conhecimento organizacional
+ Permitir que os agentes de chat respeitem os limites de permissão existentes
+ Conectando agentes de bate-papo a coleções colaborativas de documentos
+ Dar aos agentes de chat acesso a informações atualizadas regularmente
+ Permitir que agentes de chat consultem painéis e conjuntos de dados ao vivo
Os espaços funcionam como a camada de conhecimento dinâmica do agente de bate-papo, permitindo acesso em tempo real às informações organizacionais, mantendo os limites de segurança e os fluxos de trabalho colaborativos.
# Use um agente de chat
Você pode usar um agente de chat Amazon Quick para fazer perguntas e realizar suas tarefas. Quando você faz uma pergunta, o agente de chat analisa os dados aprovados mais recentes compartilhados com você para gerar uma resposta abrangente.
Você pode fazer perguntas complexas em linguagem simples e obter uma resposta detalhada. Você também pode usar um agente de chat rápido para realizar tarefas para você, como redigir uma mensagem de e-mail, criar um ticket ou usar fluxos.
**Para usar agentes de chat personalizados**
1. Faça login no console rápido.
1. No menu de navegação à esquerda, selecione **Agentes do Chat**
1. Em seguida, na coluna **Ações** do agente de chat que você deseja compartilhar, selecione o ícone do menu e, em seguida, selecione **Chat**.
Isso abrirá uma interface de bate-papo que você usa para interagir com seu agente de bate-papo.
Você pode interagir com um agente de chat das seguintes formas:
+ Visualize e acesse exemplos de instruções para demonstrar possíveis perguntas e tarefas
+ Obtenha respostas contextuais de fontes de dados organizacionais
+ Continue ou inicie novas conversas
+ Analise dados, incluindo resumo e análise comparativa
+ Realize ações como agendar reuniões e criar tickets
+ Visualize as citações de origem das respostas com referências numeradas clicáveis
+ Fazer upload de arquivos
+ Exibir histórico de conversas
**dica**
Você também pode usar seus agentes de bate-papo enquanto automatiza suas tarefas rotineiras com o Quick Flows. Para obter mais informações, consulte [Agente de bate-papo](ai-response-steps.md#chat-agent-step).
Para saber mais sobre como conversar usando agentes de bate-papo, consulte [Usando o Amazon Quick Chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html).