> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompt e Ferramentas

> Configure a base de conhecimento, ferramentas, variáveis e prompt do sistema do seu assistente para definir suas capacidades e comportamento.

Configure o objetivo do assistente e as ferramentas que ele pode usar durante as chamadas.

## Base de Conhecimento

Forneça informações ao assistente para usar como base de conhecimento ao responder aos clientes. De conteúdos de sites, documentos, etc.

### Seleção de Base de Conhecimento

<AccordionGroup>
  <Accordion title="Escolha a Base de Conhecimento" icon="book-open">
    Selecione um armazenamento de base de conhecimento contendo informações relevantes para o assistente usar.

    **Requisitos:**

    * Deve ser criada primeiro na sua seção [Bases de Conhecimento](/knowledgebases)
    * Mostra status (Ativo, Processando, etc.) e descrição
    * Apenas suas próprias bases de conhecimento estão disponíveis

    <Tip>
      Crie bases de conhecimento a partir de conteúdo de sites, PDFs ou documentos personalizados para dar ao seu assistente informações específicas do domínio. Para guia de configuração abrangente incluindo tipos de conteúdo, status de processamento, raspagem de sites e solução de problemas, veja o [Guia Completo de Base de Conhecimento](/conversation-design/knowledge-bases).
    </Tip>
  </Accordion>

  <Accordion title="Modo de Base de Conhecimento" icon="brain">
    Escolha como a IA usará a base de conhecimento.

    <CardGroup cols={2}>
      <Card title="Chamada de Função" icon="function">
        **Recomendado para a maioria dos casos**

        Usa uma chamada de função para pesquisar informações na base de conhecimento, apenas quando necessário. Mais preciso e eficiente.
      </Card>

      <Card title="Injeção de Prompt" icon="syringe">
        **Para casos de uso simples**

        Realiza uma pesquisa após cada fala do cliente. Mais preciso, mas pode ser mais lento sem áudios de preenchimento.
      </Card>
    </CardGroup>

    <Note>
      **Disponibilidade de modo:** Os modos Fala-para-Fala e Dualplex suportam apenas o modo Chamada de Função.
    </Note>
  </Accordion>
</AccordionGroup>

## Ferramentas Personalizadas Mid-Call

Crie e atribua suas próprias ferramentas personalizadas que a IA pode usar **durante a chamada** com o cliente.

<CardGroup cols={2}>
  <Card title="Criar Ferramentas Personalizadas" icon="plus">
    Construa ferramentas adaptadas às suas necessidades específicas de negócio: integrações de API, consultas de banco de dados, fluxos de trabalho personalizados e chamadas de serviços externos.

    **Ação rápida:** Link direto para página de criação de ferramenta.
  </Card>

  <Card title="Atribuir ao Assistente" icon="link">
    Selecione quais ferramentas personalizadas este assistente pode usar com seleção múltipla, pesquisa por nome/descrição e atribuição em tempo real.

    **Escopo:** Apenas suas próprias ferramentas estão disponíveis.
  </Card>
</CardGroup>

<Tip>
  Leia a documentação de [Ferramentas Personalizadas](/ai-assistants/custom-tools) para guias detalhados sobre criação e configuração de ferramentas personalizadas.
</Tip>

## Ferramentas Padrão

Escolha ferramentas integradas que a IA pode usar **durante a chamada** com o cliente.

<AccordionGroup>
  <Accordion title="Transferência de Multi Chamada" icon="phone-arrow-right">
    Roteie chamadas para múltiplos números de telefone de destino como diferentes pessoas ou departamentos de acordo com seu fluxo.

    **Casos de uso:**

    * Escalação para agentes humanos
    * Roteamento de departamentos
    * Transferências para especialistas

    **Opções de configuração:**

    * **Modo padrão:** Use números de telefone regulares (ex: +1234567890)
    * **Modo avançado:** Use formato SIP URI para provedores SIP (ex: sip:+1234567890\@sip-server)

    **Para integrações SIP:**

    * Configure transferência para modo "Avançado"
    * Use formato SIP URI: `sip:number@sip-server`
    * Verifique se seu provedor SIP suporta SIP REFER
    * Teste com diferentes formatos de URI se as transferências falharem

    <Note>
      **Instrução de prompt:** Inclua no seu prompt do sistema algo como "chame a função de transferência quando o usuário solicitar falar com outra pessoa" para garantir que a IA use esta ferramenta apropriadamente.
    </Note>

    <Tip>
      Se as transferências não estiverem funcionando, veja nosso [guia de solução de problemas de Integração SIP](/troubleshooting/sip-integration#transfer-phone-call-not-working) para soluções detalhadas.
    </Tip>
  </Accordion>

  <Accordion title="Encerrar Chamada" icon="phone-slash">
    Encerra a chamada quando a conversa estiver completa.

    **Casos de uso:**

    * Conclusão natural da conversa
    * Objetivo alcançado
    * Satisfação do cliente confirmada

    <Note>
      **Instrução de prompt:** Se a IA não chamar a função de encerrar chamada automaticamente, inclua no seu prompt do sistema "chame a função hang\_up para encerrar a chamada" quando a conversa deve terminar.
    </Note>
  </Accordion>

  <Accordion title="Entrada DTMF" icon="hashtag">
    Envie facilmente entradas de teclado durante chamadas de saída, permitindo navegação suave através de menus IVR e fluxos de trabalho automatizados. A IA navega usando botões do teclado ao ligar e responder a prompts.

    **Casos de uso:**

    * Navegar menus telefônicos
    * Inserir números de ramal
    * Inserir códigos de segurança
    * Navegação de sistema IVR

    <Note>
      **Instrução de prompt:** Inclua no seu prompt do sistema instruções sobre quando usar entrada DTMF, como "use a ferramenta send\_dtmf para navegar menus telefônicos quando necessário para alcançar a pessoa certa."
    </Note>

    Para informações detalhadas sobre capacidades DTMF, veja [Ferramentas e Funções](/ai-assistants/tools-and-functions#4-dtmf-input).
  </Accordion>

  <Accordion title="Agendamento de Compromissos" icon="calendar">
    Integração de agendamento em tempo real com múltiplas plataformas de calendário.

    **Integrações disponíveis:**

    * **Cal.com:** Guia de configuração completo disponível em [Agendamento Cal.com](/ai-assistants/cal-com-scheduling#cal-com-appointment-scheduling)
    * **GoHighLevel:** Guia de integração completo em [Agendamento GoHighLevel](/ai-assistants/gohighlevel-scheduling)
    * **Calendly:** Guia de configuração completo disponível em [Calendly Scheduling](/ai-assistants/calendly-scheduling)

    **Casos de uso:**

    * Agendar compromissos com calendários
    * Verificar disponibilidade em tempo real
    * Enviar detalhes de confirmação automática
    * Sincronizar com sistemas de calendário existentes

    **Configuração:**

    1. Selecione sua plataforma de calendário (Cal.com, GoHighLevel, ou Calendly)
    2. Autentique com sua conta de calendário
    3. Escolha o tipo de evento/calendário para usar em reservas
    4. A IA verificará automaticamente a disponibilidade e agendará compromissos

    <Note>
      Disponível quando a integração de calendário está habilitada nas configurações da sua plataforma.
    </Note>
  </Accordion>
</AccordionGroup>

## Variáveis de Chamada

Defina variáveis que podem ser passadas **antes** de fazer a chamada e usadas no prompt **como {nome_variavel}**.

### Configuração de Variáveis

<AccordionGroup>
  <Accordion title="Definição de Variável" icon="code">
    Crie variáveis de chamada para passar informações ao seu assistente antes do início da chamada.

    **Processo de configuração:**

    * Defina nomes de variáveis e valores padrão
    * Passe valores ao criar chamadas/leads ou importar clientes
    * Variáveis disponíveis imediatamente em prompts e durante chamadas
    * Use para personalização e contexto

    **Configuração:**

    * **Nome da variável:** O identificador (ex: `customer_name`)
    * **Valor padrão:** Usado quando não passado (ex: "João")
  </Accordion>

  <Accordion title="Uso de Variáveis" icon="code">
    Como usar variáveis de chamada no seu assistente:

    **Em prompts do sistema:**

    * Referencie variáveis com sintaxe `{nome_variavel}`
    * Personalize conversas dinamicamente
    * Forneça informações específicas de contexto

    **Exemplos:**

    * `{customer_name}` para personalização ("Olá {customer_name}")
    * `{email}` para integrações de calendário
    * `{account_type}` para respostas personalizadas
    * `{company}` para contexto de negócios
  </Accordion>

  <Accordion title="Fontes de Dados" icon="database">
    Maneiras de popular variáveis de chamada:

    **Entrada manual:**

    * Ao criar chamadas individuais
    * Através da criação de lead de campanha

    **Métodos de importação:**

    * Importação CSV com colunas de variáveis
    * Integração de API com dados de cliente
    * Sincronização direta com CRM

    **Integrações de plataforma de automação:**

    * **GoHighLevel (GHL):** Extraia automaticamente dados de contato e campos personalizados
    * **Google Sheets:** Importe leads com variáveis de colunas de planilha
    * **Conecte com mais de 250 ferramentas** e plataformas populares usando nossa plataforma sem código
    * **Qualquer outra plataforma** através de webhooks para integrações personalizadas

    **Integração de plataforma:**

    * Automaticamente populado de perfis de cliente
    * Conectado a bancos de dados de clientes existentes
    * Fluxos de trabalho de automação sem código
  </Accordion>
</AccordionGroup>

<Note>
  Variáveis de chamada são essenciais para personalizar conversas de IA. Elas permitem que a IA use informações específicas do cliente durante as chamadas, tornando as interações mais relevantes e eficazes.
</Note>

## Configuração de Fluxo de Chamada

### Quem Fala Primeiro?

Controle se seu assistente ou o cliente inicia a conversa.

<CardGroup cols={2}>
  <Card title="Assistente de IA" icon="robot">
    **Comportamento padrão:** Assistente inicia a conversa

    A IA cumprimentará imediatamente o chamador e iniciará o fluxo de conversa assim que a chamada conectar.

    **Melhor para:** A maioria dos cenários de saída, chamadas de vendas, lembretes de compromissos
  </Card>

  <Card title="Cliente" icon="user">
    **Espera pelo cliente:** Assistente escuta primeiro

    Se você escolher "Cliente", a IA esperará o cliente falar primeiro antes de responder.

    **Melhor para:** Chamadas de suporte de entrada, cenários de recepção, assistência reativa
  </Card>
</CardGroup>

### Mensagem Inicial

Configure a primeira coisa que seu assistente diz quando a chamada começa.

<AccordionGroup>
  <Accordion title="Texto de Mensagem Inicial" icon="message">
    Escreva a mensagem de abertura que seu assistente falará no início de cada chamada.

    **Melhores práticas:**

    * Mantenha conciso e amigável
    * Apresente sua empresa/propósito claramente
    * Defina expectativas para a conversa
    * Use variáveis para personalização (ex: `{customer_name}`)

    **Exemplo:** "Oi {customer_name}, aqui é a Sarah da Empresa ABC. Estou ligando para dar seguimento à sua recente consulta sobre nossos serviços. Você tem um momento para conversar?"
  </Accordion>

  <Accordion title="Arquivo de Áudio Inicial" icon="volume">
    **Opcional:** Faça upload de um arquivo de áudio personalizado em vez de texto-para-fala

    **Requisitos:**

    * Formato MP3 ou WAV
    * Gravação clara e de alta qualidade
    * Voz e tom profissionais
    * Corresponde à voz do seu assistente se usar clonagem de voz

    **Benefícios:**

    * Pronúncia e entrega perfeitas
    * Voz de marca consistente
    * Primeira impressão profissional
    * Sem latência de texto-para-fala para abertura

    <Tip>
      Isso funciona melhor se a voz da IA for clonada usando a mesma voz usada no áudio inicial.
    </Tip>
  </Accordion>
</AccordionGroup>

<Note>
  Veja nosso [guia de Mensagem Inicial](/ai-assistants/initial-message) para melhores práticas detalhadas e exemplos.
</Note>

## Prompt do Sistema

Defina a personalidade, objetivos e diretrizes de comportamento do assistente.

### Configuração de Prompt

<CardGroup cols={2}>
  <Card title="Prompt Personalizado" icon="pencil">
    Escreva seu próprio prompt do sistema do zero

    * Controle total sobre comportamento do assistente
    * Adaptado a casos de uso específicos
    * Formatação markdown suportada
  </Card>

  <Card title="Biblioteca de Modelos" icon="folder">
    Comece com modelos pré-construídos

    * Múltiplos idiomas disponíveis
    * Diferentes tipos de conversa
    * Prompts comprovadamente eficazes
  </Card>
</CardGroup>

### Melhores Práticas

<AccordionGroup>
  <Accordion title="Seja Específico" icon="bullseye">
    Defina claramente o papel, objetivos e restrições do assistente.

    **Inclua:**

    * Quem o assistente representa
    * O que eles estão tentando alcançar
    * O que eles devem/não devem fazer
  </Accordion>

  <Accordion title="Defina Limites" icon="shield">
    Defina quais tópicos e ações estão fora dos limites.

    **Considere:**

    * Requisitos de privacidade de dados
    * Conformidade legal
    * Diretrizes de marca
  </Accordion>

  <Accordion title="Use Exemplos" icon="lightbulb">
    Forneça conversas de amostra para guiar o comportamento.

    **Exemplos ajudam com:**

    * Tom e estilo
    * Comprimento de resposta
    * Tratamento de objeções
  </Accordion>
</AccordionGroup>

<Tip>
  Veja nosso [guia de Prompt do Sistema](/ai-assistants/system-prompt) para melhores práticas detalhadas e exemplos.
</Tip>