Uso de OpenCode con Agent Redactor

Requisito previo: instala Agent Redactor desde Microsoft Store o mediante el comando de una línea de PowerShell. También necesitas tener instalado OpenCode.

  1. Crea un perfil y configura el proxy de API

    En la barra lateral Profiles, selecciona o crea un perfil. Define un Profile Name, elige un puerto Local URL libre (p. ej. 8080), introduce el endpoint Forward To real de tu proveedor (p. ej. https://openrouter.ai/api/v1) y pega tu API Key real. La clave se cifra localmente y nunca sale de tu máquina.

    Sección de API Proxy de Agent Redactor con Profile Name OpenRouter Provider, Local URL localhost:8080, Forward To openrouter.ai/api/v1 y campo API Key
    Configura el perfil. Local URL es donde se conectará OpenCode; Forward To es el endpoint de API real.

  2. Activa la detección por IA y las reglas de redacción

    Selecciona las categorías de PII que quieres redactar. También puedes añadir reglas regex y palabras clave para secretos específicos del proyecto.

    Agent Redactor muestra el modelo de detección con IA activado, categorías de PII marcadas, panel de Estadísticas y redacciones de sesión que muestran PII detectado
    La detección por IA está activada con todas las categorías seleccionadas. El panel Redacciones de sesión muestra el PII interceptado (p. ej. "Bob" detectado como private_person).

  3. Abre OpenCode

    Inicia OpenCode. Verás la interfaz principal con el campo de chat y el selector de modelo actual.

    Pantalla principal de OpenCode que muestra New session con campo de chat y selector de modelo que muestra Big Pickle
    Pantalla principal de OpenCode con el campo de chat y el selector de modelo.

  4. Abre el selector de modelo

    Escribe /model en el campo de chat para abrir el diálogo de selección de modelo. También puedes pulsar Ctrl+' como atajo.

    OpenCode con /model escrito en el campo de chat mostrando la solicitud de selección de modelo
    Escribe /model para abrir el selector de modelo.

  5. Haz clic en "Connect provider"

    En el diálogo de selección de modelo, haz clic en el botón Connect provider de arriba a la derecha para añadir una nueva conexión de proveedor.

    Diálogo de selección de modelo de OpenCode con el botón Connect provider arriba a la derecha
    Haz clic en Connect provider para añadir Agent Redactor.

  6. Selecciona "Custom OpenAI-compatible provider"

    En la lista de proveedores, desplázate hasta la sección Other y selecciona Custom OpenAI-compatible provider. Esto te permite apuntar OpenCode a cualquier endpoint compatible con OpenAI.

    Diálogo Connect provider de OpenCode que muestra la lista de proveedores con Custom OpenAI-compatible provider en la sección Other
    Selecciona Custom OpenAI-compatible provider de la sección Other.

  7. Rellena los datos del proveedor

    Introduce lo siguiente en el formulario de proveedor personalizado:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (debe coincidir con el puerto de Agent Redactor)
    • API key: Déjalo vacío. Agent Redactor gestiona la autenticación mediante cabeceras (headers)
    Formulario de proveedor personalizado de OpenCode con Provider ID agent-redactor, Display name Agent Redactor, Base URL http://localhost:8080/
    Rellena los datos del proveedor. La Base URL debe coincidir con el puerto de tu proxy Agent Redactor.

  8. Añade tu modelo y envía

    Desplázate hasta la sección Models. Introduce el ID del modelo (p. ej. nvidia/nemotron-3-ultra-550b-a55b:free) y un nombre para mostrar (p. ej. "Nemotron 3 Ultra"). Haz clic en Submit para guardar.

    Sección Models del formulario de proveedor personalizado de OpenCode con ID de modelo nvidia/nemotron-3-ultra-550b-a55b:free y botón Submit
    Añade el modelo y haz clic en Submit.

  9. Selecciona tu modelo

    En el diálogo /model, busca "agent" y verás tu proveedor Agent Redactor con el modelo listado debajo. Selecciónalo para enrutar todas las solicitudes a través del proxy.

    Selector de modelo de OpenCode buscando agent y mostrando el proveedor Agent Redactor con Nemotron 3 Ultra(Free)
    Busca "agent" para encontrar tu proveedor Agent Redactor y selecciona el modelo.

  10. Empieza a chatear

    Envía un mensaje. En este ejemplo, el usuario dijo "My name is Bob". Agent Redactor detectó a "Bob" como PII, lo redactó antes de reenviarlo al LLM y lo restauró en la respuesta.

    Chat de OpenCode que muestra la conversación a través de Agent Redactor con el nombre Bob redactado y restaurado en la respuesta
    "Bob" se redactó a la salida y se restauró de forma transparente a la vuelta.

Verificar la redacción

Revisa el panel Redacciones de sesión en Agent Redactor para ver exactamente qué se interceptó.

Estadísticas de Agent Redactor que muestran Requests: 1, PII: 1 y Redacciones de sesión que muestran PII private_person Bob
El panel Estadísticas muestra "Requests: 1, PII: 1" y Redacciones de sesión lista el valor interceptado con marca de tiempo y tipo.
Consejo: usa reglas regex y palabras clave en tu perfil para detectar secretos específicos del proyecto que el modelo de IA pueda pasar por alto, por ejemplo, nombres de host internos, identificadores propietarios o nombres en clave de proyectos.