3.2 KiB
3.2 KiB
Инструкции для Claude AI
Контекст проекта
Это репозиторий AI-агентов для проекта "Новая Планета" — визуальное расписание для детей с расстройством аутистического спектра (РАС).
Архитектура
Проект разделен на три репозитория:
- new-planet-backend — FastAPI backend
- new-planet-android — Android приложение
- 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 использует эти агенты через импорты:
from agents.schedule_generator import ScheduleGenerator
from agents.chat_agent import ChatAgent
Переменные окружения
GIGACHAT_CLIENT_ID— ID клиента GigaChatGIGACHAT_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 заполняй минимально необходимо для понимания
- промты для ии-агента не пиши, но явно укажи место, где нужно дописать промпт