# Crear y publicar tu agente en Instfy Agent

<p class="lead">Paso a paso para crear un agente en el Studio, agregar conocimiento, personalizarlo, instalarlo en tu sitio, probarlo y seguir las conversaciones y los leads.</p>

Esta guía te lleva desde el primer inicio de sesión hasta tener el agente funcionando en tu sitio. Sigue las tareas en orden: un agente con una buena base de conocimiento responde mejor desde el primer día.

!image[Studio de Instfy Agent con las pestañas Builder, Conocimiento, Análisis, Conversaciones, CRM e Instalar]

## Antes de empezar

- **Acceso al Studio:** el equipo de Instfy habilita el acceso. No existe registro abierto. Si todavía no tienes usuario, escribe a relationship@instfy.com.
- **Contenido de la empresa:** reúne la dirección del sitio, las páginas principales (productos, servicios, precios publicados, políticas) y las preguntas que más hacen los clientes.
- **Acceso al sitio:** tendrás que pegar un fragmento de código en el sitio o pedírselo a quien lo administra.
- **WhatsApp comercial (opcional):** el número al que el agente puede dirigir al visitante.

## Entrar al Studio

**Ruta:** `ai.instfy.com/studio/login`

<ol class="steps">
<li>Abre la pantalla <strong>Entrar al panel</strong>.</li>
<li>Completa el <strong>Email</strong> y la <strong>Contraseña</strong> que recibiste del equipo de Instfy.</li>
<li>Haz clic en <strong>Entrar</strong>. El Studio se abre en el <strong>Dashboard</strong>.</li>
</ol>

:::tip
Cambia la contraseña provisional en el primer acceso y no compartas tu usuario. Para dar acceso a otra persona, agrega un miembro en *Configuración > Equipo*.
:::

## Crear el agente

**Ruta en el menú:** *Agentes > + Nuevo agente*

<ol class="steps">
<li>En el menú lateral, haz clic en <strong>Agentes</strong>.</li>
<li>Haz clic en <strong>+ Nuevo agente</strong>.</li>
<li>En el campo <strong>Nombre del agente</strong>, escribe el nombre que verá el visitante.</li>
<li>Haz clic en <strong>Crear y abrir</strong>. El sistema crea la dirección del agente a partir del nombre y abre la pestaña <strong>Builder</strong>.</li>
</ol>

## Agregar conocimiento

El conocimiento es lo que el agente usa para responder. Empieza por el sitio y complétalo con textos.

**Ruta en el menú:** *Agentes > (tu agente) > Conocimiento*

<ol class="steps">
<li>Abre la pestaña <strong>Conocimiento</strong> y ve a <strong>Agregar conocimiento</strong>.</li>
<li>En la opción <strong>Sitio</strong>, indica la dirección principal, ajusta el <strong>Máximo de páginas</strong> (hasta 120) y haz clic en <strong>Rastrear sitio</strong>.</li>
<li>Usa <strong>Página</strong> y <strong>Buscar e indexar</strong> para incluir una URL importante que no entró en el rastreo.</li>
<li>Usa <strong>Archivo</strong> y <strong>Subir e indexar</strong> para TXT, MD, CSV, TSV, JSON, HTML o XML de hasta 5 MB.</li>
<li>Usa <strong>Texto</strong>, elige el tipo Texto o Preguntas frecuentes y haz clic en <strong>Indexar texto</strong> para respuestas que no están en el sitio.</li>
<li>Verifica en <strong>Conocimiento indexado</strong> que cada fuente llegó al estado indexado.</li>
</ol>

:::note
La carga de PDF y DOCX estará disponible **Próximamente**. Mientras tanto, conviértelos a TXT o pega el contenido como Texto.
:::

## Personalizar en el Builder

**Ruta en el menú:** *Agentes > (tu agente) > Builder*

<ol class="steps">
<li>Completa <strong>Nombre</strong> y <strong>Descripción</strong> y deja el <strong>Estado</strong> como Activo.</li>
<li>Escribe el <strong>Mensaje inicial</strong> y el <strong>Placeholder del input</strong> (el texto de ejemplo en el cuadro de escritura).</li>
<li>Define el <strong>Tono de voz</strong> y el <strong>Idioma</strong>.</li>
<li>Indica el <strong>WhatsApp</strong> solo con números, si quieres que el agente dirija al visitante a ese número.</li>
<li>Elige el <strong>Color principal</strong>, el <strong>Tema</strong>, la <strong>Posición del widget</strong>, los colores de la barra y el avatar.</li>
<li>En <strong>Preguntas sugeridas</strong>, escribe una pregunta por línea.</li>
<li>En <strong>Compartir (WhatsApp y redes sociales)</strong>, define el título, la descripción y la imagen del enlace público. El Studio puede sugerir el título y la descripción a partir del conocimiento.</li>
<li>Los cambios se guardan automáticamente. Usa <strong>Guardar ahora</strong> si quieres asegurarte.</li>
</ol>

## Probar antes de publicar

<ol class="steps">
<li>Haz clic en <strong>Ver página pública</strong> en la parte superior del agente.</li>
<li>Haz las preguntas que más hacen tus clientes y verifica las fuentes que se muestran.</li>
<li>Pregunta algo que no está en la base y confirma que el agente avisa que no tiene la información.</li>
<li>Completa la base con Texto o Preguntas frecuentes para lo que faltó y vuelve a probar.</li>
</ol>

## Instalar en el sitio

**Ruta en el menú:** *Agentes > (tu agente) > Instalar*

<ol class="steps">
<li>Abre la pestaña <strong>Instalar</strong>.</li>
<li>Elige el método: <strong>Script (HTML)</strong>, <strong>Google Tag Manager</strong>, <strong>WordPress</strong>, <strong>Shopify</strong>, <strong>React/Next</strong>, <strong>Página/iframe</strong> o <strong>API (cURL)</strong>.</li>
<li>Copia el fragmento que se muestra. En el método Script, es una sola etiqueta <code>&lt;script&gt;</code> que carga el widget e identifica a tu agente.</li>
<li>Pega el fragmento en el sitio, antes del cierre de la etiqueta <code>&lt;/body&gt;</code> o en el lugar indicado para el método elegido.</li>
<li>Usa la <strong>Vista previa en vivo</strong> para verificar la apariencia.</li>
<li>Abre tu sitio y confirma que el widget aparece en la posición elegida.</li>
</ol>

También puedes difundir el **enlace de la página pública** en la bio, en WhatsApp o en un código QR, sin modificar el sitio.

## Seguir las conversaciones y los leads

- **Conversaciones:** lee cada atención y consulta el canal de origen (Widget, Página pública, Prueba, Voz, punto de venta y otros).
- **Análisis:** sigue el volumen, las brechas de conocimiento y los temas más consultados.
- **CRM:** registra los contactos con intención de compra y mueve las tarjetas por el embudo.

Consulta la rutina completa en [Agentes de gestión y automatización](#/ai-agents).

## Preguntas frecuentes

### ¿Cómo obtengo acceso al Studio de Instfy Agent?

El equipo de Instfy habilita el acceso. Escribe a relationship@instfy.com para solicitar tu usuario. No existe registro abierto en el Studio.

### ¿Cuántas páginas del sitio puede leer el agente?

El rastreo del sitio lee hasta 120 páginas por fuente, con un valor predeterminado de 30. Puedes agregar otras páginas de forma individual con la opción Página.

### ¿El widget afecta el diseño del sitio?

No. El widget se carga con un único script y funciona aislado del resto de la página, con estilos propios, sin alterar el diseño del sitio.

### ¿Tengo que volver a publicar el código cuando cambio el color o el mensaje?

No. Los cambios hechos en el Builder se aplican al widget ya instalado, sin cambiar el código en el sitio.

### ¿Cómo actualizo el agente cuando cambia el sitio?

En la pestaña Conocimiento, haz clic en Actualizar en la fuente de URL que cambió. El contenido se vuelve a obtener y se reindexa.

## Próximos pasos

Con el agente publicado, organiza la rutina de gestión.

:::related
ai-agents, instfy-ai, contact-support
:::