AI Agents

Los AI Agents son asistentes autónomos que gestionan conversaciones de forma inteligente, respondiendo 24/7 en base a instrucciones de sistema y (opcionalmente) una base de conocimiento propia.

¿Cómo funciona internamente?

1. El cliente envía un mensaje
2. El workflow activa el nodo AI Agent (o la Cola lo enruta directamente)
3. SIGNOS envía el historial de la conversación al modelo de IA configurado
4. El modelo genera una respuesta
5. La respuesta se envía al cliente
6. El ciclo se repite hasta que el AI Agent decide escalar a un humano

Configurar la API Key de IA

Antes de crear AI Agents, configurá la conexión al proveedor de IA:

1. Ve a Configuración de Instancia → AI Settings
2. Ingresá la API Key de tu proveedor preferido
3. Seleccioná el modelo por defecto
4. Guardá

La API Key no se muestra una vez guardada. Para cambiarla, simplemente sobreescribila.

¿Dónde obtener tu API Key?

Crear un AI Agent

1. Ve a Configuración → AI Agents → + Nuevo
2. Completá los campos: Nombre, System Prompt, Modelo, y opciones avanzadas
3. Guardá y asignalo a una Cola

Instrucciones del sistema (System Prompt)

El System Prompt define la personalidad, rol y restricciones del agente. Es el campo más importante para el comportamiento del AI Agent.

Estructura recomendada

# Rol
Eres [Nombre], asistente virtual de [Empresa].
Tu función principal es [objetivo].

# Tono
Respondé de forma [cordial / profesional / amigable].
Usá frases cortas y claras. Siempre en español.

# Reglas
- No inventes información. Si no sabés, decí "Dame un momento".
- Si el cliente pide hablar con una persona, escalá inmediatamente.
- No ofrezcas descuentos ni compromisos sin autorización.

# Escalada
Escalá a un agente humano si:
- El cliente está enojado o frustrado
- La consulta es sobre [tema fuera de tu alcance]
- El cliente lo pide explícitamente

# Contexto del negocio
[Describí: qué hace la empresa, horarios, ubicaciones, productos]

Prompt Restrictivo para responder SOLO desde Documentos (RAG)

Si querés que tu agente se convierta en un asistente de soporte estricto que use exclusivamente los documentos que subiste a la plataforma (Knowledge base / RAG) y no invente nada, copiá esta estructura de System Prompt:

# Rol
Eres el asistente de soporte técnico nivel 1.

# Regla de Oro (Muy Importante)
Utiliza EXCLUSIVAMENTE la información de los fragmentos de la "Knowledge Base" (documentos de contexto) provistos para responder.
NO utilices tus conocimientos generales previos, NO asumas información que no esté en el contexto.

# Manejo de respuestas
Si la respuesta a la pregunta del usuario no se encuentra en el material provisto, DEBES decir exactamente: "No tengo la información exacta en mis manuales. Por favor, aguarda un instante y te transferiré con un especialista humano." (y luego proceder a escalar).

NO INVENTES DATOS (cero alucinaciones).
Sé conciso y ve al grano.

Herramientas y Comandos (Function Calling)

Puedes dotar a tus agentes de capacidades especiales usando comandos estructurados en su respuesta. El sistema detectará estos tags y ejecutará la acción automáticamente.

Modo Estricto y Contexto (RAG)

• Modo Estricto activado: el agente SOLO responde con info de la Knowledge Base. Si no encuentra la respuesta, dice que no sabe.
• Habilitar Contexto (RAG) activado: antes de cada respuesta, el sistema busca documentos relevantes en la Knowledge Base y los incluye como contexto.

Base de Conocimiento (Knowledge Base)

Subí documentos para darle al AI Agent información específica de tu negocio.

Formatos soportados

• PDF
• DOCX (Word)
• TXT
• Texto plano

¿Qué subir?

• Catálogo de productos con precios y descripción
• Preguntas frecuentes (FAQ)
• Políticas de devolución y envío
• Horarios, ubicaciones y datos de contacto
• Procedimientos internos de atención

Tip: Los AI Agents ahora pueden navegar links de sitios web en tiempo real. Simplemente dales la instrucción en el System Prompt de usar el comando [ACTION: scrape_url({ "url": "..." })] cuando necesiten información actualizada de una web.

Cómo subir archivos

1. Abrí el AI Agent → pestaña Knowledge Base
2. Clic en Subir archivo
3. El sistema procesa y vectoriza el documento (1–5 minutos según tamaño)
4. El archivo aparece como ✅ cuando está listo

Copilot para agentes humanos

El Copilot es una función del Inbox que sugiere respuestas al agente humano usando IA.

• Aparece como un panel dentro de cada conversación activa
• Sugerencias basadas en el historial y el contexto de la conversación
• El agente puede aceptar, modificar o descartar la sugerencia
• Usa el modelo configurado en la instancia

Costos de IA (estimados)

Estos costos corresponden al proveedor de IA, no a SIGNOS. En una conversación promedio de 10 mensajes, el costo es de centavos de dólar.

Mejora continua

1. Revisá el Historial filtrando conversaciones donde participó el AI Agent
2. Anotá los casos donde el agente se equivocó o no supo responder
3. Actualizá el System Prompt con nuevas reglas
4. Agregá preguntas frecuentes nuevas a la Knowledge Base
5. Usá el Simulator para probar cambios antes de activarlos