Skip to main content

​
Agent-TS Configuration

Agent-TS is configured through environment variables. Copy .env.example to .env and configure the required values.

​
Environment Variables

​
Required Variables

VariableDescriptionExample
OPENAI_API_KEYOpenAI API key for GPT and Visionsk-...
GATEWAY_API_KEYOLIVE Gateway API keyolive_live_xxx...
WHATSAPP_VERIFY_TOKENWebhook verification tokenyour-verify-token

​
Optional Variables

VariableDescriptionDefault
PORTServer port8000
OPENAI_MODELOpenAI model to usegpt-4o-mini
OPENAI_ASSISTANT_IDExisting assistant IDAuto-created
GATEWAY_URLGateway URLhttp://gateway:8080
LOG_LEVELLogging levelinfo

​
AWS S3 Configuration

Required for KYC document storage:
VariableDescriptionExample
AWS_ACCESS_KEY_IDAWS access keyAKIA...
AWS_SECRET_ACCESS_KEYAWS secret key...
AWS_S3_BUCKET_NAMES3 bucket for KYC docsolive-kyc-documents
AWS_REGIONAWS regionus-east-1

​
Example Configuration

# Server
PORT=8000
LOG_LEVEL=info

# OpenAI
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o-mini
# Leave empty to auto-create, or set existing ID
OPENAI_ASSISTANT_ID=

# OLIVE Gateway
GATEWAY_URL=http://gateway:8080
GATEWAY_API_KEY=olive_live_xxxxxxxxxxxxxxxx

# WhatsApp
WHATSAPP_VERIFY_TOKEN=your-secure-verify-token

# AWS S3 (for KYC documents)
AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_S3_BUCKET_NAME=olive-kyc-documents
AWS_REGION=us-east-1

​
Configuration by Environment

PORT=8000
LOG_LEVEL=debug
GATEWAY_URL=http://localhost:8080

​
OpenAI Configuration

​
Model Selection

The agent supports various OpenAI models:
ModelUse CaseCost
gpt-4o-miniDefault, fast responsesLow
gpt-4oComplex reasoningMedium
gpt-4-turboHigh accuracyHigh

​
Assistant Management

On first run, the agent creates an OpenAI Assistant with the configured tools. The assistant ID is logged and can be set in OPENAI_ASSISTANT_ID for subsequent runs to reuse the same assistant. 
# First run - creates new assistant
npm run dev
# Logs: Created assistant: asst_xxxxxxxxxxxxx

# Subsequent runs - set the ID to reuse
OPENAI_ASSISTANT_ID=asst_xxxxxxxxxxxxx npm run dev

​
S3 Bucket Configuration

​
Bucket Policy

The S3 bucket should be private with appropriate IAM permissions: 
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject"
      ],
      "Resource": "arn:aws:s3:::olive-kyc-documents/*"
    }
  ]
}

​
CORS Configuration

For pre-signed URL access: 
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT"],
    "AllowedOrigins": ["https://admin.olive.example.com"],
    "ExposeHeaders": [],
    "MaxAgeSeconds": 3000
  }
]

​
Rate Limiting

Default rate limits (configurable in rate-limiter.ts):
LimitValue
Requests per minute (per phone)30
Concurrent conversations100
Image uploads per hour10

​
Troubleshooting

​
Common Issues

  • Verify OPENAI_API_KEY is valid
  • Check API quota and billing
  • Ensure network access to OpenAI endpoints
  • Verify GATEWAY_URL is reachable
  • Check GATEWAY_API_KEY is valid
  • Ensure gateway service is running
  • Verify AWS credentials are correct
  • Check bucket exists and is accessible
  • Ensure IAM permissions are configured
  • Ensure WHATSAPP_VERIFY_TOKEN matches Meta configuration
  • Check endpoint is publicly accessible (HTTPS)
  • Verify URL in Meta Developer Console

​
Next Steps

Tools Reference

Available tool definitions

Webhooks

WhatsApp integration setup