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

# Guía de configuración del agente de IA

> De una clave de licencia a un agente de IA que responde a tus tickets de Discord.

La configuración lleva unos 15 minutos. Necesitas cuatro cosas:

* Una **clave de licencia** de EchoAuth AI Agent. [Cómprala en la tienda](https://shop.echoauth.dev/product/echos-ai-agent-hosted) si todavía no tienes una.
* Un **servidor de Discord** donde puedas añadir bots y gestionar roles.
* Una **clave de API de [OpenRouter](https://openrouter.ai)**. Una sola clave de OpenRouter cubre todo lo que el agente necesita: respuestas, capturas de pantalla y búsqueda.
* Opcionalmente, un **sitio de documentación** o documentación escrita a partir de la cual el agente pueda responder.

Nosotros alojamos tu agente y lo mantenemos en marcha. Lo configuras desde el panel en [agent.echoauth.dev](https://agent.echoauth.dev).

> [!NOTE]
>
> **Configuración recomendada.** Las pruebas a largo plazo se hicieron solo con OpenRouter, usando estos tres modelos:
>
> | Función | Modelo |
> | - | - |
> | Chat / Agent | `deepseek/deepseek-v4-flash-0731` |
> | Embedding | `qwen/qwen3-embedding-8b` |
> | Vision (detección de imágenes) | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> En el panel hay otros proveedores disponibles (NVIDIA, OpenAI, Anthropic), pero esta es la combinación que hemos probado a lo largo del tiempo.

## 1. Crear tu cuenta

**1. Abrir la página de registro**

Ve a [agent.echoauth.dev/register](https://agent.echoauth.dev/register).

**2. Introducir tu clave de licencia**

Pega la clave del correo de tu compra. Tiene este aspecto: `ECHO-XXXX-XXXX-XXXX-XXXX`.

**3. Elegir un nombre de usuario y una contraseña**

Tu contraseña necesita al menos 8 caracteres. Haz clic en **Create account**.

![Formulario de registro con los campos de clave de licencia, nombre de usuario y contraseña](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

La página de registro

Cuando tu licencia está activa, se crea tu agente por ti. Llegas al panel, donde ves el agente, tu licencia y las estadísticas de uso.

![Panel que muestra un agente, el estado de la licencia y el uso](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

El panel después de iniciar sesión

> [!NOTE]
>
> Si aparece **No agents yet**, abre **License** en la barra lateral y comprueba que tu licencia esté activa.

Haz clic en tu agente para abrir su página. Todo lo demás de esta guía parte de aquí: **Configure** abre los ajustes, **Live logs** muestra lo que está haciendo el agente y **Update Agent** aplica los ajustes que requieren un nuevo despliegue.

![Página del agente con Configure, Live logs, Restart y Update Agent](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/03-agent.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=6c4ca792bd16efd8e9e175519f337123)

La página del agente

## 2. Crear tu bot de Discord

Tu agente responde a través de un bot de Discord que te pertenece. Créalo en el Discord Developer Portal.

**1. Crear una aplicación**

Abre el [Discord Developer Portal](https://discord.com/developers/applications) y haz clic en **New Application**. Ponle el nombre de tu agente de soporte, por ejemplo "Acme Support".

**2. Activar el intent Message Content**

Ve a **Bot**. En **Privileged Gateway Intents**, activa **Message Content Intent** y guarda.

> [!WARNING]
>
> Sin este intent, el bot recibe mensajes vacíos y nunca responde.

**3. Copiar el token del bot**

Todavía en **Bot**, haz clic en **Reset Token** y copia el token. Lo pegarás en el panel en la siguiente sección. Manténlo en privado: cualquiera que tenga el token puede controlar tu bot.

**4. Invitar al bot a tu servidor**

Ve a **OAuth2** → **URL Generator**. Marca los scopes `bot` y `applications.commands`, y luego estos permisos del bot:

* View Channels
* Send Messages
* Read Message History
* Embed Links
* Attach Files

Abre la URL generada y añade el bot a tu servidor.

**5. Dar al bot acceso a tu categoría de tickets**

Asegúrate de que el rol del bot pueda ver la categoría donde se crean tus canales de tickets. Si no puede ver el canal, no puede responder.

## 3. Añadir tus claves

Crea una clave de API en [openrouter.ai/keys](https://openrouter.ai/keys) y añade saldo a tu cuenta de OpenRouter. El modelo de visión es gratuito, pero los modelos de chat y de embedding se pagan por uso.

Después, en la página de tu agente, haz clic en **Configure** y abre la pestaña **API Keys**.

![Pestaña API Keys que muestra la clave de API de OpenRouter y el token del bot de Discord marcados como configured](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

La pestaña API Keys, con la clave de OpenRouter y el token del bot de Discord configurados

1. Pega tu clave en **OpenRouter API Key**.
2. Pega tu **Discord Bot Token**.
3. Haz clic en **Save**.

Puedes dejar vacíos los campos de OpenAI, Anthropic y NVIDIA. Las claves se almacenan cifradas y no se vuelven a mostrar después de guardarlas. Una insignia **configured** confirma que hay una clave definida.

## 4. Elegir tus modelos de IA

Abre la pestaña **AI Settings**. El agente usa tres modelos. Pon los tres en **OpenRouter** y elige los modelos recomendados:

| Ajuste | Qué hace | Proveedor | Modelo |
| - | - | - | - |
| **Chat / Agent Model** | Redacta las respuestas y decide qué consultar en tu documentación. | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | Lee las capturas de pantalla que los clientes adjuntan a los tickets. | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | Indexa tu documentación y la consulta. | OpenRouter | `qwen/qwen3-embedding-8b` |

![Pestaña AI Settings con OpenRouter seleccionado para los modelos de chat, visión y embedding](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

La pestaña AI Settings con los modelos recomendados de OpenRouter

> [!NOTE]
>
> Bajo el modelo de embedding, el panel avisa de que supera las 2000 dimensiones. Es lo esperado para `qwen/qwen3-embedding-8b`. La búsqueda sigue funcionando: revisa cada pasaje en lugar de usar un índice, algo que sigue siendo rápido para una base de conocimiento de unos miles de pasajes.

Después escribe tu **Base Prompt**. Son las instrucciones permanentes del agente: para quién trabaja, el tono que debe usar y lo que nunca debe hacer. Por ejemplo:

```text theme={null}
You are the support agent for Acme Store. Be friendly and concise.
Answer only from the documentation. If you are not sure, ask a staff member to step in.
```

> [!WARNING]
>
> Elige tu modelo de embedding antes de indexar nada. Cambiarlo más tarde deja inservible el índice existente hasta que lo reconstruyas.

## 5. Conectarlo a tus tickets

Abre la pestaña **Discord**. Estos ajustes le dicen al agente dónde responder y quién cuenta como staff.

![Pestaña Discord con roles owner, roles staff, IDs de categorías de tickets, IDs de bots de tickets y modelos de imagen](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

La pestaña Discord

Para copiar IDs, activa **Developer Mode** en Discord en **User Settings** → **Advanced**. Después haz clic derecho en un rol, una categoría o un usuario y elige **Copy ID**.

> [accordion] Owner Role IDs
>
> Roles que pueden usar todos los comandos slash, incluidos `/pause_bot` y `/edit_base`. Separa varios IDs con comas.

> [accordion] Staff Role IDs
>
> Los roles de tu equipo de soporte. Cuando un miembro del staff escribe en un ticket, el agente se retira y permanece en silencio en ese ticket. Para que vuelva, menciona al bot en el ticket o usa `/restart` allí.

> [accordion] Ticket Category IDs
>
> Las categorías donde se crean tus canales de tickets. El agente solo responde dentro de estas categorías.

> [accordion] Ticket Bot IDs
>
> El ID de usuario de tu bot de tickets, como Ticket Tool o SellAuth Tickets. El agente ignora a los demás bots, así que añade aquí el tuyo para que el agente pueda leer el mensaje inicial del ticket.

> [accordion] Image Models
>
> Modelos de visión de respaldo, uno por línea, que se prueban en orden si falla el modelo de visión de AI Settings. Pon estos respaldos:\
> `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free`\
> `google/gemma-4-31b-it:free`\
> `google/gemma-4-26b-a4b-it:free`\
> `thinkingmachines/inkling-small:free`\
> `dots-studio/dots-3-note-preview:free`

Haz clic en **Save**.

## 6. Darle tu documentación al agente

Abre la pestaña **Knowledge Base**. El agente responde a partir de dos fuentes y puedes usar una o ambas.

![Pestaña Knowledge Base con el botón Index documentation, la Docs URL y la base de conocimiento interna](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

La pestaña Knowledge Base

> [tab] Docs site
>
> Usa esto si tu documentación está publicada en Mintlify.
>
> 1. Introduce tu **Docs URL**, por ejemplo `https://docs.acme-store.com`, sin barra final. El sitio debe servir `/llms.txt`, algo que Mintlify hace automáticamente.
> 2. Haz clic en **Save**, luego ve a la página de tu agente y haz clic en **Update Agent**.
> 3. De vuelta en esta pestaña, haz clic en **Index documentation**. Unos cientos de páginas tardan un par de minutos, y puedes salir de la página mientras se ejecuta.
>
> Con **Sync Mode** en **Poll llms.txt hourly**, el agente revisa tu documentación cada hora y reindexa solo las páginas que han cambiado.

> [tab] Internal knowledge base
>
> Usa esto para todo lo que no esté en un sitio de documentación: preguntas frecuentes, políticas, códigos de error.
>
> 1. Desplázate hasta **Internal Knowledge Base**.
> 2. Pega tu texto o haz clic en **Load file** y elige un archivo `.txt` o `.md`.
> 3. Haz clic en **Save**.
>
> El agente lo indexa en aproximadamente un minuto. El texto plano sirve: los encabezados en MAYÚSCULAS o entre líneas de `=====` se convierten en secciones con búsqueda.

Deja activados **Documentation Retrieval** y **Agentic Retrieval**. Con la recuperación activada, el agente consulta solo los pasajes relevantes para cada pregunta en lugar de leerlo todo cada vez.

## 7. Definir los tiempos de respuesta y la escalada

Abre la pestaña **Behavior**.

![Pestaña Behavior con los tiempos de respuesta y las palabras clave de ayuda humana](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

La pestaña Behavior

El agente espera a que el cliente deje de escribir y entonces responde a todo en una sola respuesta. Cada mensaje nuevo reinicia el temporizador.

| Ajuste | Por defecto | Significado |
| - | - | - |
| After ticket opens | 45 s | Espera tras el primer mensaje, ya que los clientes suelen añadir detalles o capturas de pantalla. |
| After each message | 30 s | Tiempo de silencio necesario tras los mensajes siguientes antes de responder. |
| Maximum wait | 180 s | Responde pasado este tiempo aunque el cliente siga escribiendo. |

En **Human Help Keywords**, enumera las palabras que deben pasar el ticket a tu equipo, una por línea. Por ejemplo `refund`, `chargeback` o `real person`.

## 8. Recibir alertas (opcional)

Abre la pestaña **Notifications** y pega el ID de un canal privado del staff. El agente publica allí cuando tu licencia está a punto de caducar y cuando un proveedor de IA rechaza tu clave o se queda sin cuota.

![Pestaña Notifications con el ID del canal de notificaciones](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

La pestaña Notifications

## 9. Iniciar el agente

Vuelve a la página de tu agente y haz clic en **Update Agent**. Esto vuelve a desplegar el agente con tu token de bot, tu URL de documentación y tu modelo de embedding. La salida aparece debajo del botón mientras se ejecuta.

> [!NOTE]
>
> La mayoría de los ajustes llegan al agente en ejecución en aproximadamente un minuto, sin necesidad de un nuevo despliegue. Solo necesitas **Update Agent** después de cambiar el **Discord Bot Token**, la **Docs URL**, el **Embedding Model** o el **Sync Mode**.

Para comprobar que todo funciona:

1. Abre un ticket de prueba en tu servidor y haz una pregunta que tu documentación responda.
2. Abre **Live logs** en la página de tu agente y observa cómo el agente recibe el mensaje, busca en tu documentación y responde.

![Live logs que muestran al agente arrancar, sincronizarse, buscar en la documentación y responder en un ticket](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

Live logs

La insignia de estado de tu agente indica **Online** cuando está en marcha.

## Comandos slash

Una vez que el agente está en tu servidor, los owners y el staff pueden controlarlo desde Discord.

| Comando | Quién | Qué hace |
| - | - | - |
| `/stop` | Owner, staff | Impide que el agente responda en este canal. |
| `/restart` | Owner, staff | Permite que el agente vuelva a responder en este canal. |
| `/mute_existing` | Owner, staff | Detiene al agente en todos los tickets que ya están abiertos. |
| `/pause_bot` | Owner | Pausa al agente en todas partes. |
| `/resume_bot` | Owner | Reanuda al agente en todas partes. |
| `/edit_base` | Owner | Edita el base prompt. |
| `/chat_model` | Owner | Cambia el modelo de chat. |

También puedes pausar al agente desde el panel con **Global Bot Pause** en la pestaña **Discord**.

## Mantener tu licencia activa

Tu agente sigue en línea mientras tu licencia esté activa. La página **License** muestra los días restantes y tu fecha de caducidad.

![Página License con el estado, los días restantes y los planes disponibles](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

La página License

Para renovar, compra una clave nueva en la [tienda](https://shop.echoauth.dev/product/echos-ai-agent-hosted), haz clic en **Renew license** y pega la clave. El tiempo se suma a tu licencia actual.

## Solución de problemas

> [accordion] El bot está conectado pero nunca responde
>
> * Comprueba que **Message Content Intent** esté activado en el Discord Developer Portal.
> * Comprueba que el ID de categoría del ticket esté en **Ticket Category IDs**.
> * Comprueba que el bot pueda ver y enviar mensajes en esa categoría.
> * Comprueba que un miembro del staff no haya escrito ya en el ticket. Menciona al bot o usa `/restart` para que vuelva.
> * Comprueba que **Global Bot Pause** esté desactivado.

> [accordion] El bot ignora el mensaje inicial del ticket
>
> Añade el ID de usuario de tu bot de tickets en **Ticket Bot IDs** en la pestaña **Discord**.

> [accordion] El agente no usa mi documentación
>
> Abre la pestaña **Knowledge Base**. Si dice **Documentation is not indexed yet**, haz clic en **Index documentation**. Si dice **The index does not match the embedding model**, haz clic en **Clear and rebuild the index**, o vuelve a poner el modelo de embedding que se muestra y guarda.

> [accordion] Las respuestas o la indexación fallan con un error de OpenRouter
>
> Comprueba que tu cuenta de OpenRouter tenga saldo y que la clave de la pestaña **API Keys** siga siendo válida. Los modelos gratuitos, como el de visión, pueden tener límites de uso en horas punta; el agente recurre entonces al siguiente modelo de **Image Models**.

> [accordion] El agente dejó de responder
>
> Abre **Live logs** y busca errores, por ejemplo una clave no válida o saldo agotado. Después haz clic en **Restart** en la página del agente. Si eso no ayuda, haz clic en **Update Agent**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.