Configuration Items Overview
Configuration items are reusable platform-level objects used to manage shared credentials, connection details, and system configuration values.
They are typically defined in the shared Common application area and reused across different parts of the application.
Typical use cases
Section titled “Typical use cases”Configuration items are commonly used to manage credentials, external connections, and environment-specific settings.
Common examples include:
- AI model connections
- Database connections
- API credentials
- Email server settings
- External service integrations
- Shared application configuration values
The Lowgile platform includes configuration items such as:
AiConnectionClaudeConnectionDbConnectionSmsGatewayApiKey
Why configuration items matter
Section titled “Why configuration items matter”Using configuration items provides several advantages:
- Reusability: The same configuration can be shared across multiple parts of the application.
- Security: Sensitive values such as API keys and credentials can be managed centrally instead of being embedded in code.
- Maintainability: Updating a configuration item automatically updates all dependent application behaviour.
- Environment management: Different environments, such as development, testing, and production, can use different configuration values without changing application logic.
Note
Configuration items are platform-level shared objects. They are different from user-defined configurations created inside application modules.
How configuration items are used
Section titled “How configuration items are used”AI integrations and application services can reference configuration items to obtain connection details and runtime settings.
For example, an AI integration may reference an AiConnection configuration item to obtain:
- The AI provider to connect to (such as Azure OpenAI or Anthropic),
- Model or deployment names,
- API credentials and authentication settings, and
- Tracing or monitoring configuration.