68 lines
2.9 KiB
Markdown
68 lines
2.9 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 часа
|
||
- Промпты оптимизированы для детей с РАС (простой язык, короткие предложения)
|
||
|