73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# Инструкции для Claude AI
|
|
|
|
## Контекст проекта
|
|
|
|
Это репозиторий **AI-агентов** для проекта "Новая Планета" — визуальное расписание для детей с расстройством аутистического спектра (РАС).
|
|
|
|
## Архитектура
|
|
|
|
Проект разделен на три репозитория:
|
|
1. **new-planet-backend** — FastAPI backend
|
|
2. **new-planet-android** — Android приложение
|
|
3. **new-planet-ai-agents** (текущий) — Python агенты и скрипты
|
|
|
|
## Структура
|
|
|
|
- `agents/` — ИИ-агенты (GigaChat клиент, генератор расписаний, чат-агент)
|
|
- `prompts/` — промпты для LLM (персона "Земля", генерация расписаний)
|
|
- `services/` — сервисы (управление токенами, Redis кэш, обработка изображений)
|
|
- `models/` — Pydantic модели данных
|
|
- `scripts/` — утилиты (генерация данных, анализ использования)
|
|
|
|
## Основные компоненты
|
|
|
|
### GigaChatClient
|
|
Асинхронный клиент для работы с GigaChat API. Использует TokenManager для получения токенов.
|
|
|
|
### ScheduleGenerator
|
|
Генерирует расписания для детей с РАС на основе возраста, предпочтений и даты.
|
|
|
|
### ChatAgent
|
|
ИИ-агент "Планета Земля" для общения с детьми и родителями. Использует Redis для хранения контекста.
|
|
|
|
### RecommendationEngine
|
|
Простая рекомендательная система на основе TF-IDF (MVP-1).
|
|
|
|
## Интеграция с Backend
|
|
|
|
Backend использует эти агенты через импорты:
|
|
```python
|
|
from agents.schedule_generator import ScheduleGenerator
|
|
from agents.chat_agent import ChatAgent
|
|
```
|
|
|
|
## Переменные окружения
|
|
|
|
- `GIGACHAT_CLIENT_ID` — ID клиента GigaChat
|
|
- `GIGACHAT_CLIENT_SECRET` — секрет клиента
|
|
- `REDIS_URL` — URL Redis для кэширования
|
|
|
|
## Стиль кода
|
|
|
|
- Python 3.11+
|
|
- Async/await для всех I/O операций
|
|
- Pydantic для валидации
|
|
- Type hints везде
|
|
- Docstrings для всех публичных методов
|
|
|
|
## Тестирование
|
|
|
|
Используется pytest с asyncio. Моки для внешних API (GigaChat, Redis).
|
|
|
|
## Важные замечания
|
|
|
|
- GigaChat токены обновляются автоматически
|
|
- Контекст разговоров хранится в Redis с TTL 24 часа
|
|
- Промпты оптимизированы для детей с РАС (простой язык, короткие предложения)
|
|
|
|
## Запреты
|
|
- Не пиши тесты
|
|
- README.md заполняй минимально необходимо для понимания
|
|
- промты для ии-агента не пиши, но явно укажи место, где нужно дописать промпт
|
|
|