Primeros pasos
3 min de lectura
Con estos cinco pasos tendrás un primer agente preparado para trabajar. El resto de la configuración puede esperar: añade capacidades cuando las necesites.
Si tu organización aún no tiene una máquina conectada o un modelo utilizable, el panel muestra un asistente a pantalla completa que los pide, y no deja ver el resto hasta que estén. Si no puede comprobarlo, te deja pasar al panel. Estos pasos siguen el mismo orden.
Antes de empezar
Confirma tu dirección de correo. Hasta entonces podrás explorar el panel, pero no crear organizaciones, iniciar agentes, conectar canales ni invitar a tu equipo. Consulta Tu cuenta si necesitas ayuda.
Prepara tu organización
Define el nombre y la zona horaria. Si otras personas van a administrarla, invítalas ahora. La organización reúne los ajustes y recursos compartidos de tus agentes.
Conecta una máquina
Los agentes se ejecutan en una máquina de tu infraestructura: tu propio ordenador o un servidor. El panel ofrece el comando de instalación para Windows, macOS y Linux; la guía de servidores detalla Windows y Linux. Para empezar basta tu ordenador, sin coste, pero los agentes solo trabajan mientras esté encendido; cuando quieras, los pasas a un servidor. Comprueba que aparece en línea antes de asignarle un agente.
Añade un modelo de IA
Conecta tu suscripción o una clave de API de un proveedor en la nube, o un motor local como Ollama o vLLM. En el asistente, Probar comprueba la conexión y solo la activa si funciona. Los agentes nuevos utilizarán la credencial predeterminada de la organización mientras no les asignes otra.
Crea tu primer agente
Elige un nombre y el servidor donde se ejecutará. Después podrás definir sus instrucciones, conocimientos, herramientas y accesos.
Conéctalo a un canal
Conecta un canal si debe recibir mensajes o eventos de personas y otros sistemas. Omite este paso si solo realizará tareas internas.
Configurarlo con un agente externo
Si prefieres delegar esta configuración a Claude Code, Codex u otro agente de programación, pégale este único mensaje:
Fetch https://api.kujira.so/agent-setup/prompt.mdEl agente descargará las instrucciones oficiales para conectarse a Kujira y te pedirá un token de servicio con los permisos que necesite. A partir de ahí puede guiarte, realizar la configuración a través de la API o importar un agente que ya tengas en otra herramienta, como un proyecto de Claude Code o Codex, o un GPT personalizado.
Concede solo los permisos necesarios
El token define lo que podrá consultar o cambiar el agente externo. Empieza con permisos de lectura y amplíalos solo si quieres que ejecute cambios. No pegues el token en la conversación: guárdalo en la variable de entorno KUJIRA_API_TOKEN y reinicia el agente para que la lea.
Después del primer agente
Define cómo trabaja
Configura identidad, permisos, límites y recursos según el trabajo que asumirá.
Aportar contexto
Añade memorias, habilidades y herramientas para darle contexto y los accesos necesarios.
Supervisar su actividad
Define cuándo debe pedir aprobación y revisa las acciones que requieren una decisión.
Puedes avanzar por fases
Puedes añadir más servidores, modelos, agentes y canales cuando el caso de uso lo requiera.