Personalização do chat integrado do Amazon Quick permite alinhar interface e tom de voz ao padrão da aplicação
A Amazon Web Services publicou um guia técnico detalhando como personalizar o chat integrado do Amazon Quick, recurso de inteligência artificial conversacional que pode ser embarcado diretamente em aplicações web. Segundo a publicação, sem ajustes adequados, a interface de chat tende a parecer um elemento externo colado ao sistema, prejudicando a experiência do usuário. A solução envolve configurações que vão desde a aparência visual até o estilo de comunicação do assistente.
O Amazon Quick embedded chat funciona como uma interface de IA conversacional que permite aos usuários fazer perguntas, explorar dados e obter respostas sem sair da aplicação em que estão trabalhando. Para que essa integração seja realmente natural, a AWS destaca que a personalização precisa ocorrer em duas frentes complementares. A primeira é o tema visual, que deve seguir os padrões visuais já estabelecidos pela marca da empresa. A segunda é o tom de voz, já que a consistência visual isolada não garante que o assistente se comunique de acordo com a personalidade da organização.
A documentação utiliza como exemplo um assistente de análise financeira integrado a um painel de desempenho corporativo. Nesse cenário, o chat aparece inicialmente com a aparência padrão, o que gera um descompasso visual evidente em relação ao restante do dashboard, com paleta de cores diferente e elementos genéricos que destoam do ambiente. A personalização busca justamente reverter essa sensação de componente externo.
Para ajustar o tema visual, a empresa explica que o trabalho ocorre em dois níveis. O primeiro é a estilização do contêiner e do layout que envolve o chat, controlado por CSS, que é uma linguagem de estilização usada para definir cores, fontes e posicionamento de elementos em páginas web. O segundo são as opções de quadro do SDK, que é o conjunto de ferramentas de programação fornecido pela AWS para incorporação do chat, responsáveis por controlar o comportamento e os elementos de identidade visual. Como o chat é renderizado dentro de um iframe, uma área isolada que carrega conteúdo de forma independente, não é possível modificar seus elementos internos diretamente, sendo necessário estilizar o contêiner externo e usar opções do SDK para remover elementos padrão da marca.
Entre as opções de configuração estão a definição de uma classe CSS personalizada aplicada ao iframe, a exibição de um espaço de carregamento enquanto o conteúdo é preparado, e o controle de permissões da área de transferência do navegador. Também é possível definir largura e altura responsivas, que se ajustam automaticamente ao tamanho da tela do usuário. No exemplo financeiro, o chat é posicionado como um painel lateral fixo à direita, com sombra, animação de entrada e cabeçalho que reproduz o gradiente de cores do dashboard principal.
A remoção da marca padrão é outro ponto abordado. Por padrão, o chat exibe uma atribuição da Amazon Quick e um link para a política de uso no rodapé. Para uma experiência em que o assistente pareça um componente nativo da aplicação, esses elementos podem ser desativados por meio de opções específicas do SDK. Após essas configurações, o painel passa a refletir o mesmo gradiente de cores, o rodapé fica limpo e a aparência geral se alinha ao sistema de design da aplicação.
Além da aparência, a publicação dedica atenção à configuração da persona do agente, ou seja, o estilo de comunicação que o assistente adota. Sem essa configuração, as respostas tendem a ser genéricas e pouco contextualizadas, sem refletir a expertise do domínio nem o jeito da organização se comunicar. No exemplo citado, uma pergunta sobre a receita do trimestre anterior recebe uma resposta vaga, explicando apenas o conceito de receita e sugerindo a consulta a demonstrações financeiras, sem qualquer informação específica da empresa.
Para resolver isso, a AWS recomenda o uso de um agente personalizado, configurado no console do Amazon Quick. Por meio de opções do SDK, é possível fixar o agente que será utilizado, definir uma mensagem inicial automática para iniciar a conversa de forma proativa, permitir o envio de arquivos, ativar a busca na web e exibir o histórico de conversas. Há ainda a opção de mostrar ao usuário quais fontes de dados o assistente pode acessar, o que aumenta a transparência sobre os limites do conhecimento da ferramenta.
No console do Amazon Quick, durante a criação do agente de chat, são definidas as instruções de persona que moldam o comportamento do assistente. Essas instruções podem determinar o estilo de resposta, como começar pela resposta direta e pelo número principal, fornecer contexto comparativo com períodos anteriores, citar documentos de origem e manter objetividade. Também é possível estabelecer limites, restringindo o escopo das respostas e indicando canais de contato para dúvidas fora do alcance do agente.
Com essas configurações aplicadas, a mesma pergunta sobre receita do trimestre passa a retornar uma resposta direta, com o valor exato, a variação em relação ao período anterior e o detalhamento por mês e por região. O resultado reflete o estilo de comunicação esperado pela equipe financeira, com foco em dados e contexto organizacional.
A publicação também apresenta o método sendPrompt(), que permite à própria aplicação enviar perguntas ao chat em resposta a interações do usuário, como cliques em botões ou seleção de métricas em gráficos. No exemplo do dashboard financeiro, botões de ação rápida para receita, margens e despesas disparam perguntas contextuais ao assistente, conectando os elementos visuais do painel com a interface conversacional.
Ao final, a AWS resume que a combinação de ajustes visuais via CSS, opções do SDK e instruções de persona no console permite entregar uma experiência integrada e alinhada à identidade da aplicação. A recomendação é começar embarcando o chat, aplicar a paleta de cores e o layout da marca por meio do contêiner e das opções de quadro, e em seguida criar um agente personalizado no console com instruções que reflitam o domínio e o estilo de comunicação da organização.
