Usare OpenCode con Agent Redactor

Prerequisito: Installare Agent Redactor dal Microsoft Store oppure tramite il comando PowerShell su una riga. Devi inoltre avere installato OpenCode.

  1. Crea un profilo e configura il Proxy API

    Nella barra laterale Profiles, seleziona o crea un profilo. Imposta un Nome profilo, scegli una porta locale libera (ad es. 8080), inserisci il vero endpoint Forward To del tuo provider (ad es. https://openrouter.ai/api/v1) e incolla la tua vera chiave API. La chiave è crittografata in locale e non lascia mai il tuo computer.

    Sezione Proxy API di Agent Redactor con Nome profilo OpenRouter Provider, Local URL localhost:8080, Forward To openrouter.ai/api/v1 e campo chiave API
    Configura il profilo. Local URL è il punto in cui OpenCode si collegherà, Forward To è il vero endpoint API.

  2. Attiva il rilevamento AI e le regole di redazione

    Seleziona le categorie PII da redigere. Puoi anche aggiungere regole regex e parole chiave per i segreti specifici del progetto.

    Agent Redactor con modello di rilevamento AI abilitato, categorie PII spuntate, pannello Statistiche e Session Redactions che mostra PII rilevate
    Il rilevamento AI è attivo con tutte le categorie selezionate. Il pannello Session Redactions mostra la PII intercettata (ad es. "Bob" rilevato come private_person).

  3. Apri OpenCode

    Avvia OpenCode. Vedrai l'interfaccia principale con il campo di input della chat e il selettore del modello corrente.

    Schermata principale di OpenCode con New session, campo di input della chat e selettore del modello che mostra Big Pickle
    Schermata principale di OpenCode con il campo di input della chat e il selettore del modello.

  4. Apri il selettore del modello

    Digita /model nel campo di input della chat per aprire la finestra di selezione del modello. Puoi anche premere Ctrl+' come scorciatoia.

    OpenCode con /model digitato nel campo di input della chat e finestra di selezione del modello mostrata
    Digita /model per aprire il selettore del modello.

  5. Fai clic su "Connect provider"

    Nella finestra di selezione del modello, fai clic sul pulsante Connect provider in alto a destra per aggiungere una nuova connessione provider.

    Finestra di selezione del modello di OpenCode con il pulsante Connect provider in alto a destra
    Fai clic su Connect provider per aggiungere Agent Redactor.

  6. Seleziona "Custom OpenAI-compatible provider"

    Nell'elenco dei provider, scorri fino alla sezione Other e seleziona Custom OpenAI-compatible provider. Questo ti consente di puntare OpenCode a qualsiasi endpoint compatibile con OpenAI.

    Finestra Connect provider di OpenCode con elenco dei provider e Custom OpenAI-compatible provider nella sezione Other
    Seleziona Custom OpenAI-compatible provider dalla sezione Other.

  7. Compila i dettagli del provider

    Inserisci quanto segue nel modulo del provider personalizzato:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (deve corrispondere alla porta in Agent Redactor)
    • API key: Lascia vuoto. Agent Redactor gestisce l'autenticazione tramite gli header
    Modulo del provider personalizzato di OpenCode con Provider ID agent-redactor, Display name Agent Redactor e Base URL http://localhost:8080/
    Compila i dettagli del provider. La Base URL deve corrispondere alla porta del proxy di Agent Redactor.

  8. Aggiungi il tuo modello e invia

    Scorri fino alla sezione Models. Inserisci l'ID del modello (ad es. nvidia/nemotron-3-ultra-550b-a55b:free) e un nome visualizzato (ad es. "Nemotron 3 Ultra"). Fai clic su Submit per salvare.

    Sezione Models del modulo del provider personalizzato di OpenCode con ID del modello nvidia/nemotron-3-ultra-550b-a55b:free e pulsante Submit
    Aggiungi il modello e fai clic su Submit.

  9. Seleziona il tuo modello

    Torna nella finestra /model, cerca "agent" e vedrai il tuo provider Agent Redactor con il modello elencato sotto. Selezionalo per instradare tutte le richieste attraverso il proxy.

    Selettore del modello di OpenCode con ricerca di agent che mostra il provider Agent Redactor con Nemotron 3 Ultra(Free)
    Cerca "agent" per trovare il tuo provider Agent Redactor e seleziona il modello.

  10. Inizia a chattare

    Invia un messaggio. In questo esempio, l'utente ha scritto "My name is Bob". Agent Redactor ha rilevato "Bob" come PII, lo ha redatto prima di inoltrarlo all'LLM e lo ha ripristinato nella risposta.

    Chat di OpenCode che mostra la conversazione attraverso Agent Redactor con il nome Bob redatto e ripristinato nella risposta
    "Bob" è stato redatto all'andata e ripristinato in modo trasparente al ritorno.

Verifica della redazione

Controlla il pannello Session Redactions in Agent Redactor per vedere esattamente cosa è stato intercettato.

Statistiche di Agent Redactor che mostrano Requests: 1, PII: 1 e Session Redactions con PII private_person Bob
Il pannello Statistics mostra "Requests: 1, PII: 1" e Session Redactions elenca il valore intercettato con data e ora e tipo.
Suggerimento: Usa le regole regex e le parole chiave nel tuo profilo per individuare i segreti specifici del progetto che il modello AI potrebbe non notare, ad esempio nomi host interni, ID proprietari o nomi in codice di progetto.