Enterprise Variables
Overview
Enterprise Variables provide access to shared configuration values managed centrally in the AI Command Center.
Unlike Model Data, which is created and maintained within a workflow, Enterprise Variables are defined once and can be reused across multiple agents and workflows within the same tenant.
Enterprise Variables are available through the Process Data Explorer and can be bound wherever data binding is supported.
What are Enterprise Variables?
Enterprise Variables are intended for values that should be managed centrally rather than defined within individual workflows.
Typical uses include:
- Application configuration
- Environment-specific URLs
- Feature flags
- Business constants
- Thresholds and limits
- API keys
- Access tokens
- Passwords
- Other shared configuration values
Because they are centrally managed, changes automatically become available to workflows that reference them.
Enterprise Variable Scope
Each Enterprise Variable is created with one of the following scopes.
| Scope | Description |
|---|---|
| Global | Available to all users and all workflows within the tenant. |
| User | Available only to the user who owns the variable. |
This allows organizations to maintain both organization-wide configuration and user-specific values.
Encrypted Variables
Enterprise Variables can optionally be stored in encrypted form.
Encrypted variables are commonly used for sensitive information such as:
- Passwords
- API Keys
- OAuth Tokens
- Client Secrets
- Connection Credentials
When a workflow accesses an encrypted Enterprise Variable, the value is securely resolved during execution without exposing the stored value within the designer.
Using Enterprise Variables
Enterprise Variables can be referenced anywhere the Process Data Explorer is available.
Typical uses include:
- Configuring workflow activities.
- Building expressions.
- Evaluating conditions.
- Configuring integrations.
- Populating email templates.
- Supplying configuration values to AI and integration activities.
Enterprise Variables are read-only within the Agent Designer.
They can be created, modified, or deleted only from the AI Command Center.
Runtime Behavior
Enterprise Variables are resolved during workflow execution.
The platform automatically:
- Applies Global or User scope.
- Resolves encrypted values securely.
- Enforces data type compatibility.
- Returns the current value stored in the AI Command Center.
Any changes made in the AI Command Center are automatically reflected the next time a workflow executes.
Enterprise Variables and Model Data
Although both are available through the Process Data Explorer, they serve different purposes.
| Data | Purpose |
|---|---|
| Enterprise Variables | Shared configuration managed centrally in the AI Command Center. |
| Model Data | Business data and workflow state maintained during workflow execution. |
Enterprise Variables should be treated as read-only configuration.
Model Data should be used for values that change as the workflow executes.
Best Practices
- Use Global Enterprise Variables for organization-wide configuration.
- Use User Enterprise Variables for user-specific settings.
- Encrypt all sensitive values such as passwords, API keys, and tokens.
- Use descriptive names that clearly communicate the purpose of each variable.
- Avoid storing workflow-specific or temporary data as Enterprise Variables.