Tu agente de IA (Asistente virtual)

El módulo Asistente virtual es para que tengas tu propio agente de IA dentro del CRM. El CRM no pone la IA: la pones tú. Aquí guardas la clave de tu proveedor, eliges el modelo y le escribes las instrucciones; y aquí mismo chateas con él.

El chat de ayuda que responde con el manual de AvanzaCRM es otra cosa y vive en Soporte → Chat de ayuda.

Configurarlo (sólo el administrador)

1. Entra en Asistente virtual (menú lateral) y pulsa Configurar agente.

2. Elige el proveedor:

   Proveedor	Qué claves vale	Modelos de ejemplo
   OpenAI (GPT)	las que empiezan por sk-	gpt-4o-mini, gpt-4o
   Anthropic (Claude)	las que empiezan por sk-ant-	claude-3-5-sonnet-latest
   DeepSeek	clave de DeepSeek	deepseek-chat
   Otro (compatible con OpenAI)	cualquiera (Groq, Mistral, Ollama, Azure…)	el que use tu servidor

3. Pega la clave de API. El enlace «¿Dónde saco la clave?» te lleva a la página exacta de cada proveedor.

4. Escribe el modelo y, si elegiste Otro, la URL base (termina en /v1).

5. Escribe las instrucciones: qué es tu negocio, qué debe saber, cómo debe responder (idioma, tono, longitud, qué no debe hacer). Es lo que hace que sea tu agente.

6. Ajusta creatividad (0 = respuestas pegadas a los datos, 1 = más sueltas) y el tope de tokens por respuesta, y guarda.

La clave se guarda cifrada y sólo la ve el administrador: en pantalla queda enmascarada (••••1234) para que reconozcas cuál tienes puesta. La clave es tuya y el consumo de la IA se factura en tu cuenta del proveedor, no en AvanzaCRM.

Chatear con tu agente

• Cualquier persona del equipo (con el módulo concedido) abre Asistente virtual y escribe.
• Cada uno tiene su propia conversación: el agente recuerda los últimos turnos de esa persona y no se mezcla con la de los demás.
• Vaciar conversación la borra (queda registrada sólo hasta ese momento).
• Con Agente encendido desmarcado, el chat queda apagado sin perder la configuración.

Si algo falla

El último error del proveedor se muestra en la propia pantalla (por ejemplo «respondió 401: Incorrect API key»). Los más habituales:

Mensaje	Qué pasa
401 / Incorrect API key	La clave está mal o se revocó: pégala otra vez.
402 / Insufficient balance	Sin saldo en tu cuenta del proveedor.
404 model not found	Ese modelo no existe en tu cuenta: revisa el nombre.
tardó demasiado	El proveedor no respondió a tiempo: prueba otro modelo o revísalo luego.

Buenas prácticas

• Usa una clave creada para el CRM (no la tuya personal) y revócala cuando ya no la uses.
• Empieza con instrucciones concretas y ajústalas según lo que veas responder.
• Si el agente va a hablar con clientes finales, pídele explícitamente que no invente datos, precios ni plazos, y que derive a una persona cuando no sepa.
• El agente no toca tus datos del CRM: sólo conversa. Las acciones siguen siendo tuyas.