Перейти к основному содержимому

AI-ассистент

Задавайте вопросы о кодовой базе на естественном языке.

Обзор​

AI-ассистент ArchiCore понимает вашу кодовую базу и отвечает на вопросы:

  • "Как работает система аутентификации?"
  • "Что сломается, если изменить UserService?"
  • "Где находится логика обработки платежей?"
  • "Объясни поток данных при создании заказа"

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

Веб-интерфейс​

  1. Выберите проект
  2. Введите вопрос в панели чата
  3. Получите ответ со ссылками на код

CLI​

Просто введите вопрос в интерактивном режиме:

> Как работает аутентификация пользователей?

Система аутентификации использует JWT токены.
Вот как это работает:

1. **Вход** (src/auth/login.ts)
   - Пользователь отправляет email/пароль
   - Данные проверяются в базе
   - Генерируется JWT токен

2. **Валидация токена** (src/middleware/auth.ts)
   - authMiddleware() извлекает токен из заголовка
   - Токен проверяется с JWT_SECRET
   - Пользователь прикрепляется к запросу

Ключевые файлы:
- src/auth/login.ts:45-78
- src/middleware/auth.ts:12-34

API​

curl -X POST https://api.archicore.io/api/v1/projects/:id/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"question": "Как работает аутентификация?"}'

Типы вопросов​

Вопросы об архитектуре​

> Какова общая архитектура проекта?
> Как организованы модули?
> Какие паттерны проектирования используются?

Вопросы о потоке данных​

> Что происходит когда пользователь делает заказ?
> Как данные идут от API к базе?

Вопросы о влиянии​

> Что сломается если изменить UserService?
> Какие файлы зависят от модуля базы данных?

Вопросы о местоположении​

> Где находится логика отправки email?
> Какой файл обрабатывает регистрацию?

Советы для лучших ответов​

Будьте конкретны​

❌ "Как это работает?"
✓ "Как работает процесс регистрации пользователя?"

Предоставьте контекст​

❌ "Почему это медленно?"
✓ "Почему функция getProducts() в src/api/products.ts может быть медленной?"

Поддержка языков​

Ассистент отвечает на языке вашего вопроса:

> How does authentication work?
The authentication system uses JWT tokens...

> Как работает аутентификация?
Система аутентификации использует JWT токены...

Ограничения​

AI-ассистент:

  • Знает только проиндексированный код — сначала запустите /index
  • Не может выполнять код — только анализирует
  • Может иметь устаревшую информацию — переиндексируйте после изменений