Usar o OpenCode com o Agent Redactor

Pré-requisito: Instale o Agent Redactor a partir da Microsoft Store ou através do comando de uma linha do PowerShell. Também precisa de ter o OpenCode instalado.

  1. Crie um perfil e configure o Proxy de API

    Na barra lateral de Perfis, selecione ou crie um perfil. Defina um Nome do Perfil, escolha uma porta URL Local livre (p. ex. 8080), introduza o endpoint real Encaminhar Para do seu fornecedor (p. ex. https://openrouter.ai/api/v1) e cole a sua chave de API real. A chave é encriptada localmente e nunca sai da sua máquina.

    Secção de Proxy de API do Agent Redactor com Nome do Perfil OpenRouter Provider, URL Local localhost:8080, Encaminhar Para openrouter.ai/api/v1 e campo de chave de API
    Configure o perfil. A URL local é onde o OpenCode se ligará; Encaminhar Para é o endpoint real da API.

  2. Ative a deteção e as regras de ocultação com IA

    Selecione as categorias de PII que pretende ocultar. Também pode adicionar regras de regex e palavras-chave para segredos específicos do projeto.

    Agent Redactor a mostrar o modelo de deteção com IA ativado, com categorias de PII assinaladas, painel de Estatísticas e Ocultações de Sessão a mostrar PII detetada
    A deteção de IA está ativada com todas as categorias selecionadas. O painel Ocultações de Sessão mostra PII intercetada (p. ex. "Bob" detetado como private_person).

  3. Abra o OpenCode

    Inicie o OpenCode. Verá a interface principal com o campo de entrada do chat e o seletor de modelo atual.

    Ecrã principal do OpenCode a mostrar New session com campo de entrada do chat e seletor de modelo a mostrar Big Pickle
    Ecrã principal do OpenCode com o campo de entrada do chat e o seletor de modelo.

  4. Abra o seletor de modelo

    Escreva /model no campo de entrada do chat para abrir a caixa de diálogo de seleção de modelo. Também pode premir Ctrl+' como atalho.

    OpenCode com /model escrito no campo de entrada do chat a mostrar o prompt de seleção de modelo
    Escreva /model para abrir o seletor de modelo.

  5. Clique em "Connect provider"

    Na caixa de diálogo de seleção de modelo, clique no botão Connect provider no canto superior direito para adicionar uma nova ligação de fornecedor.

    Caixa de diálogo de seleção de modelo do OpenCode com o botão Connect provider no canto superior direito
    Clique em Connect provider para adicionar o Agent Redactor.

  6. Selecione "Custom OpenAI-compatible provider"

    Na lista de fornecedores, percorra até à secção Other e selecione Custom OpenAI-compatible provider. Isto permite apontar o OpenCode para qualquer endpoint compatível com OpenAI.

    Caixa de diálogo Connect provider do OpenCode a mostrar a lista de fornecedores com Custom OpenAI-compatible provider na secção Other
    Selecione Custom OpenAI-compatible provider da secção Other.

  7. Preencha os detalhes do fornecedor

    Introduza o seguinte no formulário do fornecedor personalizado:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (tem de corresponder à porta no Agent Redactor)
    • API key: Deixe vazio. O Agent Redactor gere a autenticação através de cabeçalhos
    Formulário de fornecedor personalizado do OpenCode com Provider ID agent-redactor, Display name Agent Redactor e Base URL http://localhost:8080/
    Preencha os detalhes do fornecedor. A Base URL tem de corresponder à porta do seu proxy do Agent Redactor.

  8. Adicione o seu modelo e submeta

    Percorra até à secção Models. Introduza o ID do modelo (p. ex. nvidia/nemotron-3-ultra-550b-a55b:free) e um nome de apresentação (p. ex. "Nemotron 3 Ultra"). Clique em Submit para guardar.

    Secção Models do formulário de fornecedor personalizado do OpenCode com o ID do modelo nvidia/nemotron-3-ultra-550b-a55b:free e o botão Submit
    Adicione o modelo e clique em Submit.

  9. Selecione o seu modelo

    De volta à caixa de diálogo /model, procure por "agent" e verá o seu fornecedor Agent Redactor com o modelo listado por baixo. Selecione-o para encaminhar todos os pedidos através do proxy.

    Seletor de modelo do OpenCode a procurar agent e a mostrar o fornecedor Agent Redactor com Nemotron 3 Ultra (Free)
    Procure por "agent" para encontrar o seu fornecedor Agent Redactor e selecione o modelo.

  10. Comece a conversar

    Envie uma mensagem. Neste exemplo, o utilizador disse "My name is Bob". O Agent Redactor detetou "Bob" como PII, ocultou-o antes de reencaminhar para o LLM e restaurou-o na resposta.

    Chat do OpenCode a mostrar conversa através do Agent Redactor com o nome Bob ocultado e restaurado na resposta
    "Bob" foi ocultado no envio e restaurado de forma transparente no retorno.

Verificar a ocultação

Verifique o painel Ocultações de Sessão no Agent Redactor para ver exatamente o que foi intercetado.

Estatísticas do Agent Redactor a mostrar Requests: 1, PII: 1 e Ocultações de Sessão a mostrar PII private_person Bob
O painel Estatísticas mostra "Requests: 1, PII: 1" e as Ocultacões de Sessão listam o valor intercetado com data/hora e tipo.
Dica: Utilize regras de regex e palavras-chave no seu perfil para apanhar segredos específicos do projeto que o modelo de IA pode não detetar — por exemplo, nomes de host internos, IDs proprietários ou nomes de código de projetos.