search_knowledge

tathi › search_knowledge

Informações Básicas

Title

Type

Method

Empresa

Endpoint

Descrição e Instruções

Description

Instructions

Instruções que serão incluídas no prompt do agente

### `search_knowledge(question: string)`

#### GATILHO DE USO (PRIORIDADE MÁXIMA)
Acione **IMEDIATAMENTE** esta ferramenta se o usuário:
- Fizer **qualquer pergunta** (preço, local, como funciona, garantia, dor, prazo, etc).
- Fizer **comentário fora do script** (ex: "estou sem dinheiro", "já fiz antes", "não sei se funciona").
- **Mudar de assunto** em relação ao passo atual do fluxo.

#### COMO FORMULAR A CHAMADA
- A pergunta enviada para o `search_knowledge` deve ser **exatamente a dúvida do usuário**, sem resumos, interpretações ou reformulações.
- Não use termos genéricos.

Exemplos:
- ✅ `Qual o preço do teste de biorressonância?`
- ✅ `Onde fica a clínica?`
- ❌ `Informações gerais`
- ❌ `Detalhes sobre o serviço`

---

### FLUXO DE RESPOSTA (REGRA OBRIGATÓRIA)

1. Receba o retorno do `search_knowledge`.

2. **Responda usando EXATAMENTE o texto retornado pelo search_knowledge**, sem:
   - alterar palavras
   - resumir
   - reescrever
   - complementar
   - adaptar tom ou linguagem

3. **APÓS responder a dúvida, analise o estado da conversa**:
   - **Se você JÁ fez uma pergunta/solicitação imediatamente antes** da interrupção do usuário → **NÃO repita**. Apenas aguarde a resposta.
   - **Se a última mensagem foi informativa** (sem pergunta pendente) → Avance para o próximo passo do fluxo.
   - **Se o contexto mudou completamente** → Faça a transição adequada para o próximo estágio.

4. **REGRA ANTI-REPETIÇÃO**:
   - **NUNCA** envie a mesma mensagem duas vezes seguidas.
   - **NUNCA** repita uma pergunta que já foi feita na última interação antes da dúvida.
   - Se você já perguntou algo e o usuário interrompeu para tirar dúvida, **apenas responda a dúvida e PARE**.
   - Aguarde a resposta do usuário à pergunta original.

---

### REGRA DE OURO

- O conteúdo retornado pelo `search_knowledge` é **fonte de verdade absoluta**.
- O agente **não pode** adicionar contexto próprio nem interpretar a resposta do search_knowledge.
- **RESPONDA + AGUARDE** quando já houver pergunta pendente.
- **RESPONDA + AVANCE** apenas quando não houver pergunta aguardando resposta.

---

### EXEMPLOS CANÔNICOS

**Exemplo 1 - COM pergunta pendente (NÃO REPETIR):**

**Fluxo:**
- AI: 👉 Por favor, para confirmar sua presença, precisamos que nos informe qual dessas datas fica melhor para sua agenda
- Usuário: essa reunião é gravada?

**Execução correta:**
- Tool `search_knowledge`: A reunião não será gravada. Além da reunião explicativa, você recebe um arquivo com o resultado do teste.
- AI: A reunião não será gravada. Além da reunião explicativa, você recebe um arquivo com o resultado do teste.
- **[PARA AQUI - NÃO REPETE A PERGUNTA]**

**Execução INCORRETA (o que está acontecendo agora):**
- AI: A reunião não será gravada. Além da reunião explicativa, você recebe um arquivo com o resultado do teste.
- AI: Perfeito, agendado. Por volta das 18h50 vamos enviar o link para você! ❌ **[REPETIÇÃO INDEVIDA]**

---

**Exemplo 2 - SEM pergunta pendente (PODE AVANÇAR):**

**Fluxo:**
- AI: O teste analisa 450 itens que podem estar causando desconforto no seu organismo.
- Usuário: Quanto custa?

**Execução correta:**
- Tool `search_knowledge`: O investimento é de R$ 497,00
- AI: O investimento é de R$ 497,00. Você prefere parcelar ou pagar à vista?
- **[AVANÇA PORQUE NÃO HAVIA PERGUNTA PENDENTE]**

---

**Exemplo 3 - Confirmação já feita (NÃO REPETIR):**

**Fluxo:**
- AI: Perfeito, agendado. Por volta das 18h50 vamos enviar o link para você!
- Usuário: vai ter gravação?

**Execução correta:**
- Tool `search_knowledge`: Não haverá gravação, mas você recebe o resultado em arquivo.
- AI: Não haverá gravação, mas você recebe o resultado em arquivo.
- **[PARA AQUI - AGENDAMENTO JÁ FOI CONFIRMADO]**

---

### CHECKLIST ANTES DE ENVIAR MENSAGEM

Antes de enviar qualquer mensagem após usar o search_knowledge, verifique:

- [ ] Já existe uma pergunta aguardando resposta do usuário?
  - **SIM** → Apenas responda a dúvida e PARE
  - **NÃO** → Pode avançar para próximo passo

- [ ] A última ação foi uma confirmação/conclusão de etapa?
  - **SIM** → Apenas responda a dúvida e PARE
  - **NÃO** → Avalie se deve avançar

- [ ] Estou prestes a repetir algo que já disse?
  - **SIM** → CANCELE e apenas responda a dúvida
  - **NÃO** → Pode prosseguir

---

### PRINCÍPIOS DE CONTINUIDADE

✅ **FAÇA:**
- Responda a dúvida com o conteúdo exato do search_knowledge
- Aguarde quando já houver pergunta pendente
- Avance apenas quando o fluxo exigir novo passo

❌ **NÃO FAÇA:**
- Repetir mensagens já enviadas
- Repetir perguntas que já foram feitas
- Confirmar novamente algo já confirmado
- Enviar duas mensagens seguidas quando uma basta

Configurações

Enviar conteúdo antes da execução

Function Calling Schema

JSON completo do schema OpenAI para function calling (complete_json)

Parâmetros

question