Table of Contents

App Configuration Values

FoundationaLLM uses Azure App Configuration as the central store for configuration values, Key Vault secret references, and feature flags.

Overview

Benefits of centralized configuration:

  • Single source of truth for all services
  • No redeployment required for configuration changes
  • Key Vault integration for secrets
  • Shared settings across multiple services

Configuration Categories

Instance Configuration

Key Default Description
FoundationaLLM:Instance:Id Generated GUID Unique instance identifier
FoundationaLLM:Configuration:KeyVaultURI (Required) Key Vault URL for secrets

API Endpoints

Key Description
FoundationaLLM:APIs:CoreAPI:APIUrl Core API base URL
FoundationaLLM:APIs:ManagementAPI:APIUrl Management API base URL
FoundationaLLM:APIs:OrchestrationAPI:APIUrl Orchestration API URL
FoundationaLLM:APIs:LangChainAPI:APIUrl LangChain API URL
FoundationaLLM:APIs:SemanticKernelAPI:APIUrl Semantic Kernel API URL

API Keys (Key Vault References)

Key Key Vault Secret
FoundationaLLM:APIs:OrchestrationAPI:APIKey foundationallm-apis-orchestrationapi-apikey
FoundationaLLM:APIs:LangChainAPI:APIKey foundationallm-apis-langchainapi-apikey
FoundationaLLM:APIs:SemanticKernelAPI:APIKey foundationallm-apis-semantickernelapi-apikey

Completion shielding

Core runs shielding in process. Select plugins on each agent with shielding_settings. FoundationaLLM:APIEndpoints:CoreAPI:Configuration:BypassGatekeeper is unused, and new deployments do not create a Gatekeeper API endpoint.

Key prefix Description
FoundationaLLM:APIEndpoints:AzureContentSafety Azure Content Safety endpoint used by the shielding plugin
FoundationaLLM:APIEndpoints:LakeraGuard Lakera Guard endpoint used by the shielding plugin
FoundationaLLM:APIEndpoints:EnkryptGuardrails Enkrypt Guardrails endpoint used by the shielding plugin

Azure OpenAI Configuration

Key Default Description
FoundationaLLM:AzureOpenAI:API:Endpoint (Required) Azure OpenAI endpoint
FoundationaLLM:AzureOpenAI:API:Version 2023-05-15 API version
FoundationaLLM:AzureOpenAI:API:Completions:DeploymentName completions Completion model deployment
FoundationaLLM:AzureOpenAI:API:Completions:ModelName gpt-35-turbo Model name
FoundationaLLM:AzureOpenAI:API:Completions:MaxTokens 8096 Max tokens
FoundationaLLM:AzureOpenAI:API:Completions:Temperature 0 Temperature
FoundationaLLM:AzureOpenAI:API:Embeddings:DeploymentName embeddings Embedding deployment
FoundationaLLM:AzureOpenAI:API:Embeddings:ModelName text-embedding-ada-002 Embedding model

Branding Configuration

Key Default Description
FoundationaLLM:Branding:CompanyName FoundationaLLM Organization name
FoundationaLLM:Branding:PageTitle FoundationaLLM Chat Copilot Browser title
FoundationaLLM:Branding:LogoUrl foundationallm-logo-white.svg Logo path
FoundationaLLM:Branding:FavIconUrl favicon.ico Favicon path
FoundationaLLM:Branding:PrimaryColor #131833 Primary color
FoundationaLLM:Branding:PrimaryTextColor #fff Primary text color
FoundationaLLM:Branding:SecondaryColor #334581 Secondary color
FoundationaLLM:Branding:BackgroundColor #fff Background color
FoundationaLLM:Branding:KioskMode false Enable kiosk mode

Entra ID Authentication

Core API / Chat Portal

Key Description
FoundationaLLM:CoreAPI:Entra:Instance Entra login URL
FoundationaLLM:CoreAPI:Entra:TenantId Tenant ID
FoundationaLLM:CoreAPI:Entra:ClientId Client ID
FoundationaLLM:CoreAPI:Entra:Scopes API scopes
FoundationaLLM:CoreAPI:Entra:CallbackPath /signin-oidc

Management API / Portal

Key Description
FoundationaLLM:ManagementAPI:Entra:Instance Entra login URL
FoundationaLLM:ManagementAPI:Entra:TenantId Tenant ID
FoundationaLLM:ManagementAPI:Entra:ClientId Client ID
FoundationaLLM:ManagementAPI:Entra:Scopes API scopes

CosmosDB Configuration

Key Default Description
FoundationaLLM:CosmosDB:Endpoint (Required) CosmosDB endpoint
FoundationaLLM:CosmosDB:Database database Database name
FoundationaLLM:CosmosDB:Containers Sessions, UserSessions Container list
FoundationaLLM:CosmosDB:ChangeFeedLeaseContainer leases Change feed container

Storage Configuration

Key Description
FoundationaLLM:AgentHub:AgentMetadata:StorageContainer Agent metadata container
FoundationaLLM:PromptHub:PromptMetadata:StorageContainer Prompt metadata container
FoundationaLLM:DataSourceHub:DataSourceMetadata:StorageContainer Data source container
FoundationaLLM:BlobStorageMemorySource:BlobStorageContainer Memory source container

Vectorization Configuration

Key Description
FoundationaLLM:APIs:VectorizationAPI:APIUrl Vectorization API URL
FoundationaLLM:Vectorization:AzureAISearchIndexingService:Endpoint AI Search endpoint
FoundationaLLM:Vectorization:SemanticKernelTextEmbeddingService:Endpoint Embedding endpoint
FoundationaLLM:Vectorization:SemanticKernelTextEmbeddingService:DeploymentName embeddings

Event Grid Configuration

Key Description
FoundationaLLM:Events:AzureEventGridEventService:Endpoint Event Grid endpoint
FoundationaLLM:Events:AzureEventGridEventService:NamespaceId Event Grid namespace
FoundationaLLM:Events:AzureEventGridEventService:AuthenticationType APIKey

Key Vault Secret References

Many App Configuration values reference Key Vault secrets. The format is:

{
  "uri": "https://{keyvault-name}.vault.azure.net/secrets/{secret-name}"
}

Common secret references:

App Config Key Key Vault Secret
FoundationaLLM:AzureOpenAI:API:Key foundationallm-azureopenai-api-key
FoundationaLLM:CoreAPI:Entra:ClientSecret foundationallm-coreapi-entra-clientsecret
FoundationaLLM:ManagementAPI:Entra:ClientSecret foundationallm-managementapi-entra-clientsecret

Modifying Configuration

Via Azure Portal

  1. Navigate to your App Configuration resource
  2. Select Configuration explorer
  3. Find and edit the key
  4. Save changes

Via Azure CLI

az appconfig kv set \
  --name <app-config-name> \
  --key "FoundationaLLM:Branding:CompanyName" \
  --value "My Company"

Via Management Portal

Some settings (like branding) can be modified through the Management Portal UI.