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