Para agentes de IA: guía paso a paso de configuración — /docs/agents.md, índice de documentación — /llms.txt.

Para agentes de IA

Cómo delegar la integración a un agente de IA: prompt listo para cualquier herramienta. A continuación: direcciones legibles por máquina de la documentación y una skill que el agente instala con un solo comando.

Envía este prompt a tu agente de IA. Configurará la herramienta según las instrucciones de abajo y te pedirá la clave.

Conecta tu herramienta a JoinGonka Gateway —la API compatible con OpenAI y Anthropic de la red Gonka— siguiendo las instrucciones de https://gate.joingonka.ai/docs/agents.md. La clave te la daré yo: no la guardes en archivos del repositorio ni modifiques variables de entorno globales. Al final, comprueba la conexión con una solicitud corta e informa del resultado.

Abajo están las instrucciones. El agente las recibe en Markdown en /docs/agents.md.

• La clave API la crea una persona en el panel de usuario en gate.joingonka.ai. No registres una cuenta ni crees claves por tu cuenta: pídele la clave al usuario.
• Mantén la clave en la variable de entorno JOINGONKA_API_KEY de tu sesión de terminal. No la escribas en archivos bajo git, no la incluyas en commits ni la muestres en el informe.
• No modifiques las variables globales OPENAI_* ni ANTHROPIC_*, ni en el perfil del shell ni en el sistema: otros herramientas del usuario las leen. La clave y la dirección se escriben en la configuración de la propia herramienta, eso hace el instalador.

• URL base para clientes de OpenAI API: https://gate.joingonka.ai/v1Copiar
• URL base para clientes de Anthropic API, sin /v1: https://gate.joingonka.aiCopiar
• La clave se envía en el encabezado Authorization: Bearer jg-… o x-api-key: jg-…
• La clave para consultar los modelos empieza por jg-; la clave de gestión gm- no da acceso a los modelos.
• Modelo recomendado: MiniMaxAI/MiniMax-M2.7Copiar
• Lista de modelos disponibles: GET https://gate.joingonka.ai/v1/models
• Por clave, hasta 120 solicitudes por minuto; por encima del límite, respuesta 429 con la cabecera Retry-After. Los límites y tiempos de espera están en la respuesta GET /v1/capabilities, campo limits.

Busca la herramienta del usuario en la tabla al final de la sección. Si existe el valor --tool, configura con el instalador; si no, hazlo manualmente siguiendo la guía.

Con el instalador#

Un solo comando sin preguntas: la clave sale de la variable de entorno y el modelo se pasa con un flag. El instalador escribirá la configuración de la herramienta, guardará una copia de la anterior y comprobará la conexión con una solicitud a la pasarela.

JOINGONKA_API_KEY=<key> npx -y @joingonka/setup --tool <id> --model MiniMaxAI/MiniMax-M2.7 --non-interactive

Si la herramienta estaba en ejecución, reiníciala: la configuración se lee al arrancar.

Manualmente#

Para una herramienta sin instalador, abre su guía (enlace en la tabla de abajo) y define tres valores:

• dirección base — https://gate.joingonka.ai/v1 para clientes de OpenAI API o https://gate.joingonka.ai para clientes de Anthropic API;
• clave — en el campo de clave API en los ajustes de la herramienta;
• modelo — MiniMaxAI/MiniMax-M2.7 u otro de GET /v1/models.

Herramientas y guías#

Verificación de la clave: consulta de saldo. No gasta tokens y la clave se toma de JOINGONKA_API_KEY:

curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"

Verificación de la dirección, la clave y el modelo: una solicitud corta al modelo:

curl -s https://gate.joingonka.ai/v1/chat/completions \
  -H "Authorization: Bearer $JOINGONKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'

Una respuesta 200 con texto del modelo significa que la conexión funciona. El instalador hace esta comprobación por sí solo: después basta con un código de salida 0.

El error llega en el campo error del cuerpo de la respuesta, con el tipo y el texto del motivo.

Todos los códigos de respuesta y límites están en la sección Errores y límites.

Al final, indícale al usuario:

• qué herramienta quedó configurada y qué archivo de configuración se escribió (el instalador imprime la ruta y deja una copia de la anterior al lado);
• la URL base y el identificador del modelo;
• el resultado de la comprobación: el código de respuesta y la respuesta del modelo, o por qué no se pudo comprobar;
• lo que aún debe hacer el usuario por su cuenta: por ejemplo, reiniciar la herramienta o recargar el saldo.

No incluyas la clave en el informe.

Las instrucciones se pueden instalar como habilidad (skill) para el agente: así las tendrá siempre a mano y sin necesidad de prompt:

npx skills add https://gate.joingonka.ai