# Glosario de Términos y Conceptos
## Inteligencia Artificial Empresarial · Induxsoft

> Referencia de términos de la plataforma IAE, inteligencia artificial, Web APIs, protocolo HTTP y JSON.  
> Organizado alfabéticamente dentro de cada sección temática.

---

## Cómo usar este glosario

Cada entrada incluye:
- **Definición** — qué es el concepto.
- **En la plataforma / En la práctica** — cómo aplica específicamente en IAE o en el trabajo del Creador.
- **Ejemplo** — cuando aplica, un fragmento concreto que ilustra el concepto.

Las entradas marcadas con 🏢 son específicas de la plataforma Induxsoft IAE.  
Las marcadas con 🤖 son conceptos generales de inteligencia artificial.  
Las marcadas con 🌐 son conceptos generales de Web APIs, HTTP o JSON.

---

---

# SECCIÓN A · Conceptos de la Plataforma IAE

---

## 🏢 Agente IAE (Agente de Inteligencia Artificial Empresarial)

**Definición:** Entidad digital autónoma que combina un modelo de lenguaje (LLM), memoria conversacional, acceso a herramientas externas y configuración personalizada para interactuar con usuarios en nombre de una organización.

**En la plataforma:** Es el producto central de la plataforma. Cada agente tiene su propio perfil, preámbulo, intenciones, canales, créditos y configuración. Un Creador puede tener agentes ilimitados con la Licencia de Creador.

**Diferencia con un chatbot tradicional:** Un chatbot sigue un árbol de decisiones fijo. El Agente IAE razona, adapta su tono, recuerda la conversación y puede ejecutar acciones en sistemas externos sin seguir un guion rígido.

**Ejemplo:** Un agente llamado "Sofía" configurado para atender clientes de una clínica: responde preguntas frecuentes, agenda citas en el calendario, identifica al paciente autenticado y escala a un humano cuando detecta una urgencia médica.

---

## 🏢 Alojamiento vectorial

**Definición:** Costo mensual de mantener vectores almacenados en el índice semántico de un motor de búsqueda. Se cobra al final de cada mes calendario según la capacidad promedio diaria usada.

**En la plataforma:** Cada vector almacenado consume **50 Créditos IA por mes**. Este costo se descuenta directamente del saldo global del plan, no de los créditos del agente individual. Si el plan no tiene saldo suficiente al momento del cobro, el motor se suspende y, si la suspensión supera un mes, toda la información alojada se elimina.

**Ejemplo de estimación:**
- 10,000 vectores × 50 créditos = 500,000 créditos/mes de alojamiento.
- 20,000 vectores × 50 créditos = 1,000,000 créditos/mes de alojamiento.

**Ver también:** Vector, Motor de resultados semánticos, Créditos IA.

---

## 🏢 Amplitud de memoria

**Definición:** Parámetro de configuración en la sección Avanzadas que controla qué porción del historial de conversación se incluye en el contexto enviado al LLM en cada turno.

**En la plataforma:** Por defecto usa toda la conversación. Reducirla disminuye el consumo de créditos a costa de que el agente pierda acceso a mensajes anteriores de la sesión. Útil para conversaciones muy largas donde los mensajes recientes son más relevantes que los iniciales.

---

## 🏢 Araña / Crawler / Spider

**Definición:** Programa automatizado que recorre sistemáticamente los enlaces de uno o varios sitios web para extraer contenido y alimentar el repositorio de información del motor de búsqueda semántica.

**En la plataforma:** Se configura en la sección de Fuentes de información del motor. Se puede programar con frecuencia diaria, semanal o mensual. La araña descubre páginas nuevas y actualiza el índice con contenido modificado desde la última exploración.

**Ejemplo de uso:** Un cliente tiene un sitio web con 300 páginas de productos. La araña indexa todo el contenido automáticamente. Cada semana revisa si hubo cambios y actualiza el índice sin intervención manual.

---

## 🏢 Auditoría de conversaciones

**Definición:** Aplicación incluida con cada agente que permite ver todas las conversaciones en tiempo real, mensaje por mensaje, con información del canal, el usuario, la marca de tiempo y el rol de cada mensaje.

**En la plataforma:** Permite hacer anotaciones sobre mensajes específicos, marcar conversaciones como revisadas, y ver resúmenes automáticos. También es el punto de acceso para ejercer el control humano (handoff) y el susurro. El acceso puede compartirse con el cliente del Creador sin transferir la propiedad del agente.

**Valor operativo:** Es la herramienta de mejora continua del agente. Si el agente responde algo incorrecto, la anotación en la auditoría guía la corrección del preámbulo o la base de conocimientos.

---

## 🏢 Comportamiento adaptativo

**Definición:** Sección de configuración del agente que agrupa los mecanismos de adaptación dinámica: temas de conversación, detección de intenciones e identificación del usuario.

**En la plataforma:** Es donde el agente aprende a detectar lo que el usuario quiere hacer (intenciones) y a ajustar su contexto según el tema de la conversación. Sin configuración en esta sección, el agente solo conversa con el contexto del preámbulo.

---

## 🏢 Conector

**Definición:** Herramienta de la plataforma que actúa como intermediario entre el agente y un sistema externo, traduciendo el formato del mensaje de un lado al formato esperado por el otro, usando código Devkron.

**En la plataforma:** Al crear un conector se genera un endpoint único (`https://connectors.induxsoft.net/{id}/`). Ese endpoint puede usarse como punto final de una intención. No requiere infraestructura propia del Creador.

**Cuándo usarlo:** Cuando el sistema externo no acepta el protocolo de integración nativo de la plataforma, o cuando se necesita transformar, combinar o filtrar información entre sistemas.

**Ejemplo:** El agente detecta la intención "consultar inventario" y llama al conector. El conector recibe el payload estándar de la plataforma, extrae el SKU del campo `data`, llama al ERP del cliente con el formato que este espera, recibe la respuesta y la devuelve en un formato que el agente puede usar.

---

## 🏢 Constante (en diseño de prompt)

**Definición:** Par clave/valor definido en la sección Avanzadas del agente que puede usarse dentro del diseño de prompt mediante la sintaxis `@nombre_constante`. Al generarse el contexto, el nombre se reemplaza por su valor.

**En la plataforma:** Permite reutilizar información en el prompt sin repetirla y facilita cambiar valores sin editar el texto completo del prompt.

**Ejemplo:**
```
Constante definida:  nombre_negocio = "Ferretería García"
Uso en el prompt:    "Eres el asistente de @nombre_negocio."
Resultado en contexto: "Eres el asistente de Ferretería García."
```

**No deben modificarse** las constantes predeterminadas del sistema sin entender su propósito.

---

## 🏢 Consumo basal

**Definición:** Cantidad mínima de Créditos IA que se asigna automáticamente a un agente cada mes al inicio del ciclo mensual, proveniente del plan al que pertenece el agente.

**En la plataforma:**
- Plan Estándar: **1,000,000 créditos/mes** por agente activo. Los pone Induxsoft directamente.
- Licencia de Creador / Planes de renta: **500,000 créditos/mes** por agente, transferidos desde el saldo del plan del Creador.

Los créditos basales son **caducables**: lo no consumido al finalizar el mes se extingue. No son acumulables.

**Ver también:** Créditos IA, Consumo adicional.

---

## 🏢 Consumo adicional

**Definición:** Créditos IA que se asignan a un agente más allá del consumo basal, ya sea de forma manual o por recarga automática desde el saldo del plan.

**En la plataforma:** Se configuran en la sección Créditos IA del agente. Se puede definir:
- **Recarga automática:** umbral mínimo de créditos y cantidad de recarga al alcanzarse.
- **Recarga manual:** el Creador agrega créditos cuando lo decide.
- **Límite mensual:** techo de consumo para evitar gastos excesivos.

Los créditos adicionales (comprados) **no caducan** y son acumulables indefinidamente.

---

## 🏢 Contexto variable

**Definición:** Mecanismo que permite inyectar información dinámica al contexto del agente al inicio de cada conversación, mediante una solicitud POST a un endpoint configurado, usando un identificador pasado por la interfaz.

**En la plataforma:** Se configura en la sección Avanzadas. El identificador llega al agente a través del parámetro de URL `?var_context_id=` o del campo `context_var_id` del servicio web. El agente hace un POST al endpoint configurado con ese ID, y el endpoint devuelve la información de contexto correspondiente.

**Ejemplo de uso:** Un agente embebido en el sitio de una cadena con 5 sucursales. Cada sucursal tiene su propia URL con `?var_context_id=sucursal_norte`. El endpoint devuelve los horarios, precios y nombre del gerente de esa sucursal específica. El agente tiene contexto localizado sin cambiar su configuración.

---

## 🏢 Control humano (Handoff)

**Definición:** Capacidad que permite a un operador humano tomar el control de una conversación activa del agente, enviar mensajes directamente al usuario, y devolver el control al agente cuando lo decide.

**En la plataforma:** Disponible desde la auditoría de conversaciones y a través de la API del servicio web (`/handoff/{chat_id}/`). El campo `ai_control: false` desactiva al agente; `ai_control: true` lo reactiva. Se puede hacer intervención conjunta (IA + humano activos al mismo tiempo).

**Ejemplo API:**
```json
POST /svc/{agent_id}/handoff/{chat_id}/
{
  "ai_control": false,
  "message": {
    "text": "Hola, soy Carlos del área de soporte. ¿En qué le puedo ayudar?",
    "human": "Carlos"
  }
}
```

---

## 🏢 Creador

**Definición:** Perfil de usuario de la plataforma IAE que crea, configura y administra Agentes IAE para sus propios clientes. Generalmente un profesional independiente, agencia digital o empresa de tecnología.

**En la plataforma:** Con la Licencia de Creador, tiene agentes ilimitados, cuenta unificada de créditos y acceso a la Cuenta Maestra. Es el dueño de los agentes que crea; puede compartir la administración con sus clientes sin transferir la propiedad.

---

## 🏢 Crédito IA

**Definición:** Unidad de medida del costo de la infraestructura necesaria para operar soluciones de IA Empresarial en la plataforma de Induxsoft. Abstrae el costo real de tokens de LLM, vectorización, almacenamiento y comunicaciones en una única unidad.

**En la plataforma:** Todo consumo se mide en Créditos IA. Se consumen en conversaciones, vectorización, alojamiento vectorial, mensajes de WhatsApp y uso de herramientas que reprocesen respuestas con IA.

**Equivalencias aproximadas:**
- 2–3 tokens de entrada de GPT-5 ≈ 1 Crédito IA
- 1–2 tokens de salida de GPT-5 ≈ 1 Crédito IA
- 1 palabra vectorizada ≈ 1 Crédito IA
- Conversación promedio (5 turnos) ≈ 5,000–10,000 Créditos IA
- 1 vector almacenado ≈ 50 Créditos IA/mes
- 1 mensaje WhatsApp Managed ≈ 320 Créditos IA
- WhatsApp QR Connect ≈ 300,000 Créditos IA/mes (mensajes ilimitados)

---

## 🏢 Cuenta Maestra

**Definición:** Portal exclusivo para distribuidores autorizados de Induxsoft (Creadores con plan Profesional o Licencia de Creador) desde el que se crean y administran suscripciones de Cloud V12 / Small Business Portal para sus clientes.

**En la plataforma:** Incluye gestión de clientes, licencias, renovaciones, puntos, facturas, reportes y herramientas de operación. El Creador con Licencia de Creador tiene un año de acceso gratuito.

---

## 🏢 Detección de intención

**Definición:** Proceso mediante el cual el agente evalúa el contexto y la memoria conversacional para determinar si la interacción del usuario corresponde a alguna intención previamente configurada, con el fin de ejecutar la herramienta asociada.

**En la plataforma:** El agente no ejecuta la herramienta hasta haber recopilado todos los datos requeridos según las instrucciones de la intención. Si falta algún dato obligatorio, sigue conversando para obtenerlo.

**Ver también:** Intención, Herramienta (en IAE).

---

## 🏢 Disparadores

**Definición:** Configuración en la sección Avanzadas del agente que permite definir acciones automáticas en respuesta a eventos específicos: de monitoreo (durante la conversación) o de finalización (cuando la conversación termina).

**En la plataforma:** Permiten notificar a sistemas externos, registrar eventos o ejecutar procesos automáticos sin intervención del operador.

---

## 🏢 Duplicar agente

**Definición:** Función de la Zona de peligro que crea una copia exacta de un agente (con todas sus configuraciones) bajo un nuevo nombre, sin afectar al original.

**En la plataforma:** Es la forma recomendada de usar agentes exitosos como plantillas para nuevos clientes del mismo giro. Ahorra tiempo de configuración y garantiza consistencia entre implementaciones similares.

---

## 🏢 Herramienta (en IAE)

**Definición:** Mecanismo que permite al agente interactuar con sistemas externos a través de solicitudes HTTP cuando detecta una intención del usuario. Incluye el endpoint, la autorización, los parámetros y el modo de procesar la respuesta.

**En la plataforma:** Las herramientas no consumen Créditos IA al ejecutarse, a menos que la respuesta del sistema externo deba ser reprocesada por el LLM antes de entregarse al usuario.

**Tipos de acción que ejecutan las herramientas:**
- Consultar información (inventario, saldo, disponibilidad)
- Registrar datos (pedido, cita, lead)
- Validar identidad (sesión de usuario)
- Obtener contexto dinámico

---

## 🏢 Identificación del usuario

**Definición:** Mecanismo de la sección Comportamiento adaptativo que permite al agente validar un token de sesión contra un sistema externo para obtener la identidad y el contexto del usuario autenticado.

**En la plataforma:** El token llega al agente como `user_sid`. El agente hace un POST al endpoint de validación configurado. Si la respuesta incluye `"success": true`, el agente conoce el nombre, correo, teléfono y cualquier contexto adicional del usuario. Si falla, trata al usuario como anónimo sin alertas.

**Ejemplo de respuesta válida del endpoint de validación:**
```json
{
  "success": true,
  "user": "usr_12345",
  "user_name": "Ana López",
  "user_email": "ana@empresa.com",
  "user_type": "cliente_premium",
  "context": "El cliente tiene contrato activo hasta diciembre de 2025."
}
```

---

## 🏢 Indicaciones por canal

**Definición:** Configuración en Avanzadas → Más opciones que permite agregar contexto adicional específico para un canal determinado, e incluso asignar un `var_context_id` diferente según el canal.

**En la plataforma:** Permite que el agente se comporte diferente en WhatsApp (mensajes cortos, tono casual) que en el chat web corporativo (respuestas extensas, tono formal), usando el mismo agente base.

---

## 🏢 Índice semántico / Índice vectorial

**Definición:** Base de datos especializada que almacena vectores — representaciones matemáticas del significado de fragmentos de información — y permite encontrar los más relevantes para una consulta dada mediante proximidad geométrica.

**En la plataforma:** Induxsoft usa vectores `text-embedding-ada-002` de 1,536 dimensiones. El índice admite atributos adicionales para filtrado de resultados. Cada vector en el índice genera un costo de alojamiento de 50 Créditos IA/mes.

---

## 🏢 Intención

**Definición:** Descripción configurada de lo que un usuario podría querer lograr al interactuar con el agente, que cuando es detectada por el agente desencadena la ejecución de una herramienta externa.

**En la plataforma:** Cada intención tiene un ID único, una descripción para que el agente la reconozca, instrucciones detalladas de qué datos recopilar, el endpoint de la herramienta a ejecutar, y la configuración de cómo manejar la respuesta.

**Ejemplo de configuración:**
```
ID:           registrar-pedido
Descripción:  El usuario quiere hacer un pedido de productos.
Instrucciones: Recopilar: nombre del cliente, productos (nombre y cantidad),
               dirección de entrega, teléfono de contacto.
               No ejecutar hasta tener al menos un producto y dirección.
Endpoint:     https://mi-sistema.com/api/pedidos/
Respuesta:    Responder el texto sin cambios (la API ya devuelve la confirmación)
Ejecución:    Una sola vez
```

---

## 🏢 Intervención conjunta (IA + humano)

**Definición:** Modo de operación en el que el agente de IA y un operador humano están activos al mismo tiempo en una conversación, pudiendo ambos enviar mensajes al usuario de forma coordinada.

**En la plataforma:** El operador puede enviar mensajes sin desactivar al agente. Útil para situaciones donde el humano quiere complementar sin interrumpir el flujo de la IA.

---

## 🏢 Libreta de órdenes

**Definición:** Herramienta de la plataforma que permite registrar y gestionar solicitudes de usuarios (pedidos, citas, reservaciones, quejas, cotizaciones) a través de un sistema de tarjetas con estados simples: Recibida → Atendida / Descartada.

**En la plataforma:** Se conecta al agente mediante una intención cuyo endpoint apunta a `https://agent.induxsoft.net/orders/{id_libreta}/`. Las órdenes se eliminan automáticamente después de 30 días. Tiene API REST para integración con sistemas externos.

**Ejemplo de endpoint de integración:**
```
POST https://agent.induxsoft.net/orders/libreta_abc123/
Authorization: Bearer mi_token_secreto
```

---

## 🏢 Licencia de Creador

**Definición:** Modalidad de acceso a la plataforma IAE de pago único que otorga agentes ilimitados, 50 millones de Créditos IA sin caducidad, cuenta unificada y acceso a Cuenta Maestra.

**En la plataforma:** Es intransferible y está vinculada al perfil que la adquirió. A partir de la compra, el Creador solo necesita adquirir más Créditos IA según el consumo de sus agentes activos. Incluye un año gratuito de acceso a Cuenta Maestra.

---

## 🏢 Memoria de trabajo

**Definición:** Mecanismo que permite al agente guardar en la conversación el resultado de una herramienta bajo una etiqueta específica, preservando datos relevantes para turnos futuros aunque el LLM no los considere prioritarios en ese momento.

**En la plataforma:** Se activa en la configuración de respuesta de una intención. Útil para preservar datos del usuario (RFC, número de cliente, preferencias) sin pedirlos de nuevo más adelante en la misma sesión.

**Ejemplo:** La intención "identificar cliente" consulta el CRM y guarda en memoria de trabajo con la etiqueta "datos_cliente". Más adelante, cuando el usuario hace un pedido, el agente ya tiene su nombre, dirección y preferencias sin preguntar.

---

## 🏢 Memoria conversacional

**Definición:** Historial completo de la conversación en curso que el agente incluye en su contexto en cada turno para mantener coherencia y capacidad de razonamiento sobre lo que se ha dicho.

**En la plataforma:** Representada en el diseño de prompt con el elemento `{"role": "memory"}`. La amplitud de la memoria es configurable para optimizar el consumo de créditos en conversaciones largas.

---

## 🏢 Mensajes predeterminados

**Definición:** Textos de respuesta estáticos que el agente usa cuando el usuario intenta activar una capacidad que no está habilitada (enviar imagen cuando la visión está desactivada, enviar audio cuando el oído está desactivado, etc.).

**En la plataforma:** Se configuran en Avanzadas → Más opciones → Mensajes predeterminados.

---

## 🏢 Motor de resultados semánticos

**Definición:** Infraestructura completa de búsqueda semántica que incluye el servicio de búsqueda, el índice vectorial y el repositorio de contenido. Es la pieza fundamental para implementar RAG en los agentes.

**En la plataforma:** Se crea y administra en la sección correspondiente de IAE. Tiene su propio token de acceso. Se alimenta con sitios web (via crawler), documentos PDF y la API del motor. Se conecta al agente como herramienta de una intención.

**API del motor — endpoint de búsqueda:**
```
POST https://search.api.induxsoft.net/{seid}/
    ?query-field=reformulated_question
    &result=answer
    &model=smart
    &limit=10
```

---

## 🏢 NIA

**Definición:** Asistente de soporte técnico con inteligencia artificial de Induxsoft, disponible 24/7 a través del portal para resolver dudas operativas y técnicas de la plataforma.

**En la plataforma:** Es el primer nivel de soporte. Si NIA no puede resolver el caso, canaliza con soporte humano. Accesible para todos los usuarios del portal.

---

## 🏢 NIC (Número de Identificación de Cliente)

**Definición:** Identificador único asignado a cada cliente en el portal de Induxsoft, usado para localizar rápidamente al usuario al abrir un caso de soporte técnico.

**En la plataforma:** Se crea desde la sección de perfil o configuración de cuenta del portal. Recomendado tenerlo desde el primer día de uso.

---

## 🏢 Parámetros (en el agente)

**Definición:** Pares clave/valor que se envían en el campo `params` de todas las solicitudes HTTP del agente (intenciones, contexto variable, validación de sesión). Pueden ser globales (aplican a todas las llamadas) o específicos por intención.

**En la plataforma:** Cualquier parámetro de URL que no sea `user_sid`, `var_context_id` o `topic` también se incorpora automáticamente como parámetro global. Útil para pasar información de rastreo (UTMs, ID de sucursal, campaña).

**Ejemplo:**
```
URL:  ?utm_source=google&sucursal=norte
Resultado en params de la intención:
{
  "params": {
    "utm_source": "google",
    "sucursal": "norte"
  }
}
```

---

## 🏢 Perfil del agente

**Definición:** Sección de configuración donde se define la identidad del agente: nombre, descripción (rol, tono, personalidad) y foto.

**En la plataforma:** El nombre puede usar el caracter `|` como separador para agregar etiquetas organizativas sin que el agente las reconozca como parte de su nombre. Ejemplo: `Ely|ClienteA` → el agente se llama `Ely`.

---

## 🏢 Plan Estándar

**Definición:** Plan sin costo de licencia disponible para todos los usuarios del portal. Permite crear agentes pagando por cada uno individualmente. Cada agente activo recibe 1 millón de créditos basales al mes, otorgados directamente por Induxsoft.

**En la plataforma:** Es la opción para clientes finales que quieren un agente llave en mano. Los Créditos IA adicionales se compran en paquetes de 1 o 5 millones.

---

## 🏢 Plantilla de respuesta (en libretas de órdenes)

**Definición:** Texto configurable en la libreta de órdenes que define el mensaje que el agente devuelve al usuario cuando registra una orden. Puede referenciar campos del payload usando dobles llaves.

**Sintaxis de referencia:**
- Campo dentro de `data`: `{{nombre_campo}}`
- Campo en la raíz del payload: `{{@nombre_campo}}`
- Campo en `params`: `{{$nombre_campo}}`

**Ejemplo:**
```
"Tu pedido fue registrado con el folio {{@folio}}.
 Producto: {{producto}} · Cantidad: {{cantidad}}
 Te contactaremos en {{$telefono_sucursal}}."
```

---

## 🏢 Preámbulo

**Definición:** Sección de configuración del agente que define su comportamiento a través de tres campos: Reglas generales, Conocimientos generales y Saludo inicial.

**En la plataforma:** Es el equivalente a las instrucciones de trabajo del agente. Un preámbulo bien escrito produce respuestas precisas y coherentes con el negocio. Uno vacío o vago produce un agente genérico.

- **Reglas generales:** instrucciones de comportamiento (tono, límites, cómo manejar situaciones específicas).
- **Conocimientos generales:** información factual del negocio (qué vende, cómo opera, políticas, preguntas frecuentes).
- **Saludo inicial:** primer mensaje al usuario al iniciar la conversación.

---

## 🏢 Protocolo de integración

**Definición:** Especificación del formato de solicitud y respuesta que usa el agente para comunicarse con herramientas externas (intenciones, contexto variable, validación de sesión).

**En la plataforma:** El agente envía siempre un POST con este payload estándar:

```json
{
  "intention": "id-de-la-intención",
  "preliminary_answer": "Respuesta preliminar del LLM",
  "original_question": "Mensaje original del usuario",
  "reformulated_question": "Mensaje reformulado por el LLM",
  "agent_id": "abc123",
  "agent_name": "Sofía",
  "chat_id": "conv_xyz",
  "user_sid": "token-de-sesion",
  "user": "usr_001",
  "user_name": "Juan Pérez",
  "data": { "campo1": "valor1", "campo2": "valor2" },
  "params": { "sucursal": "norte" }
}
```

La respuesta puede ser cualquier formato, ya que el agente la devuelve tal cual o la reprocesa con el LLM según la configuración de la intención.

---

## 🏢 Punto final (Endpoint)

**Definición:** URL de un servicio web que el agente invoca mediante HTTP para ejecutar una herramienta, validar una sesión de usuario, recuperar contexto variable, o conectarse con sistemas externos.

**En la plataforma:** Se configura en las intenciones, en la identificación del usuario y en el contexto variable. Debe ser una URL accesible públicamente (o al menos desde los servidores de Induxsoft) que acepte solicitudes POST.

**Ejemplos de endpoints en la plataforma:**
```
Libreta de órdenes:  https://agent.induxsoft.net/orders/{id}/
Conector:            https://connectors.induxsoft.net/{id}/
Motor semántico:     https://search.api.induxsoft.net/{seid}/
Servicio del agente: https://agent.induxsoft.net/svc/{agent_id}/
```

---

## 🏢 Recarga automática

**Definición:** Configuración en la sección Créditos IA del agente que define un umbral mínimo de créditos y una cantidad de recarga. Cuando el saldo del agente baja del umbral, se transfiere automáticamente la cantidad de recarga desde el saldo del plan.

**En la plataforma:** Si el saldo del plan no alcanza para la recarga completa, se transfiere todo lo disponible. Si el agente se queda sin créditos, deja de funcionar temporalmente hasta que haya saldo disponible para recargar.

---

## 🏢 Repositorio de contenido

**Definición:** Colección de documentos e información indexada que sirve como base de conocimientos del motor de búsqueda semántica. Puede contener páginas web capturadas por el crawler, documentos PDF subidos manualmente, o contenido agregado a través de la API del motor.

**Ver también:** Motor de resultados semánticos, Índice semántico, Araña.

---

## 🏢 Saldo global del plan

**Definición:** Cuenta de créditos asociada al plan del Creador (no a un agente individual) de la que se descuentan los consumos de infraestructura y comunicaciones: alojamiento vectorial, mensajes de WhatsApp Managed y QR, y recargas automáticas de agentes.

**En la plataforma:** Si el saldo global llega a cero, los servicios de comunicación se suspenden. El saldo puede quedar en negativo si el cobro de infraestructura ocurre sin saldo suficiente.

---

## 🏢 Servicio web del agente (API)

**Definición:** Conjunto de endpoints REST que expone la funcionalidad del agente para consumo programático: envío de mensajes, toma de control humano (handoff), susurro, obtención de información de conversación, recuperación de mensajes y listado de conversaciones.

**Endpoint base:**
```
https://agent.induxsoft.net/svc/{agent_id}/
Authorization: Bearer {código de seguridad del agente}
```

**Ver también:** Handoff, Susurro.

---

## 🏢 Small Business Portal (SBP)

**Definición:** Subconjunto de la plataforma V12 con interfaz simplificada para usuarios finales. Incluye acceso a agentes adquiridos, calendarios, libretas de órdenes y conversaciones internas.

**En la plataforma:** Costo de $120 MXN/usuario concurrente/mes. El Creador con Cuenta Maestra crea y administra las suscripciones de SBP para sus clientes.

---

## 🏢 Susurro (Whisper)

**Definición:** Información contextual que se inyecta al agente antes de su próximo turno de respuesta, sin que el usuario vea ese contenido. El agente incorpora el susurro en su respuesta siguiente.

**En la plataforma:** Se envía vía API a `/svc/{agent_id}/whisper/{chat_id}/`.

**Ejemplo:**
```json
POST /svc/agt_001/whisper/conv_abc/
{ "text": "El cliente tiene una queja pendiente del mes pasado. Trátalo con prioridad y empatía." }
```
El usuario solo ve la respuesta del agente, enriquecida con ese contexto.

---

## 🏢 Temas de conversación

**Definición:** Configuración en la sección Comportamiento adaptativo que define contextos específicos para distintas áreas de interés, con sus propios saludos, preguntas preparadas y contexto adicional (incluyendo URLs de tablas).

**En la plataforma:** Cada tema tiene un ID que puede activarse desde la URL con `?topic=`. El agente también detecta automáticamente el tema más adecuado según el flujo de la conversación. Los saludos configurados se muestran aleatoriamente.

**Ejemplo de uso de `{{url}}` en el contexto del tema:**
```
Contexto del tema "refrigeradores":
"Información actualizada de modelos disponibles: {{https://tablas.ejemplo.com/tabla_refrigeradores}}"
```

---

## 🏢 Vectorizador

**Definición:** Componente del motor de búsqueda semántica que procesa documentos extensos dividiéndolos en fragmentos temáticos coherentes, genera sus vectores de representación semántica y los almacena en el índice.

**En la plataforma:** Usa un LLM para automatizar la división en fragmentos, la generación de resúmenes y la asignación de atributos de filtro. El costo de vectorización es aproximadamente 1 Crédito IA por palabra procesada.

---

## 🏢 Zona de peligro

**Definición:** Sección de configuración del agente que agrupa acciones irreversibles o de alto impacto: compartir administración, duplicar agente, suspender/reactivar y eliminar.

**En la plataforma:** Se llama "de peligro" porque estas acciones afectan al agente de forma significativa. Eliminar un agente es irreversible. Los créditos adicionales se reintegran al plan al eliminar.

---

---

# SECCIÓN B · Conceptos Generales de Inteligencia Artificial

---

## 🤖 Alucinación

**Definición:** Fenómeno en el que un modelo de lenguaje genera información que suena plausible pero que es incorrecta, inventada o sin fundamento en los datos con los que fue entrenado o en el contexto proporcionado.

**En la práctica:** Es el principal riesgo en aplicaciones empresariales. Un agente puede inventar precios, políticas o datos de contacto si no tiene información real en su contexto.

**Cómo reducirlas:**
- Escribe un preámbulo que indique explícitamente: *"Si no tienes información suficiente, dilo claramente y no inventes."*
- Baja el nivel de creatividad (temperatura).
- Usa RAG para proveer información factual real en lugar de depender del conocimiento del modelo.
- Limita el scope del agente a los temas que sí tiene documentados.

---

## 🤖 Embedding (Incrustación vectorial)

**Definición:** Representación numérica de un texto como un vector de alta dimensionalidad que captura su significado semántico. Textos con significado similar tienen vectores geométricamente cercanos.

**En la plataforma:** Induxsoft usa el modelo `text-embedding-ada-002` de OpenAI, que genera vectores de 1,536 dimensiones. Cada fragmento de documento y cada consulta del usuario se convierte en un embedding para realizar búsquedas por similitud semántica.

**Ejemplo conceptual:**
- "¿Cuánto cuesta el servicio?" → vector [0.23, -0.11, 0.87, ...]
- "¿Cuál es el precio?" → vector [0.25, -0.09, 0.85, ...]
- Ambos vectores están muy cerca → la búsqueda los relaciona correctamente.

---

## 🤖 Fine-tuning (Ajuste fino)

**Definición:** Proceso de reentrenamiento de un modelo de lenguaje con un conjunto de datos específico para mejorar su desempeño en un dominio particular.

**En la práctica:** La plataforma IAE no requiere fine-tuning. El comportamiento del agente se personaliza mediante el preámbulo, el prompt, las intenciones y el RAG, sin necesidad de reentrenar el modelo base.

---

## 🤖 IA de segundo paso (Second-pass AI)

**Definición:** Procesamiento adicional donde la respuesta de un sistema externo (herramienta) se vuelve a introducir al LLM para que la interprete, reformule y presente al usuario de forma natural y coherente con el contexto de la conversación.

**En la práctica:** Útil cuando la herramienta devuelve datos técnicos o estructurados que el usuario no leería directamente. El agente transforma `{"saldo": 1500.00, "moneda": "MXN"}` en *"Tu saldo disponible es de $1,500.00 pesos."*

---

## 🤖 Inferencia

**Definición:** Proceso de ejecución de un modelo de lenguaje para generar una respuesta a partir de un input dado. Es el "uso" del modelo, a diferencia del entrenamiento.

**En la práctica:** Cada vez que el agente responde a un mensaje, está realizando inferencia. Es el proceso que consume Créditos IA.

---

## 🤖 LLM (Large Language Model / Modelo de Lenguaje Grande)

**Definición:** Modelo de inteligencia artificial entrenado con enormes volúmenes de texto que puede entender y generar lenguaje natural con alta coherencia y versatilidad.

**En la plataforma:** El Creador puede elegir entre varios LLMs para cada agente según el balance de capacidad y costo requerido:

| Modelo | Fabricante | Características |
|---|---|---|
| GPT-5.2 | OpenAI | Máxima capacidad |
| GPT-5 | OpenAI | Muy alta capacidad |
| GPT-5 mini | OpenAI | Balance capacidad/costo |
| GPT-4.1 | OpenAI | Alta capacidad |
| GPT-4.1 mini | OpenAI | Rápido y eficiente |
| Gemini Pro 2.5 | Google | Alta capacidad multimodal |
| Gemini Flash 2.5 | Google | Rápido y económico |
| DeepSeek 3.4 Chat | DeepSeek | Conversacional eficiente |
| DeepSeek 3.4 Reasoner | DeepSeek | Razonamiento extendido |

---

## 🤖 Prompt

**Definición:** Conjunto de instrucciones y contexto que se proporciona al LLM para guiar su comportamiento y respuestas. Es la "interfaz" entre el configurador del agente y el modelo.

**En la plataforma:** El prompt del agente se construye dinámicamente en cada turno combinando: el diseño de prompt (definido en Avanzadas), las constantes, el preámbulo, la memoria conversacional, el contexto del tema, el contexto variable y la identidad del usuario. El Creador controla todos estos elementos.

**Estructura del prompt en la plataforma (formato JSON):**
```json
[
  {"role": "system", "text": "Eres @nombre_agente, asistente de @nombre_negocio..."},
  {"role": "system", "text": "Reglas: @reglas_generales"},
  {"role": "memory"},
  {"role": "user", "text": "..."}
]
```

---

## 🤖 RAG (Retrieval Augmented Generation / Generación Aumentada por Recuperación)

**Definición:** Técnica que combina la recuperación de información relevante de una base de conocimientos con la capacidad generativa de un LLM para producir respuestas más precisas, actualizadas y fundamentadas en datos reales.

**Flujo de RAG:**
1. El usuario hace una pregunta.
2. La pregunta se vectoriza (se convierte en embedding).
3. Se buscan los fragmentos del índice con vectores más cercanos al de la pregunta.
4. Los fragmentos relevantes se incluyen en el contexto del LLM.
5. El LLM genera una respuesta fundamentada en esa información real.

**En la plataforma:** Se implementa mediante el Motor de resultados semánticos conectado al agente como una intención de búsqueda.

**Ventaja sobre el preámbulo estático:** El preámbulo tiene un límite práctico de información. RAG permite que el agente tenga acceso a cientos o miles de documentos sin saturar el contexto.

---

## 🤖 Temperatura (Nivel de creatividad)

**Definición:** Parámetro del LLM que controla cuánta variabilidad o "libertad" tiene el modelo al generar respuestas. Valores bajos producen respuestas más predecibles y conservadoras; valores altos producen respuestas más variadas y creativas, pero con mayor riesgo de alucinaciones.

**En la plataforma:** Denominado "Nivel de creatividad" en la sección Opciones del agente. Para uso empresarial se recomienda mantenerlo bajo o moderado.

---

## 🤖 Token

**Definición:** Unidad mínima de procesamiento de texto en un LLM. Aproximadamente equivale a ¾ de una palabra en inglés o algo menos en español. Los LLMs no procesan texto letra por letra sino en tokens.

**En la práctica:** El costo de usar un LLM se mide en tokens. La plataforma abstrae esto en Créditos IA. Equivalencias aproximadas para GPT-5: 2-3 tokens de entrada ≈ 1 Crédito IA; 1-2 tokens de salida ≈ 1 Crédito IA.

---

## 🤖 Vector

**Definición:** Representación matemática de información como un arreglo de números de punto flotante que captura el significado semántico de un texto. La proximidad entre vectores indica similitud de significado.

**En la plataforma:** Los vectores se almacenan en el índice semántico del motor. Cada vector ocupa 50 Créditos IA/mes de alojamiento. Induxsoft usa vectores de 1,536 dimensiones generados con el modelo `text-embedding-ada-002`.

**Analogía:** Si el significado de un texto es su "ubicación" en un espacio multidimensional, dos textos con significado similar están "cerca" en ese espacio. La búsqueda semántica encuentra los textos más cercanos a la pregunta.

---

---

# SECCIÓN C · Web APIs y Arquitectura REST

---

## 🌐 API (Application Programming Interface / Interfaz de Programación de Aplicaciones)

**Definición:** Conjunto de reglas y especificaciones que define cómo dos sistemas de software pueden comunicarse entre sí. Una Web API expone esa interfaz a través de la red mediante el protocolo HTTP.

**En la práctica:** Cuando el agente llama a un sistema externo para registrar un pedido, está usando la API de ese sistema. Cuando el Creador usa el servicio web del agente, está usando la API de la plataforma.

**Componentes de una llamada a API:**
- **Endpoint (URL):** la dirección del recurso.
- **Método HTTP:** la acción a realizar (GET, POST, PUT, DELETE).
- **Encabezados (Headers):** metadatos como autorización y tipo de contenido.
- **Cuerpo (Body / Payload):** los datos enviados (en POST y PUT).
- **Respuesta:** la información devuelta por el servidor.

---

## 🌐 API Key / Token de autorización

**Definición:** Cadena de texto que funciona como contraseña para autenticar solicitudes a una API. Se envía en el encabezado `Authorization` de la solicitud HTTP.

**En la plataforma:** El agente usa tokens de autorización al llamar a herramientas externas (configurados en cada intención) y al exponer su propio servicio web (código de seguridad del agente).

**Formato más común (Bearer token):**
```
Authorization: Bearer mi_token_secreto_aqui
```

**Importante:** Los tokens son secretos. Nunca deben exponerse en el código del lado cliente ni en URLs públicas.

---

## 🌐 Autenticación vs. Autorización

**Definición:**
- **Autenticación:** verificar quién es el que hace la solicitud ("¿eres tú quien dices ser?").
- **Autorización:** verificar qué puede hacer esa entidad ("¿tienes permiso para hacer esto?").

**En la práctica:** El token de autorización del agente autentica que la solicitud viene de un sistema legítimo. La validación de sesión del usuario (`user_sid`) autentica que el usuario es quien dice ser. Los privilegios configurados en "Compartir administración" definen la autorización del co-administrador.

---

## 🌐 Base64

**Definición:** Esquema de codificación que convierte datos binarios (imágenes, archivos) en una cadena de caracteres ASCII, permitiendo transmitirlos en formatos que solo aceptan texto, como JSON.

**En la plataforma:** El servicio web del agente acepta archivos como Base64 en el campo `file` del payload. El endpoint de handoff también acepta attachments como Base64.

**Ejemplo conceptual:**
```json
{
  "file": "JVBERi0xLjQKJeLj...",
  "filename": "contrato.pdf"
}
```

---

## 🌐 CRUD

**Definición:** Acrónimo de las cuatro operaciones básicas sobre datos: Create (Crear), Read (Leer), Update (Actualizar), Delete (Eliminar). Corresponden a los métodos HTTP POST, GET, PUT/PATCH y DELETE respectivamente.

**En la plataforma:** La API de libretas de órdenes es un buen ejemplo de CRUD:
- Crear orden: `POST /orders/{id_libreta}/`
- Leer orden: `GET /order/{order_guid}/`
- Actualizar orden: `PUT /order/{order_guid}/`
- Eliminar orden: `DELETE /order/{order_guid}/`

---

## 🌐 Endpoint (Punto final)

**Definición:** URL específica de una API que representa un recurso o acción determinada. Cada endpoint acepta uno o más métodos HTTP y tiene un comportamiento definido.

**En la práctica:** Cada funcionalidad de una API tiene su propio endpoint. Combinar el endpoint con el método HTTP correcto es lo que determina qué operación se ejecuta.

**Ejemplos en la plataforma:**
```
GET  https://agent.induxsoft.net/svc/{id}/{chat_id}/           → info de conversación
POST https://agent.induxsoft.net/svc/{id}/                     → enviar mensaje al agente
POST https://agent.induxsoft.net/svc/{id}/handoff/{chat_id}/   → tomar control humano
POST https://agent.induxsoft.net/svc/{id}/whisper/{chat_id}/   → enviar susurro
GET  https://agent.induxsoft.net/svc/{id}/conversations/       → listar conversaciones
```

---

## 🌐 Paginación

**Definición:** Técnica para dividir grandes conjuntos de resultados en subconjuntos más pequeños y manejables, evitando que una sola respuesta de API sea demasiado grande.

**En la plataforma:** La API del servicio web del agente usa paginación por cursor (ID de referencia) con los parámetros `after`, `before` y `last`, más `limit` para controlar la cantidad de registros.

**Ejemplos:**
```
# Últimos 10 mensajes de una conversación
GET /svc/{id}/{chat_id}/messages/?last=10

# 20 mensajes después de un mensaje específico
GET /svc/{id}/{chat_id}/messages/?after={message_id}&limit=20

# Conversaciones del agente en una fecha específica
GET /svc/{id}/conversations/?fi=2025-01-01&ff=2025-01-31&limit=50
```

---

## 🌐 REST (Representational State Transfer)

**Definición:** Estilo arquitectónico para diseñar servicios web. Usa HTTP como protocolo, identifica recursos mediante URLs y opera sobre ellos con métodos HTTP estándar. Las APIs que siguen este estilo se llaman "RESTful".

**Principios clave:**
- Cada URL representa un recurso.
- Las operaciones se expresan con métodos HTTP.
- El servidor no guarda estado entre solicitudes (stateless).
- Las respuestas son autodescriptivas (usualmente en JSON).

**En la práctica:** Todas las APIs de la plataforma IAE son REST. El agente llama a las herramientas externas esperando que también sean endpoints REST.

---

## 🌐 Webhook

**Definición:** Mecanismo en el que un sistema notifica activamente a otro enviando una solicitud HTTP POST a una URL configurada cuando ocurre un evento. A diferencia de la consulta periódica (polling), el webhook "empuja" la información cuando está disponible.

**En la práctica:** WhatsApp Business Platform Cloud API usa webhooks para entregar los mensajes recibidos al servidor de Induxsoft. Cuando un usuario envía un mensaje, Meta hace un POST al webhook de Induxsoft, que lo procesa y se lo entrega al agente.

**Ejemplo conceptual:**
```
Usuario envía mensaje en WhatsApp
→ Meta hace POST al webhook de Induxsoft
→ Induxsoft procesa el mensaje
→ El agente genera la respuesta
→ Induxsoft envía la respuesta a Meta
→ Meta la entrega al usuario
```

---

---

# SECCIÓN D · Protocolo HTTP

---

## 🌐 HTTP (HyperText Transfer Protocol)

**Definición:** Protocolo de comunicación de la web que define cómo se intercambian mensajes entre un cliente (quien hace la solicitud) y un servidor (quien la responde). La plataforma IAE usa HTTP para toda comunicación entre el agente y los sistemas externos.

**Versiones relevantes:**
- **HTTP/1.1:** la más extendida en APIs.
- **HTTPS:** HTTP con cifrado TLS. Todas las URLs de la plataforma usan HTTPS.

---

## 🌐 Métodos HTTP

**Definición:** Verbos que indican la acción a realizar sobre el recurso identificado por la URL.

| Método | Propósito | ¿Tiene body? | Uso en IAE |
|---|---|---|---|
| **GET** | Obtener/leer un recurso | No | Leer conversaciones, mensajes, órdenes |
| **POST** | Crear un recurso o enviar datos | Sí | Enviar mensajes, invocar intenciones, crear órdenes |
| **PUT** | Actualizar un recurso completo | Sí | Actualizar una orden |
| **PATCH** | Actualizar parcialmente un recurso | Sí | Modificaciones parciales |
| **DELETE** | Eliminar un recurso | No | Eliminar una orden |

**Nota importante:** El protocolo de integración de la plataforma siempre usa **POST**, sin excepción. El agente siempre hace POST a los endpoints de herramientas, contexto variable y validación de sesión.

---

## 🌐 Encabezados HTTP (Headers)

**Definición:** Metadatos que se envían junto con una solicitud o respuesta HTTP para proporcionar información adicional sobre el mensaje: tipo de contenido, autenticación, codificación, etc.

**Encabezados más usados en la plataforma:**

```
Authorization: Bearer {token}
Content-Type: application/json; charset=utf-8
```

- **`Authorization`:** lleva el token de autenticación. El agente lo envía al llamar a herramientas externas, y los sistemas externos deben incluirlo al llamar al servicio web del agente.
- **`Content-Type: application/json`:** indica que el cuerpo de la solicitud está en formato JSON. Es requerido en todas las llamadas POST de la plataforma.

---

## 🌐 Solicitud HTTP (Request)

**Definición:** Mensaje que un cliente envía a un servidor para solicitar una acción sobre un recurso. Compuesto por: método, URL, encabezados y opcionalmente un cuerpo.

**Estructura de una solicitud POST típica en la plataforma:**
```
Method: POST
URL: https://agent.induxsoft.net/svc/{agent_id}/

Headers:
  Authorization: Bearer abc123xyz
  Content-Type: application/json; charset=utf-8

Body (Payload):
{
  "message": "¿Cuál es el precio del servicio básico?",
  "chat_id": "",
  "user_name": "Carlos"
}
```

---

## 🌐 Respuesta HTTP (Response)

**Definición:** Mensaje que el servidor envía de vuelta al cliente como resultado de procesar una solicitud. Incluye un código de estado, encabezados y usualmente un cuerpo con los datos.

**Estructura de una respuesta típica de la plataforma:**
```
Status: 200 OK
Content-Type: application/json

Body:
{
  "success": true,
  "data": {
    "chat_id": "conv_abc123",
    "response": "El servicio básico tiene un costo de $499 al mes.",
    "isbusy": false
  }
}
```

---

## 🌐 Códigos de estado HTTP

**Definición:** Número de tres dígitos que indica el resultado de la solicitud HTTP. El primer dígito define la categoría.

| Rango | Categoría | Significado |
|---|---|---|
| 2xx | Éxito | La solicitud fue procesada correctamente |
| 4xx | Error del cliente | La solicitud tiene algún problema |
| 5xx | Error del servidor | El servidor falló al procesar |

**Códigos más comunes:**

| Código | Nombre | Cuándo aparece |
|---|---|---|
| **200** | OK | Solicitud exitosa |
| **201** | Created | Recurso creado exitosamente (POST) |
| **400** | Bad Request | El body o los parámetros tienen errores |
| **401** | Unauthorized | Falta el token de autorización o es inválido |
| **403** | Forbidden | Autenticado pero sin permiso |
| **404** | Not Found | El endpoint o recurso no existe |
| **500** | Internal Server Error | Error en el servidor del sistema externo |

**En la práctica:** Si el agente llama a una herramienta y recibe un 401, el token de autorización configurado en la intención es incorrecto. Si recibe un 500, hay un problema en el sistema externo, no en el agente.

---

## 🌐 HTTPS (HTTP Secure)

**Definición:** Versión cifrada de HTTP que usa TLS (Transport Layer Security) para encriptar la comunicación entre cliente y servidor, protegiendo los datos en tránsito.

**En la plataforma:** Todos los endpoints de Induxsoft usan HTTPS. Los sistemas externos que el agente integre también deben usar HTTPS. Un endpoint HTTP sin cifrar no debería usarse para transmitir tokens o datos sensibles.

---

## 🌐 Payload / Cuerpo de la solicitud (Body)

**Definición:** Datos enviados en el cuerpo de una solicitud HTTP (normalmente POST, PUT o PATCH). En las APIs modernas, el payload casi siempre está en formato JSON.

**En la plataforma:** El agente envía el payload del protocolo de integración como cuerpo JSON de sus solicitudes POST a herramientas externas. Los sistemas externos que devuelven información también lo hacen en el cuerpo de la respuesta.

---

## 🌐 URL (Uniform Resource Locator)

**Definición:** Dirección única que identifica un recurso en la red. Compuesta por protocolo, dominio, ruta y opcionalmente parámetros de consulta.

**Anatomía de una URL:**
```
https://agent.induxsoft.net/svc/agt_001/conversations/?last=10&channel=whatsapp
│────┘  │───────────────────┘ │────────────────────────┘ │────────────────────┘
Protocolo     Dominio               Ruta (Path)           Parámetros de consulta
```

**Parámetros de consulta (query string):** pares `clave=valor` separados por `&` que van después del `?`. En la plataforma se usan para filtros, paginación y para pasar contexto al agente (`?topic=`, `?user_sid=`, `?var_context_id=`).

---

---

# SECCIÓN E · JSON

---

## 🌐 JSON (JavaScript Object Notation)

**Definición:** Formato ligero de intercambio de datos basado en texto, legible por humanos y fácilmente procesable por máquinas. Es el estándar de facto para el cuerpo de solicitudes y respuestas en Web APIs modernas.

**Características:**
- Independiente del lenguaje de programación.
- Basado en dos estructuras: objetos y arreglos.
- Usa codificación UTF-8.

**Ejemplo completo:**
```json
{
  "agente": "Sofía",
  "activo": true,
  "creditos": 850000,
  "canales": ["whatsapp", "chat_web", "widget"],
  "configuracion": {
    "modelo": "gpt-5",
    "creatividad": 0.3,
    "duracion_minutos": 30
  }
}
```

---

## 🌐 Objeto JSON

**Definición:** Colección de pares clave/valor delimitada por llaves `{}`. Las claves son siempre cadenas entre comillas dobles. Los valores pueden ser cualquier tipo JSON válido.

**Sintaxis:**
```json
{
  "clave": "valor_cadena",
  "numero": 42,
  "decimal": 3.14,
  "booleano": true,
  "nulo": null
}
```

**En la plataforma:** El payload del protocolo de integración es un objeto JSON. El campo `data` dentro de ese payload también es un objeto JSON con los datos recopilados por el agente.

---

## 🌐 Arreglo JSON (Array)

**Definición:** Lista ordenada de valores delimitada por corchetes `[]`. Los elementos pueden ser de cualquier tipo JSON (incluyendo objetos u otros arreglos) y pueden mezclarse.

**Sintaxis:**
```json
["whatsapp", "chat_web", "widget"]

[
  {"id": "01", "nombre": "Sofía"},
  {"id": "02", "nombre": "Max"}
]
```

**En la plataforma:** El diseño de prompt es un arreglo JSON de objetos. La respuesta de listado de conversaciones y mensajes también es un arreglo de objetos.

---

## 🌐 Tipos de datos JSON

**Definición:** JSON soporta exactamente seis tipos de valor:

| Tipo | Descripción | Ejemplo |
|---|---|---|
| **String** | Cadena de texto entre comillas dobles | `"Hola mundo"` |
| **Number** | Número entero o decimal, sin comillas | `42`, `3.14`, `-7` |
| **Boolean** | Verdadero o falso, sin comillas | `true`, `false` |
| **Null** | Ausencia de valor | `null` |
| **Object** | Colección de pares clave/valor | `{"a": 1}` |
| **Array** | Lista ordenada de valores | `[1, 2, 3]` |

**Error común:** Enviar un número como string (`"42"` en lugar de `42`) o un booleano como string (`"true"` en lugar de `true`) puede causar errores en el sistema receptor.

---

## 🌐 JSON anidado (Nested JSON)

**Definición:** Objeto o arreglo JSON que contiene a su vez otros objetos o arreglos como valores, creando estructuras jerárquicas de datos.

**En la plataforma:** El payload del protocolo de integración usa JSON anidado:
```json
{
  "intention": "registrar-pedido",
  "agent_name": "Sofía",
  "data": {
    "producto": "Silla ergonómica",
    "cantidad": 2,
    "direccion": {
      "calle": "Av. Principal 123",
      "ciudad": "Guadalajara"
    }
  },
  "params": {
    "sucursal": "norte",
    "utm_source": "google"
  }
}
```

Para acceder al valor de `ciudad` desde código: `payload.data.direccion.ciudad`

---

## 🌐 Serialización / Deserialización

**Definición:**
- **Serialización:** convertir una estructura de datos en memoria (objeto, diccionario, etc.) a texto JSON para transmitirlo.
- **Deserialización:** convertir texto JSON recibido de vuelta a una estructura de datos en memoria para procesarlo.

**En la práctica:** Cuando el agente envía una solicitud a una herramienta, serializa el payload a JSON. Cuando el sistema externo recibe la solicitud, deserializa el JSON para procesar los datos. La respuesta sigue el proceso inverso.

---

## 🌐 JSON válido vs. JSON inválido

**Definición:** El JSON tiene reglas estrictas de sintaxis. Un JSON inválido provoca errores al parsear y rompe la comunicación entre sistemas.

**Errores comunes:**

```json
// ❌ Coma al final del último elemento
{"nombre": "Sofía", "activo": true,}

// ❌ Comillas simples en lugar de dobles
{'nombre': 'Sofía'}

// ❌ Clave sin comillas
{nombre: "Sofía"}

// ❌ Comentarios (JSON no soporta comentarios)
{"nombre": "Sofía" // este es el nombre}
```

```json
// ✅ JSON válido
{
  "nombre": "Sofía",
  "activo": true,
  "canales": ["whatsapp", "web"]
}
```

**En la práctica:** Si un endpoint externo responde con JSON inválido, el agente puede no procesar correctamente la respuesta. Siempre valida que tus endpoints devuelvan JSON bien formado.

---

## 🌐 Content-Type: application/json

**Definición:** Encabezado HTTP que indica al servidor receptor que el cuerpo de la solicitud está en formato JSON y debe interpretarse como tal.

**En la plataforma:** Todas las solicitudes POST de la plataforma incluyen este encabezado. Los endpoints externos que el agente llame deben esperar este tipo de contenido.

```
Content-Type: application/json; charset=utf-8
```

---

---

# Índice rápido de términos

| Término | Sección |
|---|---|
| Agente IAE | A |
| Alojamiento vectorial | A |
| Amplitud de memoria | A |
| API | C |
| API Key / Token | C |
| Araña / Crawler | A |
| Arreglo JSON | E |
| Auditoría de conversaciones | A |
| Alucinación | B |
| Autenticación / Autorización | C |
| Base64 | C |
| Códigos de estado HTTP | D |
| Comportamiento adaptativo | A |
| Conector | A |
| Constante (prompt) | A |
| Consumo adicional | A |
| Consumo basal | A |
| Content-Type | E |
| Contexto variable | A |
| Control humano (Handoff) | A |
| Creador | A |
| Crédito IA | A |
| Cuenta Maestra | A |
| CRUD | C |
| Detección de intención | A |
| Disparadores | A |
| Duplicar agente | A |
| Embedding / Incrustación | B |
| Encabezados HTTP | D |
| Endpoint | C |
| Fine-tuning | B |
| HTTP / HTTPS | D |
| IA de segundo paso | B |
| Identificación del usuario | A |
| Indicaciones por canal | A |
| Índice semántico / vectorial | A |
| Inferencia | B |
| Intención | A |
| Intervención conjunta | A |
| JSON | E |
| JSON anidado | E |
| JSON válido | E |
| Libreta de órdenes | A |
| Licencia de Creador | A |
| LLM | B |
| Memoria conversacional | A |
| Memoria de trabajo | A |
| Mensajes predeterminados | A |
| Métodos HTTP | D |
| Motor de resultados semánticos | A |
| NIA | A |
| NIC | A |
| Objeto JSON | E |
| Paginación | C |
| Parámetros (agente) | A |
| Payload / Body | D |
| Perfil del agente | A |
| Plan Estándar | A |
| Plantilla de respuesta | A |
| Preámbulo | A |
| Prompt | B |
| Protocolo de integración | A |
| Punto final (Endpoint) | A |
| RAG | B |
| Recarga automática | A |
| Repositorio de contenido | A |
| REST | C |
| Saldo global del plan | A |
| Serialización / Deserialización | E |
| Servicio web del agente | A |
| Small Business Portal | A |
| Solicitud / Respuesta HTTP | D |
| Susurro (Whisper) | A |
| Temperatura / Creatividad | B |
| Temas de conversación | A |
| Tipos de datos JSON | E |
| Token | B |
| URL | D |
| Vector | B |
| Vectorizador | A |
| Webhook | C |
| Zona de peligro | A |

---

*Induxsoft · Inteligencia Artificial Empresarial · [docs.induxsoft.net](https://docs.induxsoft.net)*