OpenCode Agent
OpenCode Agent pone en tu flujo a OpenCode, el agente de programación de código abierto, con tu suscripción OpenCode Go, saldo de OpenCode Zen o cualquier modelo de OpenRouter. Trabaja sobre un repositorio de Git o una carpeta vacía, en un espacio aislado solo para tu conversación: lee el código, lo cambia, ejecuta comandos y pruebas, y te devuelve su respuesta y la lista de ficheros que ha cambiado.
Funciona como un nodo normal (entra una instrucción, sale la respuesta) y como herramienta de un Agent o de un Voice Agent: así puedes pedir cambios en tu código hablando o por chat.
Cuándo usarlo
- Quieres que un agente arregle un error, añada una función pequeña, escriba pruebas o revise un cambio en un repositorio.
- Quieres programar por voz: el agente de voz le pasa lo que dices y te cuenta lo que ha hecho.
- Quieres automatizar tareas de código desde un flujo: por ejemplo, que cada incidencia nueva genere una rama con una propuesta de arreglo.
Cómo funciona
- Cada conversación (un chat del playground, una llamada, una sesión de la API) tiene su propio contenedor aislado con sus ficheros. Nadie más lo ve.
- Los mensajes siguientes de la misma conversación continúan el trabajo: el agente recuerda lo que hizo y los ficheros siguen ahí.
- El espacio de Run Instruction se apaga solo tras 15 minutos sin uso y se conserva 7 días; el siguiente mensaje lo vuelve a arrancar tal como estaba. Las operaciones List Sessions, Delete Session y Get Changes se ejecutan al vuelo (contenedor efímero destruido al instante, sin consumir límite de contenedores simultáneos).
- En el nodo colapsado solo aparece visible Instruction (a la izquierda) y Tools (abajo); el resto de campos se configuran desde el panel lateral o activando su visibilidad si necesitas cablearlos.
- La API key llega solo al proceso del agente y el token de Git solo a los comandos de Git que ejecuta la plataforma: el agente nunca ve el token.
Configuración
| Campo | Qué hace |
|---|---|
| Provider | OpenCode Go (por defecto): tu suscripción mensual de OpenCode Go. OpenCode Zen: saldo de pago por uso en opencode.ai (incluye modelos de Claude, GPT y Gemini). OpenRouter: con una clave de OpenRouter. |
| OpenCode API Key | Con Go o Zen: se rellena con la credencial OpenCode (la clave de tu cuenta de opencode.ai). |
| OpenRouter API Key | Solo con OpenRouter: tu clave de OpenRouter. |
| Operation (tool) | Qué hacer en el espacio de trabajo: Run Instruction (por defecto), List Sessions (devuelve las sesiones guardadas con su session_name, conversation_id, fecha y resumen), Delete Session (borra una sesión guardada sin tocar los archivos) o Get Changes (muestra los cambios pendientes sin consumir tokens). |
| Instruction | Lo que tiene que hacer, en palabras normales. Como herramienta, lo escribe el agente que la llama. |
| Agent Instructions | Reglas fijas para todas las instrucciones: convenciones del proyecto, qué evitar, cómo contestar. |
| Model | Un modelo del proveedor elegido, por ejemplo kimi-k3 o glm-5.3 en Go, claude-sonnet-5-5 en Zen, anthropic/claude-sonnet-5.5 en OpenRouter. |
| Permissions | Qué puede hacer dentro de su espacio: Read only (leer y explicar), Edit files (cambiar ficheros) o Edit files and run commands (por defecto; necesario para lanzar pruebas). Lo que pase de ese nivel se rechaza y aparece en el resultado. |
| Repository URL | El repositorio que se clona la primera vez. Vacío, empieza en una carpeta vacía. |
| Workspace Name | Nombre único para persistir la carpeta de trabajo en tu Storage (opencode_data/<nombre>). Vacío, no persiste (cada conversación empieza de cero). Con el mismo nombre en varios nodos o flujos de OpenCode Agent comparten archivos y sesiones. |
| Skills | Skills de tu cuenta de la plataforma (las tuyas y las instaladas del marketplace) que el agente puede usar. Pulsa refrescar para cargar la lista; se copian al agente antes de cada instrucción. |
| When Done | Commit and push a new branch sube los cambios de cada instrucción a una rama nueva nappai/opencode-<fecha>. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Branch | La rama que se clona. Vacío, la rama principal del repositorio. |
| Git Access Token | Token para un repositorio privado y para subir la rama. Solo lo usan los comandos de Git de la plataforma. |
| Keep Workspace | During the conversation (por defecto) conserva ficheros y memoria entre mensajes; Only for this run lo borra todo al acabar. |
| Session Name (tool) | Nombre lógico o conversation_id de la sesión a continuar o retomar. Vacío usa la sesión por defecto; pon nombres distintos por tarea para no mezclar contextos en un mismo espacio persistente. |
| New Session (tool) | Activado (true), arranca una conversación limpia desde cero en vez de reanudar la sesión actual. |
| Reasoning Effort | Cuánto piensa el modelo antes de actuar. Más es más lento y más caro. |
| Output Schema | Un esquema JSON opcional: el agente termina con una respuesta con esa forma, en structured del resultado. |
| Time Limit (s) | Si una instrucción tarda más, se detiene. Por defecto, 600. |
| API Base URL | Solo para una pasarela compatible propia. Vacío, la dirección oficial del proveedor. |
Resultado
- Response: en Run Instruction, la respuesta final del agente; en List Sessions, Delete Session y Get Changes, un JSON válido listo para automatizaciones (
{"sessions": [...], "count": N},{"changed_files": [...], "diff_summary": "...", "count": N}o{"deleted": true, "session_name": "..."}). - Result: objeto
Dataestructurado. En Run Instruction incluyechanged_files,diff_summary,branch,denied_actions,steps,conversation_id,session_name,structured,usageycost_usd; en List Sessions, Delete Session y Get Changes incluye los mismos datos estructurados enstructuredy en el nivel raíz (sessions,changed_files,deleted,count). Es lo que recibe un agente cuando lo usa como herramienta.
Ejemplo
Programar por voz sobre un repositorio:
- Añade un Voice Agent y un OpenCode Agent con tu credencial OpenCode.
- En Repository URL pon tu repositorio y, si es privado, el Git Access Token.
- Activa el modo herramienta del nodo y conéctalo a Tools del Voice Agent.
- Llama y di «arregla el test que falla en el módulo de facturas»: el agente de voz se lo pasa y te cuenta qué ha cambiado.
Seguridad
- Usa siempre tu API key: los inicios de sesión de suscripción (claude.ai, ChatGPT) no se pueden usar en NappAI.
- El agente trabaja aislado: sin acceso a la red interna de NappAI ni a los espacios de otras personas.
- Solo se usa el proveedor elegido: un modelo que no tiene da un error, nunca se cambia por otro modelo ni por otro proveedor.
- No escribas claves ni tokens en la instrucción: usa la credencial y el campo Git Access Token.