Centre · Guía de configuración — Documentos, saludo y prompt

00 · Acceso

Recurso	URL
Panel (config + documentos)	voz.oca-i.net/app/panel/
Salud del servicio	/health
Diagnóstico llamadas	/diagnostico
Teléfono Twilio	+1 659 276 8088
Webhook Twilio	`https://voz.oca-i.net/twilio/voice`

Si el servidor tiene ADMIN_API_KEY en el .env, introdúcela en el panel (campo «Clave admin») antes de guardar cambios.

01 · Documentos

Base de conocimiento por empresa

El agente consulta estos archivos en cada llamada con la herramienta search_knowledge. Cuanto mejor escrito esté el contenido, mejores respuestas.

Opción A — Panel web (recomendado)

Entra en Panel → Documentos.
Selecciona la empresa (ej. Kasalia).
Crea o edita archivos .md / .txt (FAQ, menú, propiedades…).
O sube PDF/DOCX con «Subir adjunto».
Guarda. Los cambios aplican en la siguiente llamada.

Opción B — Carpeta en disco

Cada empresa tiene su carpeta definida en su YAML:

data/documents/kasalia/
├── faq.md           ← preguntas frecuentes
├── propiedades.md   ← pisos, precios, zonas
└── zonas.md         ← barrios, playas, servicios

Empresa	Carpeta	Ejemplos de archivo
Kasalia (inmobiliaria)	`data/documents/kasalia/`	faq.md, propiedades.md, zonas.md
OCA-I Net	`data/documents/ocai/`	faq.md, servicios.md
Bocata Burger	`data/documents/bocata-burger/`	menu.md
Centro médico	`data/documents/centro-medico/`	faq.md, citas.md
ITV	`data/documents/itv/`	faq.md, requisitos.md
IA abierta	`data/documents/ia-abierta/`	faq.md

Consejos de redacción

Markdown simple con títulos ## por tema.
Frases cortas: precios, horarios, zonas, requisitos.
No inventes datos que no estén aquí: el LLM solo debe citar lo que encuentra.
Para PDF/DOCX con búsqueda semántica avanzada (RAG), indexa en servidor: python -m src.knowledge.ingest --company kasalia (requiere OPENAI_API_KEY).

02 · Saludo

La primera frase que dice al conectar

Es lo primero que escucha el cliente tras «Conectando con…». No es el prompt completo del LLM, solo el saludo inicial.

Desde el panel

Pestaña Configuración → campo Saludo inicial.

Desde código

Campo greeting en src/companies/kasalia.yaml.

Ejemplo Kasalia (agente Sofía):

greeting: >
  Hola, ha llamado a Kasalia, su portal inmobiliario de vacaciones y alquiler.
  Soy Sofía. Puedo ayudarle a buscar alojamiento, informarle de zonas o agendar una visita.
  ¿En qué le puedo ayudar?

También en el panel puedes cambiar:

Nombre del agente → agent_name: Sofía
Si no entiende → fallback
Voz Deepgram Aura → voice_id
Horario / zona horaria → el LLM los usa en citas

03 · Prompt

Comportamiento e instrucciones del LLM

Define cómo debe actuar el agente: tono, menú de opciones, flujo de citas, reglas duras. No está en el panel (de momento): vive en código y requiere despliegue.

src/agent/prompts.py

Vertical (empresa)	Plantilla en prompts.py
`real_estate` — Kasalia	`REAL_ESTATE_ES`
`edtech` — OCA-I	`EDTECH_ES`
`restaurant` — Bocata Burger	`RESTAURANT_ES`
`medical`	`MEDICAL_ES`
`itv`	`ITV_ES`
`open_ai`	`OPEN_AI_ES`

El vertical se elige en el YAML de cada empresa (vertical: real_estate) o en el panel. Tras editar prompts.py:

cd ~/Documents/asistente-voz
./deploy/sync-and-deploy.sh

Resumen: documentos + saludo → panel (sin deploy). Comportamiento profundo del agente → prompts.py + deploy.

04 · Flujo

Qué pasa en una llamada

Menú recepcionista

«¿Con quién desea hablar?» — Kasalia es la opción 1.

Conexión

«Conectando con Sofía de Kasalia, agencia inmobiliaria.»

Saludo

Lee el campo greeting del YAML / panel.

Conversación

LLM con prompt de prompts.py + búsqueda en documentos.

05 · Subdominio

URL oficial: `voz.oca-i.net`

Desde julio 2026 el asistente vive en el subdominio dedicado. Las URLs antiguas oca-i.net/voz/… redirigen automáticamente.

URL	Estado	Notas
`voz.oca-i.net`	✓ Oficial	Panel, API, Twilio y WebSocket. Usa esta.
`oca-i.net/voz/…`	↪ Redirige	301 permanente hacia `voz.oca-i.net`.
`asistente.oca-i.net`	✗ Ocupado	Otra app (privacy-jornada-chat).

Enlaces principales

06 · Chuleta

¿Qué cambio dónde?

Quiero…	Dónde	¿Deploy?
FAQ, menú, precios, propiedades	Panel → Documentos	No
Primera frase al conectar	Panel → Saludo inicial	No
Nombre del agente (Sofía)	Panel → Nombre del agente	No
Voz Deepgram	Panel → Voz	No
Menú, tono, reglas de conversación	`src/agent/prompts.py`	Sí
Nueva empresa completa	Panel → Registrar	No
Orden en menú telefónico	`ROUTER_COMPANIES` en .env	Reinicio
URL pública / Twilio	`PUBLIC_BASE_URL` + script Twilio	Sí

Cómo configurar cada empresa: documentos, saludo y comportamiento del agente.