Saltar al contenido principal
La configuración lleva unos 15 minutos. Necesitas cuatro cosas:
  • Una clave de licencia de EchoAuth AI Agent. Cómprala en la tienda si todavía no tienes una.
  • Un servidor de Discord donde puedas añadir bots y gestionar roles.
  • Una clave de API de OpenRouter. 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.
Configuración recomendada. Las pruebas a largo plazo se hicieron solo con OpenRouter, usando estos tres modelos: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

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

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

El panel después de iniciar sesión

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

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 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.
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 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

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:
Pestaña AI Settings con OpenRouter seleccionado para los modelos de chat, visión y embedding

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

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:
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

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.
Roles que pueden usar todos los comandos slash, incluidos /pause_bot y /edit_base. Separa varios IDs con comas.
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í.
Las categorías donde se crean tus canales de tickets. El agente solo responde dentro de estas categorías.
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.
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

La pestaña Knowledge Base

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.
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

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. 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

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.
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

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. 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

La página License

Para renovar, compra una clave nueva en la tienda, haz clic en Renew license y pega la clave. El tiempo se suma a tu licencia actual.

Solución de problemas

  • 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.
Añade el ID de usuario de tu bot de tickets en Ticket Bot IDs en la pestaña Discord.
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.
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.
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.