> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindosoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear y desplegar un agente de IA

> Cómo crear un agente de IA en Mindo, entrenarlo, asignarle una sesión de WhatsApp y encenderlo para que responda solo los mensajes de tus clientes

Un **agente de IA** es el asistente que responde solo los mensajes que entran por WhatsApp, Instagram o el widget web. Es estrictamente **reactivo**: no inicia conversaciones, contesta dentro de la ventana de WhatsApp. En esta guía vas de cero a un agente vivo respondiendo: lo creás, lo entrenás, le asignás una sesión y lo encendés. Los agentes viven en **Mensajería → Agentes IA** (`/dashboard/ai-agents-management`).

<Note>
  Esta guía es el recorrido completo. Para profundizar en cada etapa, mirá [Entrenar al agente de IA](/guias/entrenar-agente-ia), [Encender y apagar el agente](/guias/encender-apagar-agente), [Modo sugerencia](/guias/modo-sugerencia) y [Conexión de WhatsApp](/guias/conexion-whatsapp).
</Note>

<Warning>
  Para que un agente responda hacen falta **dos cosas juntas**: el agente **encendido** (interruptor **Estado del agente**) **y** al menos una **sesión de WhatsApp asignada y activa**. Un agente encendido pero **Sin conectar** (sin sesión) no responde nada.
</Warning>

## Pasos para desplegar tu agente

<Steps>
  <Step title="Antes de empezar: conectá una sesión de WhatsApp">
    Tu agente responde a través de una **sesión de WhatsApp**. Si todavía no tenés una conectada, seguí la guía de [Conexión de WhatsApp](/guias/conexion-whatsapp) antes de continuar. Podés crear el agente sin sesión, pero no va a poder responder hasta que le asignes una.
  </Step>

  <Step title="Creá el agente">
    En el menú lateral, dirigite a **Agentes IA** (`/dashboard/ai-agents-management`, título "Gestión de Agentes de IA"). Tocá **Crear Nuevo Agente** (o **Crear Mi Primer Agente** si todavía no tenés ninguno) y elegí el tipo:

    * **Ecommerce** (Recomendado): para tiendas. Se crea solo y dispara una **entrevista de onboarding** que autogenera el prompt y las políticas analizando tu web.
    * **Personalizado**: un agente en blanco. Escribís el **Nombre del Agente** (mínimo 3 caracteres) y lo configurás vos desde cero.

    <Note>
      También existen los tipos **ECommerce Custom**, **Flow** e **Importar agente** para casos más avanzados. Para empezar, **Ecommerce** o **Personalizado** cubren la mayoría de los escenarios.
    </Note>
  </Step>

  <Step title="Entrenalo">
    Hay dos vías que conviven:

    1. **Entrevista de onboarding** (tipo Ecommerce): respondés unas preguntas y Mindo **autogenera el prompt** y las políticas analizando tu web.
    2. **Configuración manual** en la página del agente (`/dashboard/ai-agents-management/[id]`), con pestañas:
       * **Prompt**: el System Prompt que define cómo responde.
       * **Conocimiento**: base de conocimiento y políticas (RAG).
       * **Capacidades**: Herramientas, Guardrail, Etapas del Funnel y Seguimientos.
       * **Pruebas**: para probar al agente dentro de la plataforma.

    Para afinar las respuestas con feedback, usá la **Conversación Rápida** (ver [Entrenar al agente de IA](/guias/entrenar-agente-ia)).

    <Note>
      Editar el **Prompt** de forma self-serve **sí** cambia al agente directo. En cambio, el feedback que dejás en la **Conversación Rápida** genera **tickets** que aplica el equipo de Mindo; no modifica el agente al instante.
    </Note>
  </Step>

  <Step title="Asigná una sesión de WhatsApp (desplegar)">
    En la página del agente, buscá el panel **Sesiones:** y tocá **Gestionar Sesiones**. Marcá la o las sesiones que aparecen en **Disponibles:** y tocá **Conectar N** (donde N es la cantidad que marcaste). Vas a ver el mensaje **"Sesiones asignadas correctamente"** y esas sesiones pasan a **Conectadas:**.

    Opcionalmente, asigná una **Audiencia:** (target) para acotar a qué contactos responde el agente. Si la dejás sin asignar, aplica de forma general.

    <Note>
      Cada sesión asignada se puede **activar o desactivar por línea** sin desasignarla. Hay dos niveles de encendido: el **global** del agente y el de **cada sesión**.
    </Note>
  </Step>

  <Step title="Publicá a Producción">
    Si editaste el prompt, guardá los cambios y tocá **Publicar**. Se abre el modal **"¿Publicar a Producción?"**, donde revisás el diff **Desarrollo → Producción** antes de confirmar.

    <Warning>
      El botón **Publicar** se deshabilita si hay **cambios sin guardar** o si el agente está **inactivo**. Guardá primero y encendé el agente para poder publicar.
    </Warning>
  </Step>

  <Step title="Encendé el agente">
    Activá el interruptor **Estado del agente**. El texto pasa a **"El Agente de IA está activo y respondiendo consultas"** y la etiqueta queda en **Activo**. Desde ese momento, con una sesión asignada y activa, el agente responde solo los mensajes entrantes.

    <Note>
      Paso intermedio opcional: activá el **Modo sugerencia** para revisar cada respuesta antes de que se envíe. En lugar de contestar solo, el agente te propone la respuesta para que la apruebes o la descartes. Más info en [Modo sugerencia](/guias/modo-sugerencia) y [Encender y apagar el agente](/guias/encender-apagar-agente).
    </Note>
  </Step>
</Steps>

## ¿Cómo sé que quedó desplegado?

Revisá que se cumplan las dos condiciones juntas:

* El interruptor **Estado del agente** está encendido y la etiqueta muestra **Activo**.
* En el panel **Sesiones:** hay al menos una sesión en **Conectadas:** y activa (no **Sin conectar**).

Si falta cualquiera de las dos, el agente no responde.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="Lo encendí pero no responde">
    Revisá que tengas una **sesión de WhatsApp asignada y activa** en el panel **Sesiones:**. Un agente encendido sin sesión aparece como **Sin conectar** y no contesta nada.
  </Accordion>

  <Accordion title="¿El agente puede escribir primero?">
    No. El agente es **reactivo**: solo responde a mensajes entrantes, dentro de la ventana de conversación de WhatsApp. No inicia conversaciones.
  </Accordion>

  <Accordion title="¿Qué diferencia hay entre editar el Prompt y dejar feedback?">
    Editar el **Prompt** self-serve cambia al agente directo. El feedback de la **Conversación Rápida** genera tickets que aplica el equipo de Mindo, así que no modifica el agente al instante.
  </Accordion>

  <Accordion title="No me deja tocar Publicar">
    El botón **Publicar** se deshabilita si hay **cambios sin guardar** o si el agente está **inactivo**. Guardá los cambios y encendé el agente para habilitarlo.
  </Accordion>

  <Accordion title="¿Para qué sirve la Audiencia?">
    Te permite limitar a qué contactos responde el agente. Es opcional: si la dejás sin asignar, el agente aplica de forma general.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Entrenar al agente de IA" icon="graduation-cap" href="/guias/entrenar-agente-ia">
    Probá y afiná las respuestas de tu agente con la Conversación Rápida.
  </Card>

  <Card title="Encender y apagar el agente" icon="power-off" href="/guias/encender-apagar-agente">
    Activá o desactivá tu agente con un solo interruptor.
  </Card>

  <Card title="Modo sugerencia" icon="lightbulb" href="/guias/modo-sugerencia">
    Revisá cada respuesta antes de que el agente la envíe.
  </Card>

  <Card title="Conexión de WhatsApp" icon="whatsapp" href="/guias/conexion-whatsapp">
    Conectá la sesión de WhatsApp que va a usar tu agente.
  </Card>
</CardGroup>

<CardGroup cols={1}>
  <Card title="Ir a Agentes IA" icon="arrow-up-right-from-square" href="https://app.mindosoftware.com/dashboard/ai-agents-management">
    Creá y desplegá tu agente de IA desde la plataforma de Mindo.
  </Card>
</CardGroup>