Agents Monorepo

Монорепозиторий для агентских сервисов автоматизации Facebook Ads.

Сервисы

🧠 agent-brain

Сервис для оценки эффективности рекламных кампаний (scoring) и автоматического управления существующими кампаниями.

Запуск:

docker compose up -d --build agent-brain

🎬 agent-service

Основной сервис для работы с Facebook Ads и обработки видео креативов.

🎨 frontend (NEW!)

Next.js frontend приложение для управления рекламными кампаниями.

Функциональность:

Управление рекламными кампаниями (pause/resume/duplicate)
Обработка видео и создание креативов:
- Прием видео через webhook
- Транскрибация аудио (OpenAI Whisper)
- Загрузка в Facebook
- Автоматическое создание 3 типов креативов:
  - WhatsApp (Click to WhatsApp)
  - Instagram Traffic
  - Website Leads
Campaign Builder Agent (NEW!):
- Автоматический подбор креативов на основе скоринга
- Создание новых кампаний по запросу с фронтенда
- Оптимальное распределение бюджета между креативами

Запуск:

docker compose up -d --build agent-service

Быстрый старт

1. Клонируйте репозиторий

git clone <repo-url>
cd agents-monorepo

2. Настройте окружение

Создайте .env.agent в корне проекта (см. env.brain.example).

3. Примените миграции БД

# В Supabase Dashboard выполните:
migrations/001_scoring_agent_tables.sql
migrations/002_video_creatives_tables.sql

4. Запустите сервисы

docker compose up -d --build

5. Проверьте работу

# agent-brain
curl http://localhost:8081/health

# agent-service
curl http://localhost:8080/health

Документация

Backend

Общий обзор: PROJECT_OVERVIEW_RU.md - Полное описание архитектуры
Campaign Builder Agent: CAMPAIGN_BUILDER_AGENT.md - 🆕 Автоматический запуск рекламы
AmoCRM Воронка продаж: AMOCRM_FUNNEL_ANALYTICS.md - 🆕 Аналитика по этапам воронки
CRM Подписки и биллинг: SUBSCRIPTION_BILLING_CRM.md - Продажи подписок, напоминания, авто-отключение, read-only
Обработка видео: VIDEO_PROCESSING_API.md - Полная документация API
Быстрый старт видео: VIDEO_QUICK_START.md - Краткий гайд
Тестирование создания кампаний: TEST_CREATE_CAMPAIGN.md
Scoring агент: SCORING_QUICK_START.md

Frontend (NEW! 🎉)

⚡ Быстрый старт: QUICK_START_FRONTEND.md - Запуск за 5 минут
📖 Полное руководство: FRONTEND_INTEGRATION_GUIDE.md - Детальная интеграция
📦 Миграция кода: FRONTEND_MIGRATION_STEPS.md - Перенос из GitHub
✅ Тестирование: FRONTEND_TESTING_CHECKLIST.md - Чек-лист проверок

Тестирование

Тест обработки видео

export PAGE_ACCESS_TOKEN='ваш_токен'
./test-video-upload.sh ./path/to/video.mp4

Тест создания кампаний

./test-create-campaign.sh

Тест Campaign Builder Agent (NEW!)

# Автоматический подбор креативов и создание кампании
./test-campaign-builder.sh YOUR_USER_ACCOUNT_ID

Требования

Docker & Docker Compose
Node.js 20+ (для локальной разработки)
FFmpeg (для обработки видео)
PostgreSQL (Supabase)
OpenAI API ключ (для транскрибации)
Facebook API токены

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

agents-monorepo/
├── services/
│   ├── agent-brain/         # Scoring сервис
│   ├── agent-service/       # Основной сервис
│   └── frontend/            # 🆕 Next.js frontend
├── migrations/              # SQL миграции
├── test-*.sh                # Тестовые скрипты
├── nginx.conf               # 🆕 Nginx reverse proxy
└── *.md                     # Документация

Переменные окружения

Основные переменные в .env.agent:

# OpenAI
OPENAI_API_KEY=sk-...

# Facebook
FB_API_VERSION=v20.0
FB_APP_SECRET=...

# Supabase
SUPABASE_URL=https://...
SUPABASE_SERVICE_ROLE=...

# Ports
PORT=8080  # agent-service
PORT=8081  # agent-brain

Разработка

agent-service

cd services/agent-service
npm install
npm run dev

agent-brain

cd services/agent-brain
npm install
npm run dev

Лицензия

Private

social-media-marketing