Integração com agentes IA
Visão Geral
Uma vez que seu Catálogo de Vendas está configurado com produtos, categorias e propriedades, você pode conectá-lo a um ou mais agentes IA. Quando um agente está conectado, seus clientes podem perguntar por produtos em linguagem natural —"vocês têm casacos impermeáveis?", "algo de menos de R$500", "cor azul tamanho M"— e o agente busca no catálogo, filtra pelos critérios mencionados e responde com resultados concretos: nome, preço a partir de, marca, variantes disponíveis. A conexão é por agente, não no nível da conta: você pode escolher qual agente consulta o catálogo e restringi-lo a um ramo da árvore de categorias.
Como Acessar
- Navegue até Ferramentas > Aurora AI > Base de Conhecimento no agente que você quer configurar.
- Selecione a aba Catálogo de Vendas.
- Função necessária: Administrador de Chatbot.
Visão Geral da Interface
A aba Catálogo de Vendas dentro de Base de Conhecimento exibe:
- Um interruptor de ativação para conectar/desconectar o catálogo do agente.
- Quando ativo, um seletor de categoria limite opcional —para restringir o que o agente pode ver a um ramo da árvore.
- Um painel informativo que explica os requisitos (modelo Avançado) e o alcance (o agente pode consultar todos os produtos do catálogo em status Ativo).
Requisito do modelo Avançado
O Catálogo de Vendas usa busca híbrida —combinando compreensão semântica com filtros estruturados— e requer um modelo IA com capacidades suficientes. Por isso, ao ativar o catálogo, se o agente não estiver usando o modelo Avançado, a Aurora pedirá sua confirmação para atualizá-lo automaticamente ao modelo Avançado.
Enquanto o catálogo estiver ativo no agente, você não poderá rebaixar o modelo a partir da aba de configuração do agente: a opção aparece bloqueada com uma indicação clara. Se você precisa mudar o modelo, primeiro desative o catálogo nesse agente.
Limite por categoria (opcional)
Depois de ativar o catálogo, opcionalmente você pode restringir o agente a uma categoria e todos os seus descendentes. Útil quando um mesmo catálogo serve a vários agentes com responsabilidades distintas:
- Um agente de "Cuidado do lar" vê apenas esse ramo da árvore.
- Um agente de "Eletrônicos" vê outro ramo distinto.
- Um agente geral vê todo o catálogo (sem restrição).
O limite é aplicado do lado do servidor: o agente nunca recebe nem menciona produtos fora do seu ramo, independentemente de como o cliente se expressa.
Funcionalidades e Ações
Ativar o catálogo em um agente
O que faz: Conecta o Catálogo de Vendas ao agente.
Passos:
- Abra o agente e navegue até Base de Conhecimento > aba Catálogo de Vendas.
- Ative o interruptor.
- Se o agente não usa o modelo Avançado, aparece um diálogo de confirmação: "Ativar e atualizar modelo". Confirme para continuar.
- (Opcional) Selecione uma categoria limite para restringir o alcance do agente.
- As mudanças são salvas automaticamente.
Notas importantes:
- Apenas os produtos em status Ativo são visíveis para o agente. Os produtos em Rascunho, Descontinuado ou Arquivado são ignorados.
- As propriedades personalizadas são expostas ao agente automaticamente —você não precisa configurá-las em cada agente.
Mudar a categoria limite
O que faz: Restringe (ou amplia) o alcance do agente sobre o catálogo.
Passos:
- Com o catálogo ativo, abra o seletor de Categoria limite.
- Escolha uma categoria —o agente verá essa categoria e todas as suas subcategorias.
- Para tirar o limite, deixe a categoria em "Sem restrição" (todo o catálogo).
Desativar o catálogo em um agente
O que faz: Desconecta o catálogo. O agente deixa de ter acesso aos produtos.
Passos:
- Desative o interruptor.
- Confirme. Uma vez desativado, você pode voltar a mudar o modelo do agente se quiser.
Testar a busca do agente
O que faz: Verifica como o agente responde a perguntas reais antes de levá-lo a produção.
Passos:
- Uma vez ativado o catálogo, abra o chat de teste do agente.
- Faça perguntas em linguagem natural, por exemplo:
- "O que vocês têm em cuidado do lar?"
- "Algo cor azul tamanho M?"
- "Produtos de menos de R$500"
- "Vocês têm X marca?"
- O agente deve responder com produtos concretos: nome, preço a partir de, marca e, quando aplicável, as opções de variantes.
Como o agente usa o catálogo
Quando um cliente faz uma pergunta de produto, o agente IA:
- Passa a consulta exatamente como o cliente a disse ao motor de busca híbrida. Não adiciona filtros que o cliente não mencionou (por exemplo, se o cliente diz "um moletom", o agente busca "moletom" —não adiciona "para homem" ou "para mulher").
- Quando o cliente sim menciona um atributo concreto (cor, marca, preço máximo, uma propriedade personalizada), o agente o traduz em um filtro estruturado e o aplica.
- O motor combina compreensão semântica (entende sinônimos: "casaco" = "jaqueta" = "blusão") com palavras-chave e filtros estruturados e devolve os resultados mais relevantes.
- O agente apresenta esses resultados de forma natural na conversa —não como uma tabela crua, mas integrados à resposta.
Se uma busca não retorna resultados, o agente pode oferecer relaxar um dos filtros ("Não encontrei nada na cor azul tamanho M; quer ver outros tamanhos em azul?") em vez de simplesmente dizer "não há".
Boas práticas
Garanta que os produtos estejam em Ativo
A causa mais comum de "o agente não menciona meu produto" é que o produto está em Rascunho ou Arquivado. Mude o status para Ativo antes de testar.
Preencha a marca e a categoria
A marca e a categoria são filtros frequentes ("vocês têm marca X?", "me mostre algo de Y categoria"). Ter ambos os campos preenchidos melhora notavelmente a precisão.
Defina propriedades personalizadas claras
Se seu negócio diferencia produtos por cor, tamanho, peso, voltagem ou qualquer outro atributo, defina propriedades personalizadas com nomes claros. O agente as usa para filtrar com precisão.
Use o limite por categoria
Se você tem vários agentes para linhas de negócio distintas, restrinja cada um ao seu ramo. Melhora a pertinência das respostas e evita que um agente recomende produtos fora do seu contexto.
Teste com perguntas reais
Antes de expor o agente a clientes, teste com as perguntas mais comuns que seu time de atendimento recebe. Se o agente não as responde bem, costuma ser um problema de dados —não de configuração. Revise a marca, a categoria e as propriedades do produto.
Notas Importantes
- A ativação por agente é independente dos Catálogos do Aurora AI (
/aurora-ai/catalogs). Você pode usar ambos ao mesmo tempo em agentes diferentes ou no mesmo —são fontes de dados complementares. - Quando você adiciona produtos novos ao catálogo, o agente pode demorar alguns minutos para começar a recomendá-los por busca semântica. Enquanto isso, a busca por palavras e os filtros estruturados já os encontram.
- O uso do catálogo por agentes contribui ao consumo de mensagens IA segundo seu plano; não há um custo adicional por ativar o catálogo.
Perguntas Frequentes
P: Por que a Aurora me pede para mudar o modelo do agente ao ativar o catálogo? R: A busca híbrida e o manejo correto de filtros estruturados requerem um modelo com capacidade suficiente. O modelo Avançado garante que o agente entenda perguntas complexas e filtre com precisão.
P: Posso ativar o catálogo em vários agentes ao mesmo tempo? R: Sim. Cada agente é configurado separadamente, com seu próprio limite de categoria, se aplicável.
P: Como evito que o agente recomende produtos fora do segmento que ele atende? R: Use o limite por categoria. O agente respeita o ramo da árvore e nunca menciona produtos fora da subárvore atribuída.
P: O que faço se o agente "inventa" atributos ao buscar? R: A Aurora está configurada para não adicionar contexto que o cliente não forneceu. Se você observar que o agente está adicionando filtros não solicitados, reporte —é um problema que levamos a sério porque degrada a qualidade dos resultados.
P: O agente pode adicionar produtos ao carrinho ou fechar a venda? R: Por enquanto, a integração é de consulta e recomendação. O fechamento da venda continua acontecendo pelos canais comerciais habituais (seu time humano, sua loja online, etc.).