Интеграция с ИИ

Настройка ИИ-чата, подсказок по ошибкам LaTeX, доступа пользователей, квот и дополнительных сервисов поиска.

Эта функция предоставляется ayaka-notes/ayakaleaf-pro и доступна начиная с v6.3.0. Если у вас возникнут проблемы, будем рады вашим отзывам.

​

ИИ-ассистент и ассистент по ошибкам LaTeX

Ayakaleaf Pro добавляет функции ИИ в редактор двумя способами.

• ИИ-ассистент может использовать документы проекта и текущее выделение в качестве контекста, чтобы отвечать на вопросы и предлагать правки для вашей проверки.
• Ассистент по ошибкам предлагает точечное исправление, когда вы выбираете ошибку компиляции LaTeX.

​

Конфигурация Toolkit

Добавьте следующее в config/variables.env в вашем развёртывании Toolkit, заменив пример URL, ключа и модели значениями от вашего провайдера:

AI_ENABLED=true
AI_BASE_URL=https://ai-gateway.example.com/v1
AI_API_KEY=REPLACE_WITH_YOUR_GATEWAY_API_KEY
AI_MODEL=YOUR_TEXT_MODEL_ID

Храните настоящие API-ключи в файле окружения развёртывания и не добавляйте их в систему контроля версий. Значения выше — это заполнители, а не рабочие учётные данные.

Качество ИИ-подсказок зависит от выбранной модели. Если у вас уже есть подписка Codex или ChatGPT, её можно подключить через OpenAI-совместимый эндпоинт CLIProxyAPI.

AI_BASE_URL — это базовый URL OpenAI-совместимого API, включая префикс версии провайдера, если он требуется. Не добавляйте /chat/completions, так как он добавляется внутренне. Шлюз и модель должны поддерживать потоковые chat completions и инструменты-функции (function tools). Обе функции отправляют в этот шлюз контекст документа; чат также может отправлять загруженные изображения при использовании модели с поддержкой изображений.

Toolkit передаёт config/variables.env в контейнер приложения. Используйте указанные здесь имена переменных и не добавляйте префикс OVERLEAF_. После изменения этих переменных пересоздайте контейнер приложения из каталога Toolkit:

bin/up -d

​

Настройки шлюза

Переменная	По умолчанию	Назначение
AI_ENABLED	false	Установите ровно true, чтобы включить чат и подсказки по ошибкам для экземпляра. Если переменная не задана или имеет любое другое значение, функции остаются отключёнными. Также требуется рабочая конфигурация шлюза.
AI_BASE_URL	Нет; обязательно	Базовый URL OpenAI-совместимого API.
AI_API_KEY	Нет; обязательно	API-ключ для этого шлюза, используемый сервером.
AI_MODEL	Нет; обязательно	Текстовая модель, используемая конфигурацией чата по умолчанию и подсказками по ошибкам LaTeX.
AI_IMAGE_MODEL	Не задано	Необязательная модель с поддержкой изображений на том же шлюзе, использующая тот же API-ключ.
AI_MAX_STEPS	20	Максимальное число вызовов инструментов на одно сообщение пользователя в ИИ-чате, включая автоматические продолжения. Используйте положительное целое число.
AI_PROXY_URL	Не задано	Необязательный URL HTTP-прокси для обращений к ИИ-шлюзу. Не влияет на клиенты веб-поиска и поиска по документации.
AI_TOKEN_QUOTA	0	Лимит токенов на пользователя за период, общий для чата и подсказок по ошибкам. Если не задано или 0 — без ограничений; для установки лимита используйте положительное целое число.
AI_TOKEN_QUOTA_PERIOD	month	month сбрасывается в первый день месяца в 00:00 UTC; week — в понедельник в 00:00 UTC. Другие значения трактуются как month.

Для загрузки изображений задайте в AI_IMAGE_MODEL модель, которая принимает изображения на вход и поддерживает инструменты, используемые чатом. Любой запрос чата, история которого содержит вложенное изображение, использует эту модель, включая последующие сообщения в этом диалоге. Без этой настройки запросы с изображениями используют обычную модель чата, которая сама должна поддерживать изображения. Подсказки по ошибкам LaTeX по-прежнему используют AI_MODEL.

Например, чтобы включить модель для изображений и еженедельную квоту ИИ:

AI_IMAGE_MODEL=YOUR_IMAGE_CAPABLE_MODEL_ID
AI_TOKEN_QUOTA=100000
AI_TOKEN_QUOTA_PERIOD=week

​

Доступ пользователей и согласие

Доступность для экземпляра и разрешения пользователей — это разные вещи. AI_ENABLED и конфигурация шлюза управляют доступностью для экземпляра. Вошедший пользователь также должен пройти существующие проверки учётной записи:

• aiFeatures.enabled не должно быть равно false. Это существующее поле базы данных управляет как чатом, так и подсказками по ошибкам LaTeX.
• Действующее значение features.aiUsageQuota пользователя должно соответствовать настроенному неограниченному уровню (по умолчанию unlimited), либо должно быть включено существующее устаревшее разрешение features.aiErrorAssistant. Действующие возможности учитывают применимые переопределения возможностей учётной записи.

Само по себе включение флажка не меняет тарифный план пользователя. Поле aiUsageQuota — это уровень разрешений, а не числовая квота токенов. AI_TOKEN_QUOTA — отдельный лимит, одинаково применяемый к каждому пользователю с разрешением; текущий модуль не позволяет задать индивидуальный числовой лимит для отдельной учётной записи.

В списке пользователей панели администратора выберите пользователя и откройте Update account info → AI features. Enable AI features обновляет aiFeatures.enabled при сохранении изменений учётной записи. Сервер проверяет текущие разрешения при новых запросах к ИИ, включая запросы из уже открытого редактора. Чтобы обновить видимые элементы управления после изменения разрешений, обновите страницу редактора.

​

Использование и сброс

Вкладка AI features в панели администратора показывает в одной строке Usage (использование) за текущий период, Limit (лимит) и кнопку Reset (сброс). Данные об использовании считываются при открытии вкладки и не обновляются непрерывно. Чтобы увидеть актуальное значение, откройте вкладку заново после завершения запроса чата или подсказки по ошибке. Сброс вступает в силу немедленно и очищает только счётчик текущего периода для этого пользователя, после чего отображаемое использование перезагружается. Сохранять остальную форму учётной записи не требуется.

Использование чата и подсказок по ошибкам учитывается в одном общем счётчике Redis, который обновляется по общему числу токенов, сообщаемому провайдером модели после завершения запроса. Сюда входят входные и выходные токены на всех шагах модели. Входные данные могут включать историю диалога, контекст документа и результаты инструментов, поэтому последующий запрос может израсходовать больше токенов, чем одно новое сообщение. Использование учитывается, даже если лимит — Unlimited. Запросы без сообщённого общего числа токенов не увеличивают счётчик; восстановить ранее не учтённое использование модуль не может.

Проверка квоты выполняется до начала потоковой передачи. Один запрос или несколько параллельных запросов могут превысить оставшуюся квоту до того, как последующие запросы будут заблокированы. Это квота использования, а не строгий лимит расходов у провайдера. Если проверка квоты завершается ошибкой, запрос разрешается, а ошибка записывается в журнал.

Обе функции используют AI_TOKEN_QUOTA; отдельного лимита на количество запросов для подсказок по ошибкам нет. Сброс счётчика не меняет разрешения, согласие, настроенный лимит или собственные записи о расходах у провайдера. Счётчики используют ключи периодов в UTC и истекают через 40 дней; сохранение данных Redis позволяет сохранить текущее использование при перезапусках приложения.

​

Дополнительные сервисы поиска

Веб-поиск использует API, совместимый с Tavily. Он доступен, если настроен API-ключ поиска. Эти настройки не зависят от ИИ-шлюза:

Переменная	По умолчанию	Назначение
TAVILY_API_KEY	Не задано	API-ключ поиска. Имеет приоритет над WEB_SEARCH_API_KEY.
WEB_SEARCH_API_KEY	Не задано	Альтернативное имя для API-ключа поиска.
WEB_SEARCH_URL	https://api.tavily.com/search	Эндпоинт поиска; пользовательские эндпоинты должны принимать формат запросов и ответов Tavily.
WEB_SEARCH_MAX_RESULTS	5	Количество результатов, запрашиваемых при поиске; используйте положительное целое число, поддерживаемое сервисом.
WEB_SEARCH_DEPTH	basic	Глубина поиска, обычно basic или advanced.
WEB_SEARCH_PROVIDER	tavily	Текущая реализация поддерживает только протокол, совместимый с Tavily; изменение этого значения не выбирает другой адаптер.
DOCS_MCP_URL	https://docs.overleaf.com/~gitbook/mcp	Эндпоинт поиска по документации. Задайте пустую строку, чтобы отключить поиск по документации.

Например:

TAVILY_API_KEY=REPLACE_WITH_YOUR_SEARCH_API_KEY
WEB_SEARCH_MAX_RESULTS=5
WEB_SEARCH_DEPTH=basic
DOCS_MCP_URL=https://docs.overleaf.com/~gitbook/mcp

Поиск по документации вызывает инструмент searchDocumentation настроенного эндпоинта GitBook MCP и принимает ответы в формате JSON или SSE. Это MCP-клиент для поиска по документации; эти модули не предоставляют файлы проектов в качестве MCP-сервера и не предоставляют универсальный реестр MCP-серверов.

Поисковые запросы отправляются в настроенный сервис поиска. Затем результаты поиска могут включаться в запросы к ИИ-шлюзу. Меню Tools в чате позволяет пользователям включать или отключать Web и Documentation для своих запросов; кроме того, чтобы инструмент был доступен модели, он должен быть настроен на сервере.