Перейти к содержанию

Настройка сканера уязвимостей ИИ-агентов

Для работы модуля необходимо подключить модель с API, совместимым с OpenAI Chat Completions. Для этого понадобятся:

  • URL-адрес API,
  • название модели,
  • ключ доступа от поставщика услуг.

Добавление настроек подключения

  1. Откройте файл конфигурации fuchsiad (по умолчанию /etc/fuchsia/config.yml).
  2. Добавьте следующий блок, сохранив остальные настройки файла:

    llms:
      - labels: [ai-agent-scanner]
        proxy: "https://proxy.example.com"
        provider: open_ai
        lm_project: example123456
        base_url: "https://api.example.com/v1"
        model: "название-модели"
        api_token: "ваш-api-ключ"
        reasoning_enabled: false
    

    Если блок llms уже существует в файле конфигурации, добавьте в него запись с меткой ai-agent-scanner. Такая запись должна быть только одна. Если она уже существует — актуализируйте её.

  3. Замените значения следующих полей данными своего подключения:

    • proxy — URL-адрес прокси-сервера для взаимодействия с LLM-судьями (опциональное поле);
    • base_url — URL-адрес API поставщика. Допускается как базовый адрес (например, https://api.example.com/v1), так и полный адрес, содержащий путь /chat/completions;
    • lm_project — опциональное поле, необходимое для подключения LLM-моделей Яндекс;
    • model — название модели у поставщика;
    • api_token — ключ доступа. Если ключ не требуется, укажите "";
    • reasoning_enabled — опциональный флаг, включающий размышление для LLM-судей (по умолчанию false).

    Значения полей labels и provider оставьте как в примере.

  4. Сохраните файл конфигурации.

Применение настроек

Выполните следующую команду:

fuchsiactl reload

Выполните следующую команду, заменив <имя-контейнера> именем контейнера Fuchsia (для уточнения, используйте команду docker ps):

docker exec <имя-контейнера> fuchsiactl reload

Запуск сканирования

Запустите новое сканирование с включённым модулем ai-agent-scanner. Для стандартного запуска достаточно настроек подключения в файле конфигурации fuchsiad.

Проверка подключения

Откройте журнал модуля для запущенного сканирования.

  • В сообщении «SCANNER STARTED» должны быть указаны URL-адрес API поставщика и название модели.
  • Сообщение «MODEL READY» подтверждает, что модель ответила на проверочный запрос.

В случае неудачи записи журнала будут содержать ошибку.