# Como criar Cenários e Rotas em um Assistente com Cenários Os Cenários e as Rotas são o coração dos assistentes V3. Eles substituem os antigos blocos de "Passos a seguir" e "Casos possíveis", dando à IA a flexibilidade de conduzir a conversa de forma natural, de acordo com o que cada cliente precisar. *** ### Antes de começar: entenda o conceito #### O que é um Cenário? Um **Cenário** é uma pasta que agrupa rotas relacionadas sob um mesmo propósito. Pense nele como um "tema" ou "área de atuação" do assistente. Exemplos de cenários: * ***"Conversa com o cliente"*** * ***"Informações de produtos e preços"*** * ***"Gestão de pedidos"*** #### O que é uma Rota? Uma **Rota** é uma instrução específica dentro de um cenário. É o que a IA executará quando detectar que aquela situação se aplica. Cada rota tem: * Uma **descrição** que diz à IA quando ela deve ser ativada. * O **conteúdo** com as instruções ou informações que deve usar. #### Como a IA decide qual rota usar? A IA lê as descrições de cada cenário e de cada rota e, em tempo real, decide qual se aplica melhor à mensagem do cliente. **Por isso, as descrições são a coisa mais importante de todo o sistema** — elas devem ser claras, específicas e não genéricas. *** ### Exemplo super simples para entender a lógica Imagine que você tem um restaurante e contrata um novo garçom. No primeiro dia, você entrega a ele um manual com três seções: * 📋 **Seção "Boas-vindas":** O que fazer quando um cliente chega. * 🍽️ **Seção "Anotar pedido":** O que fazer quando o cliente quer pedir. * 💳 **Seção "Cobrança":** O que fazer quando o cliente pede a conta. Cada seção tem instruções específicas para diferentes situações dentro dela. O garçom não segue um roteiro rígido — ele lê a situação e tira a instrução correta do manual. Na Vambe: * As **seções do manual** = **Cenários** * As **instruções dentro de cada seção** = **Rotas** * O **garçom** = a IA *** ### Exemplo do dia a dia: loja de roupas online Suponha que você tenha uma loja de roupas e queira que seu assistente cuide de vendas, consultas de tamanho e acompanhamento de pedidos. #### Estrutura de cenários: **Cenário 1: "Atendimento inicial"** * *Descrição do cenário:* "Quando o cliente nos escreve pela primeira vez ou cumprimenta sem especificar o que precisa." * Rota 1.1 — *"Saudação inicial":* Descrição: "Quando o cliente cumprimenta sem indicar o que precisa." → Instrução: Cumprimentar, se apresentar e perguntar como pode ajudar. * Rota 1.2 — *"Cliente que retorna":* Descrição: "Quando o cliente menciona que já comprou antes ou tem um pedido." → Instrução: Cumprimentar de forma mais calorosa e encaminhar para a seção de acompanhamento. **Cenário 2: "Informações de produtos"** * *Descrição do cenário:* "Quando o cliente pergunta sobre produtos, tamanhos, cores ou preços." * Rota 2.1 — *"Consulta de tamanhos":* Descrição: "Quando o cliente pergunta qual tamanho serve ou como são os tamanhos." → Instrução: Entregar o guia de tamanhos + perguntar se quer ajuda para escolher. * Rota 2.2 — *"Consulta de preços":* Descrição: "Quando o cliente pergunta quanto custa algo." → Instrução: Entregar os preços disponíveis e mencionar formas de pagamento. **Cenário 3: "Acompanhamento de pedidos"** * *Descrição do cenário:* "Quando o cliente quer saber o status da compra ou tem um problema com o pedido." * Rota 3.1 — *"Rastrear pedido":* Descrição: "Quando o cliente pergunta onde está o pedido." → Instrução: Executar a função de rastreamento do pedido. * Rota 3.2 — *"Devolução":* Descrição: "Quando o cliente quer devolver ou trocar um produto." → Instrução: Explicar o processo de devolução e encaminhar para um atendente humano. #### Como a IA navega? Quando um cliente escreve *"Olá, quero saber se o vestido preto vem no tamanho M"*, a IA: 1. Lê as descrições de todos os cenários. 2. Identifica que se aplica **Cenário 2 → Rota 2.1** (consulta de tamanhos). 3. Executa as instruções dessa rota. Se depois o mesmo cliente perguntar *"E quanto custa?"*, a IA muda automaticamente para **Rota 2.2** — sem que ninguém programe isso explicitamente. > 💡 Uma rota também pode "chamar" outra rota de outro cenário. Por exemplo, depois de entregar os preços (Rota 2.2), a IA pode passar para a Rota 1.1 de encerramento da conversa se o cliente não disser mais nada. *** ### Como criar um Cenário passo a passo #### Passo 1: Ir para a aba Cenários Dentro do seu assistente, clique na aba **Cenários**. #### Passo 2: Adicionar um cenário Clique em **+ Adicionar cenário**. Você verá três opções: * **Criar do zero:** Para um cenário novo e vazio. * **Cenários existentes:** Para reutilizar um cenário que você já criou em outro assistente (como compartilhado ou como cópia). * **Modelos:** Cenários pré-configurados pela Vambe prontos para usar. #### Passo 3: Criar o cenário Se você escolher **Criar do zero**: 1. **Nome:** Dê um nome descritivo. Ex: *"Atendimento inicial"*, *"Informações de produtos"*. 2. **Instruções de quando usar este cenário:** Este campo é crítico. Escreva quando este cenário deve ser ativado. Ex: *"Este cenário deve ser ativado quando o cliente nos cumprimentar pela primeira vez ou quando não tiver especificado o que precisa."* 3. Clique em **Criar**. > ⚠️ **A descrição do cenário é a chave.** A IA a usa para decidir se deve entrar nesse cenário ou não. Se for vaga ou genérica, a IA não saberá quando ativá-lo. Seja específico. #### Passo 4: Adicionar Rotas dentro do cenário Depois de criar o cenário, você verá o editor de rotas. Clique em **+ Adicionar rota** para criar a primeira. Cada rota tem: * **Nome:** Identifica a rota dentro do cenário. Ex: *"Saudação inicial"*. * **Descrição:** Quando esta rota específica deve ser ativada. Ex: *"Quando o cliente cumprimenta sem indicar o que precisa."* * **Instruções:** O que a IA deve fazer quando esta rota for ativada. Aqui entram tanto o comportamento quanto as informações relevantes. > 💡 Você pode adicionar quantas rotas precisar dentro de um cenário. Cada rota é independente e a IA escolhe a mais adequada conforme o contexto. *** ### Reutilizar cenários em outros assistentes Uma das grandes vantagens da V3 é que você pode reutilizar cenários entre assistentes. Ao adicionar um cenário, se você escolher um **existente**, você tem duas opções: * **Criar uma cópia:** É gerada uma cópia independente. As mudanças em uma não afetam a outra. * **Usar como compartilhado:** O mesmo cenário é compartilhado entre os dois assistentes. Se você modificar uma rota, a mudança se aplica em todos os assistentes que a usarem. > ⚠️ Se você usar um cenário como compartilhado e modificá-lo, as mudanças afetarão todos os assistentes que o tiverem associado. Use isso quando quiser manter coerência entre vários assistentes. *** ### Pontos-chave para lembrar * Um **Cenário** é uma pasta de rotas agrupadas por propósito. * Uma **Rota** é a instrução específica que a IA executa quando detecta que se aplica. * A IA decide qual cenário e qual rota usar com base em suas **descrições** — escreva-as com detalhes. * Uma rota pode referenciar ou "chamar" rotas de outros cenários. * Os cenários podem ser reutilizados entre assistentes (como cópia ou como compartilhado). * As informações do negócio que antes iam em blocos de "Informações-chave" agora vão **dentro das rotas** onde elas se encaixam. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/assistentes-com-cenarios-v3/como-crear-escenarios-y-rutas-en-un-asistente-con-escenarios.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.