Використання OpenCode з Agent Redactor

Передумова: встановіть Agent Redactor із Microsoft Store або за допомогою однострочного командного рядка PowerShell. Також потрібно встановити OpenCode.

  1. Створіть профіль і налаштуйте API Proxy

    На бічній панелі Профілі виберіть або створіть профіль. Встановіть назву профілю, оберіть вільний порт локальної URL-адреси (напр. 8080), введіть справжню кінцеву точку «Пересилати до» для вашого провайдера (напр. https://openrouter.ai/api/v1) і вставте свій справжній ключ API. Ключ шифрується локально і ніколи не залишає ваш пристрій.

    Розділ API Proxy в Agent Redactor із назвою профілю OpenRouter Provider, локальною URL-адресою localhost:8080, полем «Пересилати до» openrouter.ai/api/v1 та полем ключа API
    Налаштуйте профіль. Локальна URL-адреса — це місце, до якого підключатиметься OpenCode, а поле «Пересилати до» — справжня API-кінцева точка.

  2. Увімкніть виявлення на основі AI та правила редагування

    Виберіть категорії PII, які потрібно редагувати. Для секретів, специфічних для проєкту, ви також можете додати regex-шаблони та ключові слова.

    Agent Redactor з увімкненою моделлю виявлення на основі AI, позначеними категоріями PII, панеллю статистики та панеллю «Редагування сеансів» із виявленою PII
    AI-виявлення увімкнено, вибрано всі категорії. Панель «Редагування сеансів» показує перехоплену PII (напр. «Bob» виявлено як private_person).

  3. Відкрийте OpenCode

    Запустіть OpenCode. Ви побачите головний інтерфейс із полем введення чату та селектором поточної моделі.

    Головний екран OpenCode із New session, полем введення чату та селектором моделі, що показує Big Pickle
    Головний екран OpenCode із полем введення чату та селектором моделі.

  4. Відкрийте селектор моделі

    Введіть /model у поле введення чату, щоб відкрити діалог вибору моделі. Також можна натиснути Ctrl+' як гарячу клавішу.

    OpenCode з введеним /model у полі чату та підказкою вибору моделі
    Введіть /model, щоб відкрити селектор моделі.

  5. Натисніть «Connect provider»

    У діалозі вибору моделі натисніть кнопку Connect provider угорі праворуч, щоб додати нове підключення провайдера.

    Діалог вибору моделі в OpenCode із кнопкою Connect provider угорі праворуч
    Натисніть Connect provider, щоб додати Agent Redactor.

  6. Виберіть «Custom OpenAI-compatible provider»

    У списку провайдерів прокрутіть до розділу Other і виберіть Custom OpenAI-compatible provider. Це дозволяє спрямувати OpenCode на будь-яку OpenAI-сумісну кінцеву точку.

    Діалог «Connect provider» в OpenCode зі списком провайдерів, який містить Custom OpenAI-compatible provider у розділі Other
    Виберіть Custom OpenAI-compatible provider у розділі Other.

  7. Заповніть дані провайдера

    Введіть такі дані у форму власного провайдера:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (має збігатися з портом у Agent Redactor)
    • API key: Залиште порожнім. Agent Redactor керує автентифікацією через заголовки
    Форма власного провайдера в OpenCode із Provider ID agent-redactor, Display name Agent Redactor та Base URL http://localhost:8080/
    Заповніть дані провайдера. Base URL має збігатися з портом вашого проксі Agent Redactor.

  8. Додайте модель і надішліть

    Прокрутіть до розділу Models. Введіть ідентифікатор моделі (напр. nvidia/nemotron-3-ultra-550b-a55b:free) і відображувану назву (напр. «Nemotron 3 Ultra»). Натисніть Submit, щоб зберегти.

    Розділ Models у формі власного провайдера в OpenCode з ідентифікатором моделі nvidia/nemotron-3-ultra-550b-a55b:free та кнопкою Submit
    Додайте модель і натисніть Submit.

  9. Виберіть свою модель

    Поверніться до діалогу /model, знайдіть «agent» — ви побачите свого провайдера Agent Redactor з моделлю під ним. Виберіть його, щоб спрямовувати всі запити через проксі.

    Селектор моделі в OpenCode із пошуком agent, який показує провайдера Agent Redactor з Nemotron 3 Ultra(Free)
    Знайдіть «agent», щоб знайти свого провайдера Agent Redactor, і виберіть модель.

  10. Почніть чат

    Надішліть повідомлення. У цьому прикладі користувач сказав «My name is Bob». Agent Redactor виявив «Bob» як PII, відредагував його перед пересиланням до LLM і відновив у відповіді.

    Чат OpenCode, що показує розмову через Agent Redactor, де ім'я Bob відредаговано та відновлено у відповіді
    «Bob» було відредаговано на виході та прозоро відновлено на зворотному шляху.

Перевірка редагування

Перевірте панель «Редагування сеансів» в Agent Redactor, щоб точно побачити, що було перехоплено.

Статистика Agent Redactor із Requests: 1, PII: 1 та «Редагування сеансів» із PII private_person Bob
Панель статистики показує «Requests: 1, PII: 1», а «Редагування сеансів» перелічує перехоплене значення з часовою міткою та типом.
Порада: використовуйте regex-шаблони та ключові слова у своєму профілі, щоб перехоплювати специфічні для проєкту секрети, які AI-модель може пропустити, наприклад внутрішні хостнейми, власницькі ID або кодові назви проєктів.