Pular para o conteúdo
DeskVoiceDeskVoiceGitHub ★ 32Instalar

Guias do assistente

Descreva a situação. O guia já está no repositório.

O repositório traz 6 skills: roteiros escritos para um assistente de código ler antes de agir. Abra o repositório no assistente, peça o assunto em português ou chame a skill pelo nome. Como cada assistente carrega as skills ainda não foi medido aqui. Esta página é montada a partir do cabeçalho de cada skill na main.

deskvoice-contribuir

Vou abrir um PR, ou o CI ficou vermelho e não sei se a culpa é minha

Caminho de quem vai mexer no código do DeskVoice e abrir um pull request, sobretudo a partir de um fork.

Frases que a acionam

  • “como eu testo isso”
  • “meu ramo está atrasado?”
  • “por que o CI ficou vermelho”
  • “a culpa é minha?”
Abrir a skill no repositório

deskvoice-doutrina

Não sei se algo é permitido, ou quero o porquê de uma regra

Resumo operacional das regras de forma do DeskVoice: um caminho de schema, um arquivo por peça, isolamento por organização, fila por notificação, configuração tem tela, tudo tem log, relógio injetado.

Frases que a acionam

  • “posso fazer assim?”
  • “isso é permitido?”
  • “por que essa regra existe?”
  • “por que a cerca reprovou?”
Abrir a skill no repositório

deskvoice-instalar

Vou instalar (com ou sem servidor ainda), ou a instalação falhou

Roteiro para instalar o DeskVoice numa VPS e para consertar uma instalação que falhou.

Frases que a acionam

  • “quero instalar”
  • “me ajuda a instalar”
  • “ainda não tenho servidor”
  • “qual VPS eu contrato”
  • “subir na VPS”
  • “o instalador parou”
  • “o painel não abre”
  • “a ligação não completa”
  • “a ligação fica muda”
  • “o tronco não registra”
  • “qual porta eu libero”
Abrir a skill no repositório

deskvoice-ferramenta

Vou criar ou alterar uma ferramenta que o agente usa na chamada

Como criar ou alterar uma ferramenta que o agente do DeskVoice usa DURANTE a chamada (consultar um sistema, agendar, avisar alguém, cobrar, transferir).

Frases que a acionam

  • “quero que o agente faça X na ligação”
  • “criar uma tool”
  • “o agente precisa consultar meu sistema”
  • “adicionar uma ferramenta”
Abrir a skill no repositório

deskvoice-motor-de-voz

Vou adicionar ou alterar um motor de voz

Como adicionar ou alterar um motor de voz no DeskVoice (o provedor de IA que ouve e fala na ligação: Gemini Live, OpenAI Realtime, o simulado, ou um novo).

Frases que a acionam

  • “suportar o provedor X”
  • “adicionar um modelo de voz”
  • “trocar a voz”
  • “pipeline STT + LLM + TTS”
Abrir a skill no repositório

deskvoice-operar

Tenho uma instalação rodando e preciso atualizar, fazer backup, diagnosticar

Operar uma instalação do DeskVoice que já está rodando: configurar um agente, a linha telefônica e as regras de ligação de saída; ler a linha do tempo de uma chamada; entender e limitar custos; conectar um WhatsApp por QR Code; atualizar, fazer backup, restaurar e diagnosticar.

Frases que a acionam

  • “como configuro o agente”
  • “como escrevo as instruções”
  • “por que o agente transferiu”
  • “o que aconteceu nessa ligação”
  • “quanto custou”
  • “como ligo as ligações de saída”
  • “como atualizo”
  • “como faço backup”
  • “o agente não está usando a ferramenta”
  • “como conecto o WhatsApp”
  • “o WhatsApp caiu”
  • “o QR Code não aparece”
Abrir a skill no repositório

As skills moram em .agents/skills, e o AGENTS.md é a autoridade que todo assistente lê. Guias longos para pessoas ficam em docs/guides.