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

Agent Template

Agent Template — обязательный стандарт разработки агентов для платформы AI Agenta. Это не рекомендация, а требование: все агенты в маркетплейсе должны быть созданы на его основе. Шаблон обеспечивает совместимость с оркестратором платформы, единый формат метрик и логирования.

Структура проекта

agent_template/
├── app/
│ ├── main.py # FastAPI: /health и /run
│ ├── runner.py # Agentic loop (Claude API + tool use)
│ ├── metrics.py # Метрики в оркестратор
│ ├── models.py # Pydantic: TaskRequest, TaskResponse
│ ├── config.py # Настройки через .env
│ └── logger.py # Структурированный логгер
├── tools/
│ ├── __init__.py # TOOL_REGISTRY
│ └── example_tools.py
├── tests/
│ └── test_agent.py
├── Dockerfile
├── requirements.txt
└── .env.example

Технические требования

ТребованиеОписание
LLM-бэкендТолько Claude API (claude-sonnet)
ЯзыкPython 3.11+
ФреймворкFastAPI
КонтейнеризацияDocker + docker-compose
ТестыМинимум 3 через pytest
Логированиеlogger.py из шаблона
МетрикиПоле metrics в ответе /run
СекретыТолько через .env

Разделы документации