Cómo configurar el asistente de IA

Conecta Agon al proveedor de IA que prefieras y empezarán a funcionar el Asistente de soporte de IA, el Modo Acciones de IA y las respuestas de asesoría de negocio. La forma más rápida es una clave API gratuita de Google Gemini, y se tarda unos 3 minutos.

Cómo funciona el asistente de IA en Agon

Agon funciona en tu propio ordenador, y la configuración de su asistente de IA también. El asistente usa una clave de proveedor de IA que pertenece a tu estudio: creas la clave con el proveedor, la pegas en Agon y Agon se comunica directamente con ese proveedor. Agon no gestiona ningún servicio de IA propio, y Agon no incluye ningún servicio de IA.

Tienes tres opciones:

Opción	Qué necesitas	Ideal para
Google Gemini (recomendado para empezar)	Una cuenta de Google	Empezar en pocos minutos
Groq	Una cuenta de Groq	Un proveedor alternativo con respuestas rápidas
Un modelo local con Ollama	Un ordenador razonablemente potente	Mantener todos los prompts en tu propia máquina

Si no configuras nada, el asistente sigue funcionando en modo básico (ver más abajo).

¿Qué es el modo básico?

Sin un proveedor de IA, el panel del asistente se convierte en una búsqueda en la documentación. Escribes unas palabras clave y Agon muestra los artículos de ayuda que mejor coinciden, directamente de esta documentación. El modo básico:

• funciona íntegramente en tu ordenador, sin conexión a internet y sin IA;
• no puede responder preguntas abiertas, realizar acciones de IA ni dar consejos de negocio;
• muestra un botón Configurar la IA en Configuración que te trae de vuelta a esta configuración.

Configuración → Asistente IA muestra No configurado · modo básico mientras no haya ningún proveedor conectado.

Antes de empezar

• Solo la cuenta de studio manager puede configurar el asistente de IA.
• Lee Privacidad: adónde van tus prompts más abajo, sobre todo si piensas mencionar datos de clientes en el chat.
• Trata una clave API como una contraseña. Cualquiera que la tenga puede usar tu cuenta del proveedor.

Crea una clave API de Gemini en 3 minutos

1. Abre la página de claves API de Google AI Studio en tu navegador e inicia sesión con tu cuenta de Google.
2. Haz clic en Create API key (Google puede llamarlo Get API key; con la interfaz en español, el nombre aparece traducido). Si Google te pide elegir o crear un proyecto, acepta el predeterminado.
3. Haz clic en el icono de copiar junto a tu nueva clave. Es una cadena larga de letras y números.
4. En Agon, abre Configuración → Asistente IA. [SCREENSHOT: Configuración → Asistente IA con la lista de proveedores y el campo Clave API]
5. En Proveedor de IA, elige Google Gemini.
6. Pega la clave en el campo Clave API y haz clic en Verificar y guardar.
7. Agon prueba la clave con Google al instante. Cuando funciona, ves Clave API guardada y verificada. y una insignia Clave activa · Google Gemini.

Listo: abre el asistente y hazle una pregunta.

Las pantallas de Google cambian de vez en cuando. Si un botón tiene otro nombre, busca "API keys" en el menú de Google AI Studio. El enlace Obtener una clave API de Google Gemini junto a la lista de proveedores en Agon siempre abre la página correcta.

Usar Groq en su lugar

1. Abre la página de claves API de la consola de Groq e inicia sesión o crea una cuenta.
2. Haz clic en Create API Key, ponle un nombre (por ejemplo "Agon") y copia la clave. Groq solo la muestra una vez.
3. En Agon, abre Configuración → Asistente IA, elige Groq en Proveedor de IA, pega la clave en Clave API y haz clic en Verificar y guardar.

Una insignia Clave activa · Groq confirma que funciona.

Usar un modelo local con Ollama

Con Ollama el modelo de IA funciona en tu propio ordenador, así que los prompts nunca salen de él. Necesitas un ordenador con memoria suficiente para ejecutar un modelo. Las respuestas suelen ser más lentas que las de un proveedor en la nube, y la calidad de las respuestas depende del modelo que elijas. Es una opción avanzada.

1. Descarga e instala Ollama desde ollama.com y después descarga un modelo, por ejemplo ejecutando ollama pull llama3.1 en un terminal. Ollama tiene que estar en ejecución siempre que uses el asistente.

2. Cierra Agon.

3. Abre la carpeta de datos de Agon:

   • macOS: ~/Library/Application Support/Agon
   • Windows: %APPDATA%\Agon

4. Abre el archivo llamado .env con un editor de texto plano (en macOS está oculto: pulsa Cmd + Shift + . en el Finder para mostrarlo). No cambies ni borres las líneas que ya contiene: guardan las claves secretas que protegen los datos de tu estudio. Añade estas dos líneas al final, con el nombre del modelo que descargaste:

   LLM_PROVIDER=ollama
   LLM_MODEL=ollama_chat/llama3.1

5. Guarda el archivo y vuelve a abrir Agon.

Configuración → Asistente IA muestra ahora Activo · modelo local. Si más adelante guardas una clave de proveedor con Usar en su lugar la clave de tu proveedor, esa clave tiene prioridad sobre el modelo local.

Privacidad: adónde van tus prompts

• Directamente de tu ordenador al proveedor que elegiste. Cuando usas Gemini o Groq, tu pregunta y la información que el asistente necesita para responderla viajan directamente del ordenador en el que funciona Agon a ese proveedor. Nunca pasan por el desarrollador de Agon ni por ningún servidor gestionado para Agon.
• Con Ollama, nada sale de tu ordenador.
• Tu clave se queda en tu ordenador. Agon la guarda cifrada en la base de datos local de tu estudio y no vuelve a mostrarla después de guardarla. Eliminar clave en Configuración → Asistente IA la borra en cualquier momento.
• Los niveles gratuitos pueden usar tus datos. Los niveles gratuitos de algunos proveedores pueden usar los datos que envías para entrenar o mejorar sus modelos. Para preguntas que incluyan datos de tus clientes, usa un nivel de pago o un modelo local. Las condiciones cambian con el tiempo, así que revisa las condiciones actuales y la política de privacidad de tu proveedor antes de empezar: condiciones de la API de Gemini · política de privacidad de Groq.
• Tu estudio tiene el control. Tu estudio tiene el acuerdo con el proveedor, así que según el RGPD ese proveedor es un encargado del tratamiento de tu estudio. La guía del RGPD explica qué significa eso para ti.

Un buen hábito: no pegues datos sensibles de clientes (notas de salud, por ejemplo) en el chat a menos que te sientas cómodo con las condiciones de tu proveedor.

Si prevés un uso intensivo

Cada proveedor limita cuántas peticiones puede hacer una clave por minuto y por día. Los niveles gratuitos tienen límites bajos. Si varias personas usan el asistente a la vez, o usas el Modo Acciones de IA en horas punta, puede que veas un mensaje indicando que tu proveedor de IA está limitando las peticiones.

Para solucionarlo, amplía tus límites con el proveedor:

• Google Gemini: activa la facturación en el proyecto de Google Cloud al que pertenece tu clave. Google AI Studio muestra tu nivel actual y cómo mejorarlo.
• Groq: consulta tus límites y las opciones de mejora en la consola de Groq.

La misma clave sigue funcionando en Agon después de mejorar el nivel. No necesitas una clave nueva y no hay nada que cambiar en Agon. El proveedor te factura directamente lo que supere su nivel gratuito. Un nivel de pago es también la opción recomendada para los datos de clientes (consulta la sección de privacidad más arriba).

¿Y si algo sale mal?

Agon dice que mi clave no es válida Comprueba que copiaste la clave entera sin espacios de más y que el proveedor que elegiste corresponde a la clave: una clave de Groq no funciona como clave de Gemini. Asegúrate de que la clave no se haya borrado en la consola del proveedor. Una clave recién creada puede tardar un minuto en empezar a funcionar, así que espera y haz clic en Verificar y guardar de nuevo.

El asistente dice que mi proveedor de IA está limitando las peticiones Has alcanzado el límite de tu proveedor. Espera un minuto e inténtalo de nuevo, o amplía tus límites (consulta Si prevés un uso intensivo).

El asistente solo muestra artículos de ayuda El asistente está en modo básico porque no hay ningún proveedor conectado. Sigue los pasos anteriores para añadir una clave. Configuración → Asistente IA muestra No configurado · modo básico cuando no hay ningún proveedor activo.

Recibo "Esta acción necesita Agon AI, que está desactivado" en mitad de una acción El Modo Acciones de IA no puede completar una petición sin un proveedor. Añade una clave en Configuración → Asistente IA y vuelve a pedirlo.

Mi clave funcionaba y ahora el asistente falla Puede que la clave se haya borrado, haya caducado o se haya quedado sin cuota en el lado del proveedor. Crea una clave nueva y guárdala con Cambiar en Configuración → Asistente IA.

Quiero cambiar de proveedor o sustituir mi clave En Configuración → Asistente IA, haz clic en Cambiar junto a la insignia Clave activa, elige el proveedor, pega la clave nueva y haz clic en Verificar y guardar.

Quiero dejar de usar mi clave En Configuración → Asistente IA, haz clic en Eliminar clave y confirma. Agon borra la clave de la base de datos de tu estudio y el asistente pasa al modo básico de inmediato, sin reiniciar. Si crees que la clave puede haberse filtrado, bórrala (revócala) también en la consola de tu proveedor (Google AI Studio o la consola de Groq) para que nadie más pueda usarla.

El modelo local no funciona Asegúrate de que Ollama está en ejecución y de que el nombre del modelo en el archivo .env coincide con un modelo que hayas descargado (ollama list los muestra). Reinicia Agon después de cualquier cambio en el archivo .env.

Preguntas frecuentes

¿El asistente de IA cuesta algo? Agon no cobra por él. Tu proveedor puede hacerlo: los niveles gratuitos tienen límites de uso, y lo que los supere te lo factura directamente el proveedor.

¿Puede el desarrollador de Agon ver mis preguntas? No. Los prompts van de tu ordenador directamente al proveedor que elegiste, o se quedan en tu ordenador con Ollama.

¿Qué proveedor debería elegir? Gemini es el más rápido de configurar. Para datos de clientes, un nivel de pago de cualquier proveedor o un modelo local es la opción más segura.

Páginas relacionadas

• Asistente de soporte de IA
• Modo Acciones de IA
• Guía del RGPD para studio managers
• Configuración