Environment Variables
These environment variables are set on agent pods when they're deployed as Knative services.
Agent Identity
| Variable | Example | Description |
|---|---|---|
AGENT_NAME | toby | Agent's service name, used for participant lookup and display |
XPRESSAI_NAMESPACE | xpressai | K8s namespace the pod runs in |
XPRESSAI_PROJECT_ID | personal-egonzalez | Database project ID, used for API auth and data isolation |
XPRESSAI_API_TOKEN | a1b2c3d4... | SHA-1(projectId + tokenSecret), used for platform API auth |
XPRESSAI_TOKEN_SECRET | (secret) | Shared secret used for token generation. See Agent API Headers for details on how tokens are computed. |
warning
XPRESSAI_NAMESPACE is the K8s namespace, not the project ID. Don't use it for token validation — the hash won't match. Always use XPRESSAI_PROJECT_ID.
LLM Configuration
| Variable | Value | Description |
|---|---|---|
RELAY_BASE_URL | https://relay.public.cloud.xpress.ai/v1 | OpenAI-compatible LLM relay endpoint |
Integration Credentials
Workspace-level integrations are injected as environment variables. The exact variable names depend on the integration type:
| Integration | Variables |
|---|---|
| Google Workspace | GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN (configured through the Integrations UI) |
| Slack | SLACK_BOT_TOKEN |
| GitHub | GITHUB_TOKEN |
| Atlassian | ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN, ATLASSIAN_DOMAIN (configured through the Integrations UI) |
| SendGrid | SENDGRID_API_KEY |
| Telegram | TELEGRAM_BOT_TOKEN |
| Twilio | TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER (configured through the Integrations UI) |
| AWS | AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION (configured through the Integrations UI) |
| Microsoft | MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID (configured through the Integrations UI) |
note
Most integration credentials are configured through the Integrations page in the project settings UI. The platform injects them as environment variables into agent pods automatically. You do not need to set these manually.
Vector Memory
| Variable | Description |
|---|---|
VECTO_API_KEY | API key for Vecto cloud vector storage (mid-term memory) |