Saltearse al contenido

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

CampoQué hace
ProviderOpenCode 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 KeyCon Go o Zen: se rellena con la credencial OpenCode (la clave de tu cuenta de opencode.ai).
OpenRouter API KeySolo 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).
InstructionLo que tiene que hacer, en palabras normales. Como herramienta, lo escribe el agente que la llama.
Agent InstructionsReglas fijas para todas las instrucciones: convenciones del proyecto, qué evitar, cómo contestar.
ModelUn 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.
PermissionsQué 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 URLEl repositorio que se clona la primera vez. Vacío, empieza en una carpeta vacía.
Workspace NameNombre ú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.
SkillsSkills 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 DoneCommit and push a new branch sube los cambios de cada instrucción a una rama nueva nappai/opencode-<fecha>.

Opciones avanzadas

CampoQué hace
BranchLa rama que se clona. Vacío, la rama principal del repositorio.
Git Access TokenToken para un repositorio privado y para subir la rama. Solo lo usan los comandos de Git de la plataforma.
Keep WorkspaceDuring 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 EffortCuánto piensa el modelo antes de actuar. Más es más lento y más caro.
Output SchemaUn 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 URLSolo 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 Data estructurado. En Run Instruction incluye changed_files, diff_summary, branch, denied_actions, steps, conversation_id, session_name, structured, usage y cost_usd; en List Sessions, Delete Session y Get Changes incluye los mismos datos estructurados en structured y 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:

  1. Añade un Voice Agent y un OpenCode Agent con tu credencial OpenCode.
  2. En Repository URL pon tu repositorio y, si es privado, el Git Access Token.
  3. Activa el modo herramienta del nodo y conéctalo a Tools del Voice Agent.
  4. 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.

Componentes relacionados

Claude Agent, Codex Agent, Antigravity Agent.