Utiliser OpenCode avec Agent Redactor

Prérequis : Installez Agent Redactor depuis le Microsoft Store ou via la commande PowerShell en une ligne. Vous devez également avoir OpenCode installé.

  1. Créez un profil et configurez le proxy API

    Dans la barre latérale Profils, sélectionnez ou créez un profil. Définissez un Nom de profil, choisissez un port gratuit URL locale (par ex. 8080), saisissez le véritable point de terminaison Transférer vers de votre fournisseur (par ex. https://openrouter.ai/api/v1) et collez votre véritable clé API. La clé est chiffrée localement et ne quitte jamais votre machine.

    Section proxy API d'Agent Redactor avec Nom de profil OpenRouter Provider, URL locale localhost:8080, Transférer vers openrouter.ai/api/v1 et champ clé API
    Configurez le profil. L'URL locale est l'endroit où OpenCode se connectera ; Transférer vers est le véritable point de terminaison de l'API.

  2. Activez la détection par IA et les règles de masquage

    Sélectionnez les catégories de PII que vous souhaitez masquer. Vous pouvez également ajouter des règles regex et des mots-clés pour les secrets propres à votre projet.

    Agent Redactor montrant le modèle de détection IA activé avec les catégories de PII cochées, le panneau Statistiques et le panneau Masquages de session affichant les PII détectées
    La détection IA est activée avec toutes les catégories sélectionnées. Le panneau Masquages de session affiche les PII interceptées (par ex. "Bob" détecté comme private_person).

  3. Ouvrez OpenCode

    Lancez OpenCode. Vous verrez l'interface principale avec la zone de chat et le sélecteur de modèle actuel.

    Écran principal d'OpenCode montrant New session avec la zone de chat et le sélecteur de modèle affichant Big Pickle
    Écran principal d'OpenCode avec la zone de chat et le sélecteur de modèle.

  4. Ouvrez le sélecteur de modèle

    Saisissez /model dans la zone de chat pour ouvrir la boîte de dialogue de sélection du modèle. Vous pouvez également appuyer sur Ctrl+' comme raccourci.

    OpenCode avec /model saisi dans la zone de chat affichant l'invite de sélection du modèle
    Saisissez /model pour ouvrir le sélecteur de modèle.

  5. Cliquez sur "Connect provider"

    Dans la boîte de dialogue de sélection du modèle, cliquez sur le bouton Connect provider en haut à droite pour ajouter une nouvelle connexion de fournisseur.

    Boîte de dialogue de sélection du modèle d'OpenCode avec le bouton Connect provider en haut à droite
    Cliquez sur Connect provider pour ajouter Agent Redactor.

  6. Sélectionnez "Custom OpenAI-compatible provider"

    Dans la liste des fournisseurs, faites défiler jusqu'à la section Other et sélectionnez Custom OpenAI-compatible provider. Cela vous permet de pointer OpenCode vers n'importe quel point de terminaison compatible OpenAI.

    Boîte de dialogue Connect provider d'OpenCode affichant la liste des fournisseurs avec Custom OpenAI-compatible provider dans la section Other
    Sélectionnez Custom OpenAI-compatible provider dans la section Other.

  7. Remplissez les informations du fournisseur

    Saisissez les éléments suivants dans le formulaire du fournisseur personnalisé :

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (doit correspondre au port dans Agent Redactor)
    • API key: Laissez vide. Agent Redactor gère l'authentification via les en-têtes
    Formulaire du fournisseur personnalisé d'OpenCode avec Provider ID agent-redactor, Display name Agent Redactor, Base URL http://localhost:8080/
    Remplissez les informations du fournisseur. L'URL de base doit correspondre au port du proxy de votre Agent Redactor.

  8. Ajoutez votre modèle et soumettez

    Faites défiler jusqu'à la section Models. Saisissez l'ID du modèle (par ex. nvidia/nemotron-3-ultra-550b-a55b:free) et un nom d'affichage (par ex. "Nemotron 3 Ultra"). Cliquez sur Submit pour enregistrer.

    Formulaire du fournisseur personnalisé d'OpenCode, section Models, avec l'ID de modèle nvidia/nemotron-3-ultra-550b-a55b:free et le bouton Submit
    Ajoutez le modèle et cliquez sur Submit.

  9. Sélectionnez votre modèle

    De retour dans la boîte de dialogue /model, recherchez "agent" et vous verrez votre fournisseur Agent Redactor avec le modèle listé en dessous. Sélectionnez-le pour router toutes les requêtes via le proxy.

    Sélecteur de modèle d'OpenCode recherchant agent affichant le fournisseur Agent Redactor avec Nemotron 3 Ultra(Free)
    Recherchez "agent" pour trouver votre fournisseur Agent Redactor et sélectionnez le modèle.

  10. Commencez à discuter

    Envoyez un message. Dans cet exemple, l'utilisateur a dit "My name is Bob". Agent Redactor a détecté "Bob" comme PII, l'a masqué avant de le transmettre au LLM, puis l'a restauré dans la réponse.

    Chat OpenCode affichant la conversation via Agent Redactor avec le nom Bob masqué et restauré dans la réponse
    "Bob" a été masqué à l'envoi et restauré de manière transparente au retour.

Vérification du masquage

Consultez le panneau Masquages de session dans Agent Redactor pour voir exactement ce qui a été intercepté.

Statistiques d'Agent Redactor affichant Requests: 1, PII: 1 et Masquages de session affichant la PII private_person Bob
Le panneau Statistiques affiche "Requests: 1, PII: 1" et Masquages de session liste la valeur interceptée avec l'horodatage et le type.
Astuce : Utilisez des règles regex et des mots-clés dans votre profil pour détecter les secrets propres au projet que le modèle IA pourrait manquer, par exemple les noms d'hôte internes, les ID propriétaires ou les noms de code du projet.