Краткое руководство

1. Добавление API-ключа

AIGEO работает по модели BYOK (Bring Your Own Key) — мы не платим за ваши токены и не видим их. Ключ вводится один раз, шифруется DPAPI на вашем профиле Windows и хранится локально в %APPDATA%\AIGEO\AutoCAD2027Plugin\settings.json.

Откройте палитру AIGEO в AutoCAD (AIGEOCHAT) → нажмите кнопку шестерёнки в правом верхнем углу палитры → раздел «API Keys». Пять карточек: три прямых (OpenAI, Anthropic, Google) и два агрегатора (OpenRouter, Aitunnel.ru) — настраивайте то, чем пользуетесь.

Вариант А · Прямые ключи провайдеров (рекомендуется)

1. Найдите карточку OpenAI, Anthropic или Google Gemini и вставьте ключ (или нажмите «Replace», если меняете сохранённый).
2. Вставьте свой API-ключ:
   • OpenAI — sk-… с platform.openai.com/api-keys.
   • Anthropic — sk-ant-… с console.anthropic.com.
   • Google — AIzaSy… с aistudio.google.com/apikey.
3. Нажмите «Проверить». Плагин сделает один запрос к /models провайдера и покажет «✓ Ключ работает, N моделей доступно». Если возвращается ошибка 401 / 403 — ключ не подходит, проверьте, что у него есть права на нужные модели и не закончился биллинг.
4. Внизу окна нажмите «Save». Ключи зашифровываются (DPAPI) и пишутся в settings.json; в карточке видно только, что слот заполнен.

Вариант Б · Один ключ агрегатора (OpenRouter / Aitunnel.ru)

Удобно, если в вашем регионе сложно платить OpenAI / Anthropic / Google картой напрямую. Один ключ OpenRouter или Aitunnel.ru открывает все 3 flagship-модели из каталога; биллинг — у агрегатора. Зарегистрируйте ключ на openrouter.ai/keys или aitunnel.ru, вставьте его в соответствующую карточку и сохраните настройки.

Вариант В · Смешанный режим и приоритет маршрутизации

Можно держать и прямые ключи, и ключи агрегаторов одновременно. Как тогда плагин выбирает, к кому пойдёт запрос? В разделе API Keys над карточками есть выпадающий список порядка маршрутизации:

• Прямые API сначала — по умолчанию: для выбранной в палитре модели сначала используется прямой ключ семейства (OpenAI / Anthropic / Google), при его отсутствии — OpenRouter, затем Aitunnel.
• Только OpenRouter — запросы идут в OpenRouter, пока в карточке есть ключ; прямые и Aitunnel не рассматриваются. Удобно для теста или если все модели оплачены там.
• Только Aitunnel — аналогично для Aitunnel.ru.

Переключение сохраняется в настройках и сразу уходит в локальный sidecar: перезапуск AutoCAD не нужен.

2. Выбор модели

В палитре над полем ввода — выпадающий список моделей. Сгруппирован по провайдеру, всего 3 flagship-пункта (по одному топовому от каждого провайдера):

• OpenAI: GPT-5.5
• Anthropic: Claude Opus 4.7
• Google: Gemini 3.1 Pro

Если у вас подключён только прямой ключ одного провайдера — в списке будет одна модель этого провайдера. Ключ агрегатора (OpenRouter / Aitunnel) открывает все три. Все 3 модели — vision-capable: умеют принимать картинки и tool-calls.

3. Режимы работы

Чат (по умолчанию)

Обычный диалог. Плагин автоматически добавляет в контекст: имя активного чертежа, список слоёв, текущую систему координат и выделенные объекты. Спрашивайте «что в этом блоке?», «где дубли координат?», «как добавить размер 100×500 в слой DIM?» — модель видит сцену и отвечает по делу.

Vision (картинки)

Прикрепите изображение — модель «увидит» чертёж:

• Скриншот области через Win+Shift+S → Ctrl+V в палитру.
• Команда AIGEOZOOMSELECTION — отправит снимок текущего выделения в активный чат.
• Любой .png / .jpg через перетаскивание в окно палитры.

Agent (β) — модель сама вызывает CAD-команды

Включается переключателем «Agent» в палитре. Вместо текстового ответа модель формирует план из вызовов CAD-инструментов (DRAW, MOVE, COPY, OFFSET, INSERTBLOCK, MEASURE и т. д.) и показывает их по одному с кнопками «Выполнить» / «Пропустить». По умолчанию каждый шаг требует подтверждения; в настройках можно разрешить «авто-выполнение безопасных операций» (всё, что не удаляет и не меняет существующие сущности).

Вспомогательные команды

• AIGEOCHAT — открыть/спрятать палитру.
• AIGEOANALYZESELECTION — собрать описание текущего выделения и подставить в чат как контекст (геометрия + слой + цвет + блок).
• AIGEOZOOMSELECTION — приблизить камеру к выделению и отправить снимок в чат (Vision-режим).
• AIGEOREFRESHTOOLS — пересобрать список доступных CAD-инструментов в режиме Agent (после установки сторонних надстроек, например).

4. История и приватность

• Все диалоги хранятся локально в зашифрованном SQLite по пути%APPDATA%\AIGEO\AutoCAD2027Plugin\. На наши серверы не уходит ни сообщений, ни ответов.
• В палитре кнопка «История» открывает поиск по диалогам с фильтрами по дате / модели / чертежу.
• Экспорт в JSON: правый клик по диалогу → «Экспорт». Удобно, чтобы передать коллеге или сохранить в трекере задач.
• Удаление: правый клик → «Удалить»; либо «Очистить всё» в настройках истории. После удаления запись не восстанавливается.

5. Смена компьютера

Лицензия жёстко привязана к одной машине — это защита от того, чтобы кто-то скопировал папку плагина и запустил у себя. Чтобы переехать на новый ПК:

1. Напишите на support@aigeoassist.ru. В письме укажите номер заказа CloudPayments из чека и/или сам лицензионный ключ.
2. Мы в течение одного рабочего дня отвяжем ключ от старой машины. После этого плагин на старом ПК увидит «лицензия не активирована».
3. На новом ПК установите плагин и пройдите активацию (см. «Установка» шаг 4). При активации тот же ключ привяжется к новой машине.

6. Полезные привычки

• Лимиты у провайдера. OpenAI / Anthropic / Google по умолчанию ставят месячный потолок ~$120; включите «жёсткий лимит» в кабинете провайдера, чтобы случайный цикл в Agent-режиме не вышел вам в неприятный счёт.
• Длинные диалоги. После 30–40 сообщений контекст начинает «съедать» внимание модели. Кнопка «Новый чат» в палитре — частая и нормальная практика. История остаётся.
• Чувствительные чертежи. Помните, что в BYOK-режиме промпты всё равно уходят к провайдеру — это его серверы, не ваши. Если работаете под NDA — сверяйтесь с условиями обработки данных у конкретного провайдера и/или маскируйте чертёж перед отправкой.