Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
104 changes: 104 additions & 0 deletions python/semantic-kernel/sample-agent/.env.template
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
# =============================================================================
# AI SERVICES CONFIGURATION
# =============================================================================

# Choose LLM provider: set to "true" for Azure OpenAI, "false" for OpenAI
USE_AZURE_OPENAI=true

# --- Azure OpenAI Configuration ---
# Required when USE_AZURE_OPENAI=true
AZURE_OPENAI_DEPLOYMENT_NAME=gpt-4o
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
AZURE_OPENAI_API_KEY=

# --- OpenAI Configuration ---
# Required when USE_AZURE_OPENAI=false
OPENAI_MODEL_ID=gpt-4o
OPENAI_API_KEY=


# =============================================================================
# AUTHENTICATION
# =============================================================================

# Auth handler name — controls authentication mode:
# Empty (default) = Playground mode, no JWT auth
# AGENTIC = Production mode, enables token exchange for Graph, MCP, and observability
AUTH_HANDLER_NAME=AGENTIC

# Use agentic authentication for MCP (optional, defaults to true)
# Set to "false" to use a static bearer token for MCP instead
USE_AGENTIC_AUTH=true

# Bearer token (required for playground/devtunnel modes)
# Used for local development authentication with Agents Playground and dev tunnel
BEARER_TOKEN=

# =============================================================================
# SERVICE CONNECTION
# =============================================================================
# Client credentials used by both the SDK (via load_configuration_from_env) and
# the sample code (for Bot Framework JWT validation in create_auth_configuration).

CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__SCOPES=5a807f24-c9de-44ee-a3a7-329e88a00ffc/.default

# Agent application user authorization settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=https://graph.microsoft.com/.default

# Connections map configuration
CONNECTIONSMAP__0__SERVICEURL=*
CONNECTIONSMAP__0__CONNECTION=SERVICE_CONNECTION

# =============================================================================
# MCP (Model Context Protocol) CONFIGURATION
# =============================================================================

# Environment label (optional, defaults to Production)
# Set to "Development" to allow BEARER_TOKEN for MCP auth
ENVIRONMENT=Development

# MCP Platform Endpoint (optional, defaults to https://agent365.svc.cloud.microsoft)
MCP_PLATFORM_ENDPOINT=

# Skip tooling errors in development (optional, defaults to false)
# When true, agent will fall back to bare LLM mode if MCP tools fail to load
SKIP_TOOLING_ON_ERRORS=true

# =============================================================================
# AGENT IDENTITY
# =============================================================================

# Agent ID (optional, defaults to "semantic-kernel-agent")
# Fallback for MCP server discovery and observability when the activity's
# recipient fields are not populated.
AGENT_ID=

# Environment ID (optional, defaults to prod)
ENVIRONMENT_ID=prod

# =============================================================================
# SERVER
# =============================================================================

# Port to run the server on (optional, defaults to 3978)
PORT=3978

# =============================================================================
# OBSERVABILITY
# =============================================================================

# Enable Agent 365 Observability Exporter (optional, defaults to false)
# Set to "true" to export telemetry to Agent 365 backend for production monitoring
ENABLE_A365_OBSERVABILITY_EXPORTER=false

# Service name for observability (optional)
OBSERVABILITY_SERVICE_NAME=semantic-kernel-sample-agent

# Service namespace for observability (optional)
OBSERVABILITY_SERVICE_NAMESPACE=agent365-samples
Loading
Loading