> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/bienvenido-a-vambe/bienvenido-a-vambe-pt-br/como-funciona-o-vambe-conceitos-essenciais/passo-5-o-que-e-um-assistente-de-inteligencia-artificial-no-vambe.md). # Passo 5: O que é um assistente de inteligência artificial no Vambe? ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/UfiTwHOVF8oY0Sncg1Mq/image%20png%20Nov%2019%202025%2009%2025%2031%207010%20PM.png) Um **assistente de inteligência artificial na Vambe** é uma configuração composta por vários blocos que, em conjunto, definem como um assistente dentro de um funil pensa, responde, age e processa informações. Não é um único texto, mas um **modelo modular** construído por partes, semelhante a montar uma estrutura com peças de Lego: cada bloco contribui com informações ou regras específicas, e ao combinar todos os blocos forma-se o comportamento final do assistente. *** ### Como um assistente é estruturado? Um assistente na Vambe é construído a partir de três grandes grupos de blocos: {% stepper %} {% step %} ### Blocos de Identidade ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/8K5OOyaFhgOmgd5jZ8aZ/image%20png%20Nov%2021%202025%2012%2017%2051%204555%20PM.png) Os **Blocos de Identidade** definem a essência do assistente na Vambe. Determinam quem ele é, como deve se expressar e qual é o seu propósito dentro do funil. Esses blocos **não podem se repetir**, já que representam a identidade central do assistente e funcionam como sua base estrutural. Os blocos que compõem esta categoria são: * Personificação * Objetivo * Formato de resposta #### Personificação ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/O46ytkyYzbU2JF78oMHg/image%20png%20Nov%2021%202025%2012%2027%2021%202487%20PM.png) A personificação estabelece **a personalidade e o papel profissional** a partir do qual o assistente se comunica. Aqui se define quem é o assistente, como ele pensa, que tom utiliza e com qual nível de autoridade ou expertise responde. Exemplos de personificação: * Um especialista em vendas com tom persuasivo. * Um especialista em atendimento ao cliente, empático e resolutivo. * Um consultor técnico que explica processos de forma clara e precisa. A personificação determina: tom de voz, estilo de comunicação, vocabulário e atitude diante das perguntas do usuário. É a personalidade completa do assistente. #### Objetivo ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/AfGWWNsnCp9FoBoDHZXY/image%20png%20Nov%2021%202025%2012%2031%2057%204431%20PM.png) O objetivo define **o que o assistente deve alcançar** dentro do funil. Deve ser escrito com extrema clareza, pois qualquer mudança na sua redação modifica por completo o comportamento da inteligência artificial. Exemplos práticos: * “Ajudar o usuário a realizar exercícios” = orientar, guiar e acompanhar. * “Resolver os exercícios pelo usuário” = entregar diretamente a resposta. O objetivo deve ser específico, claro, não ambíguo e direto. É a bússola do assistente. #### Formato de resposta ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/9lgccoOPkrtYdbIQKQbe/image%20png%20Nov%2021%202025%2012%2033%2040%202008%20PM.png) Define **como redige e organiza as informações** o assistente: extensão aproximada, uso de emojis, nível de detalhe, ordem dos elementos (títulos, parágrafos, listas, passos), inclusão de links/arquivos/imagens e estilo geral de redação (formal, conciso, explicativo, técnico etc.). Garante respostas consistentes e alinhadas à marca. **Importante:** Esses três blocos não podem se repetir: um assistente só pode ter uma única personificação, um único objetivo e um único formato de resposta. {% endstep %} {% step %} ### Blocos de Instrução ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/nnca7w7wFUlkvo0XjYWj/image%20png%20Nov%2021%202025%2012%2018%2031%201425%20PM.png) Os **Blocos de Instrução** guiam o comportamento do assistente. Funcionam como regras operacionais que determinam como a inteligência artificial deve agir diante de diferentes cenários e situações dentro do funil. Diferentemente dos Blocos de Identidade, estes **podem sim se repetir e ser somados**. Os Blocos de Instrução são compostos por: * Passos a seguir * Casos possíveis * Não fazer * Etiquetas * Comportamento predefinido #### Passos a seguir ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/guvZCYvtJoxRaj1tOoO8/image%20png%20Nov%2021%202025%2012%2045%2026%201672%20PM.png) Define a **sequência operacional** que o assistente deve executar enquanto conversa com o cliente: a lógica passo a passo para cumprir seu objetivo. O criador deve decidir explicitamente a ordem das ações. Exemplo de fluxo: * Primeiro cumprimentar o cliente. * Depois solicitar seu RUT para obter suas informações internas. * Depois apresentar uma oferta. * Por fim, guiá-lo para um agendamento ou fechamento de venda. #### Casos possíveis ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/porWxuNlj97MQcV7ExSm/image%20png%20Nov%2024%202025%2001%2004%2027%207308%20PM.png) É utilizado para gerenciar situações que não fazem parte do fluxo principal. No lado esquerdo é definida a “Causa” e no lado direito a “Ação” que a IA deve executar. Exemplos: clientes que reclamam, pedem para falar com um humano, consultas de pós-venda em um funil de vendas ou assuntos diferentes do funil atual. #### Não fazer ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/GO37Er2g2M3DxJuCvsmn/image%20png%20Nov%2024%202025%2001%2008%2033%206514%20PM.png) Define explicitamente as ações proibidas, mesmo que a IA detecte informações disponíveis. Mantém coerência, privacidade e controle. Exemplos: não revelar classificações internas, não dizer “não atende aos requisitos”, não inventar preços, não fornecer diagnósticos médicos, não agendar em horários proibidos. #### Etiquetas ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/RL09ke9ClA7Ka9ioP6CU/image%20png%20Nov%2024%202025%2001%2011%2001%207550%20PM.png) Permite adicionar etiquetas automáticas aos tickets conforme condições específicas. Para usar este bloco: 1. Criar a etiqueta. 2. Definir claramente uma descrição de qual condição deve aplicá-la a IA. Exemplo: * Etiquetas: Pequeno, Médio, Grande * Descrição: Você deve etiquetar o cliente dependendo do tamanho do pedido: * 1 a 5: Pequeno * 6 a 10: Médio * 10 ou mais: Grande As etiquetas ajudam a segmentar, automatizar e classificar os tickets. #### Comportamento predefinido ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/nSmS0epEKl3PfX2DlsNM/image%20png%20Nov%2024%202025%2001%2018%2005%201411%20PM.png) É utilizado para enviar uma **mensagem fixa**, sempre igual, quando a IA detecta frases ou situações muito específicas. Exemplo: diante de mensagens como “Meu produto chegou errado”, “Meu pedido ainda não chegou”, “Quero fazer uma reclamação.”, o assistente pode responder automaticamente com uma mensagem predefinida (por exemplo, um e-mail de pós-venda). Cuidado: a mensagem será sempre a mesma e a IA não analisa contexto adicional; não deve ser usada em cenários complexos em que coexistam vários temas. {% endstep %} {% step %} ### Blocos de Informação ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/Kb4N9uJafWb8vMMhOstC/image%20png%20Nov%2021%202025%2012%2019%2013%205468%20PM.png) Os **Blocos de Informação** fornecem os dados que o assistente utiliza para responder corretamente. São a base de conhecimento e **podem sim se repetir, ser ampliados e combinados**. #### Informações da loja ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/groX2judjlDCdDKdy3TV/image%20png%20Nov%2024%202025%2002%2008%2004%201532%20PM.png) Contém detalhes gerais do negócio: endereço, como chegar, idioma principal, horários de atendimento, modalidades de entrega, políticas gerais e condições comerciais relevantes. A utilidade da IA depende da qualidade e da atualização dessas informações. #### Informações-chave ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/unC7PmeMYmDovK9lThkT/image%20png%20Nov%2024%202025%2002%2013%2043%205116%20PM.png) Espaço para texto livre com informações relevantes e personalizadas: FAQ, políticas internas, regras operacionais, promoções, instruções internas, detalhes sobre processos e requisitos. Podem existir vários blocos de informações-chave para organizar por temas. #### Informações de produtos ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/dgHnMikpWgWM6ZAl8eoF/image%20png%20Nov%2024%202025%2002%2015%2054%200791%20PM.png) Permite carregar o catálogo que a IA consultará para detalhes, recomendações ou dúvidas sobre produtos. {% stepper %} {% step %} **Produtos carregados manualmente (formato nativo da Vambe)** * Não têm controle de estoque. * Devem ser atualizados manualmente. * Úteis para catálogos pequenos ou estáticos. {% endstep %} {% step %} **Integração com Shopify** * O catálogo é atualizado automaticamente. * Permite controle de inventário. * Possibilita funções avançadas: busca automática, cross-selling, sugestões inteligentes. {% endstep %} {% step %} **Integração com WooCommerce** * Funciona igual ao Shopify em termos de automação. * Permite sincronizar todos os produtos e suas informações associadas. {% endstep %} {% step %} **Integração com Jumpseller, PrestaShop e Odoo Ecommerce** * O catálogo também é sincronizado automaticamente a partir da sua loja. * Veja o passo a passo de cada plataforma nas [guias de conexão do Assistente Ecommerce](https://academy.vambe.ai/asistente-ecommerce/parte-1-obtener-credenciales). {% endstep %} {% endstepper %} #### Aplicativo de reservas ![](https://content.gitbook.com/content/HhSfNueGN7mmULeFP4KG/blobs/8rMsh926VHmvwlb9Huqv/image%20png%20Nov%2024%202025%2002%2017%2014%203718%20PM.png) É utilizado quando o negócio tem um sistema de agendamento integrado (Dentalink, Medilink, Reservo, AgendaPro ou agendamento nativo da Vambe). Permite consultar disponibilidade em tempo real, buscar horários por profissional, ver tratamentos e durações, criar reservas pela Vambe e coordenar consultas dentro da conversa. {% endstep %} {% endstepper %} *** ### Entendendo o conceito geral Um assistente na Vambe é formado por peças independentes, cada uma com um propósito claro: * Os blocos de identidade são a essência do assistente. * Os blocos de instrução definem o comportamento. * Os blocos de informação fornecem o conteúdo necessário para responder. Ao combinar esses blocos de forma coerente, constrói-se um assistente totalmente funcional. *** ### Resumo geral * Um assistente é um conjunto modular de blocos. * Os blocos se dividem em identidade, instrução e informação. * A identidade **nunca se repete**; é única por assistente. * As instruções e informações **podem sim se repetir** e ser ampliadas. * O assistente final é a soma de todos os blocos, assim como uma estrutura formada por peças individuais. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://academy.vambe.ai/bienvenido-a-vambe/bienvenido-a-vambe-pt-br/como-funciona-o-vambe-conceitos-essenciais/passo-5-o-que-e-um-assistente-de-inteligencia-artificial-no-vambe.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.