Retail-Agentic-Commerce/env.example at main · NVIDIA-AI-Blueprints/Retail-Agentic-Commerce · 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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# Agentic Commerce Middleware Configuration
# Copy this file to .env and fill in your values

# Application Settings
DEBUG=true

# =============================================================================
# NAT Agent Configuration (NVIDIA NeMo Agent Toolkit)
# Only needed for running NAT agents (Promotion, Post-Purchase, Recommendation)
# =============================================================================

# NVIDIA API Key for LLM calls (required for public endpoints)
NVIDIA_API_KEY=nvapi-xxx

# =============================================================================
# NIM Deployment Configuration
# Toggle between public NVIDIA endpoints and local NIM containers
# =============================================================================

# LLM Configuration (Nemotron)
# Public endpoint (default): https://integrate.api.nvidia.com/v1
# Local NIM example: http://nemotron:8000/v1 (internal) or http://localhost:8010/v1 (external)
NIM_LLM_BASE_URL=https://integrate.api.nvidia.com/v1

# LLM Model Name
# Public endpoint: nvidia/nemotron-3-nano-30b-a3b
# Local NIM: nvidia/nemotron-3-nano
NIM_LLM_MODEL_NAME=nvidia/nemotron-3-nano-30b-a3b

# Embedding Configuration (NV-EmbedQA)
# Public endpoint (default): https://integrate.api.nvidia.com/v1
# Local NIM example: http://embedqa:8000/v1 (internal) or http://localhost:8011/v1 (external)
NIM_EMBED_BASE_URL=https://integrate.api.nvidia.com/v1

# Embedding Model Name (same for both public and local)
NIM_EMBED_MODEL_NAME=nvidia/nv-embedqa-e5-v5

# =============================================================================
# Merchant API Configuration
# =============================================================================

# Merchant API authentication key (clients use this to call merchant endpoints)
MERCHANT_API_KEY=merchant-api-key-12345

# Webhook Configuration (Merchant → Client Agent per ACP spec)
WEBHOOK_URL=http://localhost:3000/api/webhooks/acp
# Docker deployment webhook URL (container-to-container routing)
WEBHOOK_URL_DOCKER=http://ui:3000/api/webhooks/acp
UCP_ORDER_WEBHOOK_URL=http://localhost:3000/api/webhooks/ucp
UCP_ORDER_WEBHOOK_URL_DOCKER=http://ui:3000/api/webhooks/ucp
WEBHOOK_SECRET=whsec_demo_secret

# UCP Discovery Configuration
UCP_VERSION=2026-01-23
UCP_BASE_URL=
UCP_SERVICE_PATH=/ucp/v1
UCP_BUSINESS_NAME=
UCP_SIGNING_KEY_ID=ucp-key-1
UCP_SIGNING_KEY_KTY=EC
UCP_SIGNING_KEY_CRV=P-256
UCP_SIGNING_KEY_ALG=ES256
UCP_SIGNING_KEY_X=
UCP_SIGNING_KEY_Y=

# =============================================================================
# PSP (Payment Service Provider) Configuration
# =============================================================================

# PSP API authentication key
PSP_API_KEY=psp-api-key-12345

# Promotion Agent Configuration
PROMOTION_AGENT_URL=http://localhost:8002
PROMOTION_AGENT_TIMEOUT=10.0

# Post-Purchase Agent Configuration
POST_PURCHASE_AGENT_URL=http://localhost:8003
POST_PURCHASE_AGENT_TIMEOUT=15.0

# Recommendation Agent Configuration
RECOMMENDATION_AGENT_URL=http://localhost:8004
RECOMMENDATION_AGENT_TIMEOUT=15.0

# Search Agent Configuration
SEARCH_AGENT_URL=http://localhost:8005
# Maximum L2 distance allowed in Milvus range search
SEARCH_DISTANCE_CUTOFF=1.4
# Minimum similarity threshold for search results (0.0-1.0)
SEARCH_MIN_SIMILARITY=0.35

# Phoenix Observability (for Recommendation Agent tracing)
# Start Phoenix: docker compose up -d
# View traces: http://localhost:6006
PHOENIX_ENDPOINT=http://localhost:6006/v1/traces

# Milvus Vector Database (for Recommendation Agent)
MILVUS_URI=http://localhost:19530

# =============================================================================
# UI Server-Side Configuration (for Next.js API proxy routes)
# =============================================================================

# Backend service URLs (used by UI proxy routes)
# These are only used server-side and never exposed to the browser
MERCHANT_API_URL=http://localhost:8000
PSP_API_URL=http://localhost:8001

# Note: MERCHANT_API_KEY and PSP_API_KEY already exist above
# They are used by both the backend services AND the UI proxy routes

# UI client-side UCP profile (used by UCP-Agent header in A2A requests)
# Local dev example: http://localhost:8000/.well-known/ucp
# Docker example (ui + merchant containers): http://merchant:8000/.well-known/ucp
NEXT_PUBLIC_UCP_PLATFORM_PROFILE_URL=http://localhost:8000/.well-known/ucp