buyer-agent/.env.example at main · IABTechLab/buyer-agent · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# Anthropic API Key (required for CrewAI agents)
ANTHROPIC_API_KEY=your-anthropic-api-key-here

# IAB agentic-direct Server (default: IAB hosted server)
IAB_SERVER_URL=https://agentic-direct-server-hwgrypmndq-uk.a.run.app

# OpenDirect API Configuration (optional: use local mock server for testing)
OPENDIRECT_BASE_URL=http://localhost:3000
OPENDIRECT_TOKEN=
OPENDIRECT_API_KEY=

# LLM Settings
DEFAULT_LLM_MODEL=anthropic/claude-sonnet-4-5-20250929
MANAGER_LLM_MODEL=anthropic/claude-sonnet-4-5-20250929
LLM_TEMPERATURE=0.3
LLM_MAX_TOKENS=4096

# Storage Configuration
# STORAGE_TYPE: sqlite (default/local), redis, hybrid (postgres+redis)
STORAGE_TYPE=sqlite

# SQLite (default for local/test)
DATABASE_URL=sqlite:///./ad_buyer.db

# Redis (for production caching, sessions, pub/sub)
# Install: pip install ad-buyer-system[redis]
REDIS_URL=
# REDIS_URL=redis://localhost:6379/0

# PostgreSQL (for production durable storage)
# Install: pip install ad-buyer-system[postgres]
# DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/ad_buyer
POSTGRES_POOL_MIN=2
POSTGRES_POOL_MAX=10

# Hybrid mode (recommended for production):
#   STORAGE_TYPE=hybrid
#   DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/ad_buyer
#   REDIS_URL=redis://localhost:6379/0
# Routes durable data (deals, campaigns, orders) to Postgres
# and ephemeral data (sessions, caches, locks) to Redis

# Mixpeek Contextual Enrichment (optional: enables classify_content and contextual_search tools)
MIXPEEK_API_KEY=
MIXPEEK_BASE_URL=https://api.mixpeek.com
MIXPEEK_NAMESPACE=

# Environment
ENVIRONMENT=development
LOG_LEVEL=INFO

# CrewAI
CREW_MEMORY_ENABLED=true

# =============================================================================
# Meta Ads API Integration
# =============================================================================
# System user access token — generate in Meta Business Manager:
#   Business Settings → System Users → <your system user> → Generate Token
#   Required scopes: ads_management, ads_read, business_management
META_ACCESS_TOKEN=

# Ad account ID — assign system user to ad account first:
#   Business Settings → System Users → Add Assets → Ad Accounts
#   Format: act_XXXXXXXXX
META_AD_ACCOUNT_ID=

# Facebook Page ID — Business Manager → Pages → click page → copy ID from URL
META_PAGE_ID=

# Graph API version (for reach estimates)
META_API_VERSION=v21.0

# IAB Diligence Platform Integration (via SafeGuard Privacy)
# optional; inert when SGP_API_KEY is empty
SGP_API_KEY=
# Staging Environment: https://api.safeguardprivacy-demo.com
SGP_BASE_URL=https://api.safeguardprivacy.com
SGP_ENFORCE=false
# block | warn | allow
SGP_UNKNOWN_VENDOR_POLICY=block
SGP_CACHE_TTL_SECONDS=900