Чеклист перед сдачей агента
Пройдите этот чеклист перед созданием Pull Request. Агент, не прошедший чеклист, возвращается на доработку.
Код и архитектура
- Агент создан на базе Agent Template (не с нуля)
- Структура файлов соответствует шаблону
- Нет захардкоженных API-ключей, токенов, паролей в коде
-
.envдобавлен в.gitignore -
.env.exampleзаполнен всеми переменными с комментариями - Используется
logger.pyиз шаблона (неprint) - Используется
config.pyдля всех настроек
API
- Реализован
POST /runс правильной сигнатурой - Реализован
GET /healthс правильным ответом - Поле
metricsзаполняется (duration_sec, input_tokens, output_tokens, steps) - Ошибки возвращаются в поле
error, HTTP статус всегда 200
Тесты
- Минимум 3 теста через pytest
- Тесты покрывают
/run(успешный сценарий) - Тесты покрывают
/health - Тесты покрывают обработку ошибок
- Все тесты проходят:
pytest tests/
Docker
-
docker buildпроходит без ошибок - Контейнер запускается:
docker-compose up -
/healthотвечает после запуска контейнера - Размер образа не превышает 500 МБ
Документация
-
README.mdзаполнен: что делает агент, как запустить, примеры входных данных - Pull Request содержит описание агента и инструкцию по тестированию
Для маркетплейс-агентов (дополнительно)
- Агент работает стабильно при 50+ параллельных запросах
- 95% запросов
/runвыполняются за 30 секунд - Graceful degradation при недоступности внешних сервисов
- Карточка агента заполнена: описание, иконка, примеры задач