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

Чеклист перед сдачей агента

Пройдите этот чеклист перед созданием 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 при недоступности внешних сервисов
  • Карточка агента заполнена: описание, иконка, примеры задач