agentkernel 0.2.2__tar.gz → 0.2.4__tar.gz

agentkernel-0.2.2/README.md → agentkernel-0.2.4/PKG-INFO

@@ -1,3 +1,59 @@
+Metadata-Version: 2.3
+Name: agentkernel
+Version: 0.2.4
+Summary: Agent Kernel - Unified AI Agents Runtime
+Author: Yaala Labs
+Author-email: Yaala Labs <agentkernel@yaalalabs.com>
+License: MIT
+Requires-Dist: deprecated>=1.3.1
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pydantic-settings>=2.10.1
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: singleton-type>=0.0.5
+Requires-Dist: redis>=6.4.0
+Requires-Dist: a2a-sdk[http-server]>=0.3.6 ; extra == 'a2a'
+Requires-Dist: google-adk>=1.14.1 ; extra == 'adk'
+Requires-Dist: litellm~=1.74.3 ; extra == 'adk'
+Requires-Dist: openinference-instrumentation-google-adk>=0.1.6 ; extra == 'adk'
+Requires-Dist: fastapi>=0.118.0 ; extra == 'api'
+Requires-Dist: uvicorn>=0.37.0 ; extra == 'api'
+Requires-Dist: gunicorn>=23.0.0 ; extra == 'api'
+Requires-Dist: crewai>=0.150.0 ; extra == 'crewai'
+Requires-Dist: openinference-instrumentation-crewai>=0.1.16 ; extra == 'crewai'
+Requires-Dist: openinference-instrumentation-litellm>=0.1.28 ; extra == 'crewai'
+Requires-Dist: langfuse>=3.9.2 ; extra == 'langfuse'
+Requires-Dist: nest-asyncio>=1.6.0 ; extra == 'langfuse'
+Requires-Dist: langgraph~=0.6.2 ; extra == 'langgraph'
+Requires-Dist: langchain~=0.3.27 ; extra == 'langgraph'
+Requires-Dist: langchain-community~=0.3.27 ; extra == 'langgraph'
+Requires-Dist: litellm~=1.74.3 ; extra == 'langgraph'
+Requires-Dist: fastmcp>=2.12.4 ; extra == 'mcp'
+Requires-Dist: openai-agents>=0.2.3 ; extra == 'openai'
+Requires-Dist: openinference-instrumentation-openai-agents>=1.3.0 ; extra == 'openai'
+Requires-Dist: traceloop-sdk>=0.48.0 ; extra == 'openllmetry'
+Requires-Dist: slack-bolt==1.22.0 ; extra == 'slack'
+Requires-Dist: pytest>=8.4.1 ; extra == 'test'
+Requires-Dist: pytest-asyncio>=1.2.0 ; extra == 'test'
+Requires-Dist: pytest-cov>=6.2.1 ; extra == 'test'
+Requires-Dist: pytest-html>=4.1.1 ; extra == 'test'
+Requires-Dist: pytest-order>=1.3.0 ; extra == 'test'
+Requires-Dist: rapidfuzz>=3.14.1 ; extra == 'test'
+Requires-Python: >=3.12
+Provides-Extra: a2a
+Provides-Extra: adk
+Provides-Extra: api
+Provides-Extra: aws
+Provides-Extra: cli
+Provides-Extra: crewai
+Provides-Extra: langfuse
+Provides-Extra: langgraph
+Provides-Extra: mcp
+Provides-Extra: openai
+Provides-Extra: openllmetry
+Provides-Extra: slack
+Provides-Extra: test
+Description-Content-Type: text/markdown
+
 # Agent Kernel
 
 [![PyPI version](https://badge.fury.io/py/agentkernel.svg)](https://badge.fury.io/py/agentkernel)
@@ -236,7 +292,7 @@ Configure where agent sessions are stored.
 - **Type**: string
 - **Options**: `in_memory`, `redis`
 - **Default**: `in_memory`
-- **Environment Variable**: `AK_SESSION_TYPE`
+- **Environment Variable**: `AK_SESSION__TYPE`
 
 ##### Redis Configuration
 
@@ -246,19 +302,19 @@ Required when `session.type=redis`:
   - **Field**: `session.redis.url`
   - **Default**: `redis://localhost:6379`
   - **Description**: Redis connection URL. Use `rediss://` for SSL
-  - **Environment Variable**: `AK_SESSION_REDIS_URL`
+  - **Environment Variable**: `AK_SESSION__REDIS__URL`
 
 - **TTL (Time to Live)**
   - **Field**: `session.redis.ttl`
   - **Default**: `604800` (7 days)
   - **Description**: Session TTL in seconds
-  - **Environment Variable**: `AK_SESSION_REDIS_TTL`
+  - **Environment Variable**: `AK_SESSION__REDIS__TTL`
 
 - **Key Prefix**
   - **Field**: `session.redis.prefix`
   - **Default**: `ak:sessions:`
   - **Description**: Key prefix for session storage
-  - **Environment Variable**: `AK_SESSION_REDIS_PREFIX`
+  - **Environment Variable**: `AK_SESSION__REDIS__PREFIX`
 
 #### API Configuration
 
@@ -267,71 +323,135 @@ Configure the REST API server (if using the API module).
 - **Host**
   - **Field**: `api.host`
   - **Default**: `0.0.0.0`
-  - **Environment Variable**: `AK_API_HOST`
+  - **Environment Variable**: `AK_API__HOST`
 
 - **Port**
   - **Field**: `api.port`
   - **Default**: `8000`
-  - **Environment Variable**: `AK_API_PORT`
+  - **Environment Variable**: `AK_API__PORT`
 
 - **Custom Router Prefix**
   - **Field**: `api.custom_router_prefix`
   - **Default**: `/custom`
-  - **Environment Variable**: `AK_API_CUSTOM_ROUTER_PREFIX`
+  - **Environment Variable**: `AK_API__CUSTOM_ROUTER_PREFIX`
 
 - **Enabled Routes**
   - **Field**: `api.enabled_routes.agents`
   - **Default**: `true`
   - **Description**: Enable agent interaction routes
-  - **Environment Variable**: `AK_API_ENABLED_ROUTES_AGENTS`
+  - **Environment Variable**: `AK_API__ENABLED_ROUTES__AGENTS`
 
 #### A2A (Agent-to-Agent) Configuration
 
 - **Enabled**
   - **Field**: `a2a.enabled`
   - **Default**: `false`
-  - **Environment Variable**: `AK_A2A_ENABLED`
+  - **Environment Variable**: `AK_A2A__ENABLED`
 
 - **Agents**
   - **Field**: `a2a.agents`
   - **Default**: `["*"]`
   - **Description**: List of agent names to enable A2A (use `["*"]` for all)
-  - **Environment Variable**: `AK_A2A_AGENTS` (comma-separated)
+  - **Environment Variable**: `AK_A2A__AGENTS` (comma-separated)
 
 - **URL**
   - **Field**: `a2a.url`
   - **Default**: `http://localhost:8000/a2a`
-  - **Environment Variable**: `AK_A2A_URL`
+  - **Environment Variable**: `AK_A2A__URL`
 
 - **Task Store Type**
   - **Field**: `a2a.task_store_type`
   - **Options**: `in_memory`, `redis`
   - **Default**: `in_memory`
-  - **Environment Variable**: `AK_A2A_TASK_STORE_TYPE`
+  - **Environment Variable**: `AK_A2A__TASK_STORE_TYPE`
 
 #### MCP (Model Context Protocol) Configuration
 
 - **Enabled**
   - **Field**: `mcp.enabled`
   - **Default**: `false`
-  - **Environment Variable**: `AK_MCP_ENABLED`
+  - **Environment Variable**: `AK_MCP__ENABLED`
 
 - **Expose Agents**
   - **Field**: `mcp.expose_agents`
   - **Default**: `false`
   - **Description**: Expose agents as MCP tools
-  - **Environment Variable**: `AK_MCP_EXPOSE_AGENTS`
+  - **Environment Variable**: `AK_MCP__EXPOSE_AGENTS`
 
 - **Agents**
   - **Field**: `mcp.agents`
   - **Default**: `["*"]`
   - **Description**: List of agent names to expose as MCP tools
-  - **Environment Variable**: `AK_MCP_AGENTS` (comma-separated)
+  - **Environment Variable**: `AK_MCP__AGENTS` (comma-separated)
 
 - **URL**
   - **Field**: `mcp.url`
   - **Default**: `http://localhost:8000/mcp`
-  - **Environment Variable**: `AK_MCP_URL`
+  - **Environment Variable**: `AK_MCP__URL`
+
+#### Trace (Observability) Configuration
+
+Configure tracing and observability for monitoring agent execution.
+
+- **Enabled**
+  - **Field**: `trace.enabled`
+  - **Default**: `false`
+  - **Description**: Enable tracing/observability
+  - **Environment Variable**: `AK_TRACE__ENABLED`
+
+- **Type**
+  - **Field**: `trace.type`
+  - **Options**: `langfuse`, `openllmetry`
+  - **Default**: `langfuse`
+  - **Description**: Type of tracing provider to use
+  - **Environment Variable**: `AK_TRACE__TYPE`
+
+**Langfuse Setup:**
+
+To use Langfuse for tracing, install the langfuse extra:
+
+```bash
+pip install agentkernel[langfuse]
+```
+
+Configure Langfuse credentials via environment variables:
+
+```bash
+export LANGFUSE_PUBLIC_KEY=pk-lf-...
+export LANGFUSE_SECRET_KEY=sk-lf-...
+export LANGFUSE_HOST=https://cloud.langfuse.com  # or your self-hosted instance
+```
+
+Enable tracing in your configuration:
+
+```yaml
+trace:
+  enabled: true
+  type: langfuse
+```
+
+**OpenLLMetry (Traceloop) Setup:**
+
+To use OpenLLMetry for tracing, install the openllmetry extra:
+
+```bash
+pip install agentkernel[openllmetry]
+```
+
+Configure Traceloop credentials via environment variables:
+
+```bash
+export TRACELOOP_API_KEY=your-api-key
+export TRACELOOP_BASE_URL=https://api.traceloop.com  # Optional: for self-hosted
+```
+
+Enable tracing in your configuration:
+
+```yaml
+trace:
+  enabled: true
+  type: openllmetry
+```
 
 ### Configuration Examples
 
@@ -341,14 +461,22 @@ Use the `AK_` prefix and underscores for nested fields:
 
 ```bash
 export AK_DEBUG=true
-export AK_SESSION_TYPE=redis
-export AK_SESSION_REDIS_URL=redis://localhost:6379
-export AK_SESSION_REDIS_TTL=604800
-export AK_SESSION_REDIS_PREFIX=ak:sessions:
-export AK_API_HOST=0.0.0.0
-export AK_API_PORT=8000
-export AK_A2A_ENABLED=true
-export AK_MCP_ENABLED=false
+export AK_SESSION__TYPE=redis
+export AK_SESSION__REDIS__URL=redis://localhost:6379
+export AK_SESSION__REDIS__TTL=604800
+export AK_SESSION__REDIS__PREFIX=ak:sessions:
+export AK_API__HOST=0.0.0.0
+export AK_API__PORT=8000
+export AK_A2A__ENABLED=true
+export AK_MCP__ENABLED=false
+export AK_TRACE__ENABLED=true
+export AK_TRACE__TYPE=langfuse  # or openllmetry
+# For Langfuse:
+# export LANGFUSE_PUBLIC_KEY=pk-lf-...
+# export LANGFUSE_SECRET_KEY=sk-lf-...
+# export LANGFUSE_HOST=https://cloud.langfuse.com
+# For OpenLLMetry:
+# export TRACELOOP_API_KEY=your-api-key
 ```
 
 #### .env File
@@ -357,14 +485,22 @@ Create a `.env` file in your working directory:
 
 ```env
 AK_DEBUG=false
-AK_SESSION_TYPE=redis
-AK_SESSION_REDIS_URL=rediss://my-redis:6379
-AK_SESSION_REDIS_TTL=1209600
-AK_SESSION_REDIS_PREFIX=ak:prod:sessions:
-AK_API_HOST=0.0.0.0
-AK_API_PORT=8080
-AK_A2A_ENABLED=true
-AK_A2A_URL=http://localhost:8080/a2a
+AK_SESSION__TYPE=redis
+AK_SESSION__REDIS__URL=rediss://my-redis:6379
+AK_SESSION__REDIS__TTL=1209600
+AK_SESSION__REDIS__PREFIX=ak:prod:sessions:
+AK_API__HOST=0.0.0.0
+AK_API__PORT=8080
+AK_A2A__ENABLED=true
+AK_A2A__URL=http://localhost:8080/a2a
+AK_TRACE__ENABLED=true
+AK_TRACE__TYPE=langfuse  # or openllmetry
+# Langfuse credentials (if using langfuse):
+# LANGFUSE_PUBLIC_KEY=pk-lf-...
+# LANGFUSE_SECRET_KEY=sk-lf-...
+# LANGFUSE_HOST=https://cloud.langfuse.com
+# OpenLLMetry credentials (if using openllmetry):
+# TRACELOOP_API_KEY=your-api-key
 ```
 
 #### config.yaml
@@ -392,6 +528,9 @@ mcp:
   expose_agents: false
   agents: ["*"]
   url: http://localhost:8000/mcp
+trace:
+  enabled: true
+  type: langfuse
 ```
 
 #### config.json
@@ -425,6 +564,10 @@ mcp:
     "expose_agents": false,
     "agents": ["*"],
     "url": "http://localhost:8000/mcp"
+  },
+  "trace": {
+    "enabled": true,
+    "type": "langfuse"
   }
 }
 ```

agentkernel-0.2.2/PKG-INFO → agentkernel-0.2.4/README.md

@@ -1,46 +1,3 @@
-Metadata-Version: 2.3
-Name: agentkernel
-Version: 0.2.2
-Summary: Agent Kernel - Unified AI Agents Runtime
-Author: Yaala Labs
-Author-email: Yaala Labs <info@yaalalabs.com>
-License: MIT
-Requires-Dist: pydantic>=2.11.7
-Requires-Dist: pydantic-settings>=2.10.1
-Requires-Dist: pyyaml>=6.0.2
-Requires-Dist: redis>=6.4.0
-Requires-Dist: a2a-sdk[http-server]>=0.3.6 ; extra == 'a2a'
-Requires-Dist: google-adk>=1.14.1 ; extra == 'adk'
-Requires-Dist: litellm~=1.74.3 ; extra == 'adk'
-Requires-Dist: fastapi>=0.118.0 ; extra == 'api'
-Requires-Dist: uvicorn>=0.37.0 ; extra == 'api'
-Requires-Dist: gunicorn>=23.0.0 ; extra == 'api'
-Requires-Dist: crewai>=0.150.0 ; extra == 'crewai'
-Requires-Dist: langgraph~=0.6.2 ; extra == 'langgraph'
-Requires-Dist: langchain~=0.3.27 ; extra == 'langgraph'
-Requires-Dist: langchain-community~=0.3.27 ; extra == 'langgraph'
-Requires-Dist: litellm~=1.74.3 ; extra == 'langgraph'
-Requires-Dist: fastmcp>=2.12.4 ; extra == 'mcp'
-Requires-Dist: openai-agents>=0.2.3 ; extra == 'openai'
-Requires-Dist: pytest>=8.4.1 ; extra == 'test'
-Requires-Dist: pytest-asyncio>=1.2.0 ; extra == 'test'
-Requires-Dist: pytest-cov>=6.2.1 ; extra == 'test'
-Requires-Dist: pytest-html>=4.1.1 ; extra == 'test'
-Requires-Dist: pytest-order>=1.3.0 ; extra == 'test'
-Requires-Dist: rapidfuzz>=3.14.1 ; extra == 'test'
-Requires-Python: >=3.12
-Provides-Extra: a2a
-Provides-Extra: adk
-Provides-Extra: api
-Provides-Extra: aws
-Provides-Extra: cli
-Provides-Extra: crewai
-Provides-Extra: langgraph
-Provides-Extra: mcp
-Provides-Extra: openai
-Provides-Extra: test
-Description-Content-Type: text/markdown
-
 # Agent Kernel
 
 [![PyPI version](https://badge.fury.io/py/agentkernel.svg)](https://badge.fury.io/py/agentkernel)
@@ -279,7 +236,7 @@ Configure where agent sessions are stored.
 - **Type**: string
 - **Options**: `in_memory`, `redis`
 - **Default**: `in_memory`
-- **Environment Variable**: `AK_SESSION_TYPE`
+- **Environment Variable**: `AK_SESSION__TYPE`
 
 ##### Redis Configuration
 
@@ -289,19 +246,19 @@ Required when `session.type=redis`:
   - **Field**: `session.redis.url`
   - **Default**: `redis://localhost:6379`
   - **Description**: Redis connection URL. Use `rediss://` for SSL
-  - **Environment Variable**: `AK_SESSION_REDIS_URL`
+  - **Environment Variable**: `AK_SESSION__REDIS__URL`
 
 - **TTL (Time to Live)**
   - **Field**: `session.redis.ttl`
   - **Default**: `604800` (7 days)
   - **Description**: Session TTL in seconds
-  - **Environment Variable**: `AK_SESSION_REDIS_TTL`
+  - **Environment Variable**: `AK_SESSION__REDIS__TTL`
 
 - **Key Prefix**
   - **Field**: `session.redis.prefix`
   - **Default**: `ak:sessions:`
   - **Description**: Key prefix for session storage
-  - **Environment Variable**: `AK_SESSION_REDIS_PREFIX`
+  - **Environment Variable**: `AK_SESSION__REDIS__PREFIX`
 
 #### API Configuration
 
@@ -310,71 +267,135 @@ Configure the REST API server (if using the API module).
 - **Host**
   - **Field**: `api.host`
   - **Default**: `0.0.0.0`
-  - **Environment Variable**: `AK_API_HOST`
+  - **Environment Variable**: `AK_API__HOST`
 
 - **Port**
   - **Field**: `api.port`
   - **Default**: `8000`
-  - **Environment Variable**: `AK_API_PORT`
+  - **Environment Variable**: `AK_API__PORT`
 
 - **Custom Router Prefix**
   - **Field**: `api.custom_router_prefix`
   - **Default**: `/custom`
-  - **Environment Variable**: `AK_API_CUSTOM_ROUTER_PREFIX`
+  - **Environment Variable**: `AK_API__CUSTOM_ROUTER_PREFIX`
 
 - **Enabled Routes**
   - **Field**: `api.enabled_routes.agents`
   - **Default**: `true`
   - **Description**: Enable agent interaction routes
-  - **Environment Variable**: `AK_API_ENABLED_ROUTES_AGENTS`
+  - **Environment Variable**: `AK_API__ENABLED_ROUTES__AGENTS`
 
 #### A2A (Agent-to-Agent) Configuration
 
 - **Enabled**
   - **Field**: `a2a.enabled`
   - **Default**: `false`
-  - **Environment Variable**: `AK_A2A_ENABLED`
+  - **Environment Variable**: `AK_A2A__ENABLED`
 
 - **Agents**
   - **Field**: `a2a.agents`
   - **Default**: `["*"]`
   - **Description**: List of agent names to enable A2A (use `["*"]` for all)
-  - **Environment Variable**: `AK_A2A_AGENTS` (comma-separated)
+  - **Environment Variable**: `AK_A2A__AGENTS` (comma-separated)
 
 - **URL**
   - **Field**: `a2a.url`
   - **Default**: `http://localhost:8000/a2a`
-  - **Environment Variable**: `AK_A2A_URL`
+  - **Environment Variable**: `AK_A2A__URL`
 
 - **Task Store Type**
   - **Field**: `a2a.task_store_type`
   - **Options**: `in_memory`, `redis`
   - **Default**: `in_memory`
-  - **Environment Variable**: `AK_A2A_TASK_STORE_TYPE`
+  - **Environment Variable**: `AK_A2A__TASK_STORE_TYPE`
 
 #### MCP (Model Context Protocol) Configuration
 
 - **Enabled**
   - **Field**: `mcp.enabled`
   - **Default**: `false`
-  - **Environment Variable**: `AK_MCP_ENABLED`
+  - **Environment Variable**: `AK_MCP__ENABLED`
 
 - **Expose Agents**
   - **Field**: `mcp.expose_agents`
   - **Default**: `false`
   - **Description**: Expose agents as MCP tools
-  - **Environment Variable**: `AK_MCP_EXPOSE_AGENTS`
+  - **Environment Variable**: `AK_MCP__EXPOSE_AGENTS`
 
 - **Agents**
   - **Field**: `mcp.agents`
   - **Default**: `["*"]`
   - **Description**: List of agent names to expose as MCP tools
-  - **Environment Variable**: `AK_MCP_AGENTS` (comma-separated)
+  - **Environment Variable**: `AK_MCP__AGENTS` (comma-separated)
 
 - **URL**
   - **Field**: `mcp.url`
   - **Default**: `http://localhost:8000/mcp`
-  - **Environment Variable**: `AK_MCP_URL`
+  - **Environment Variable**: `AK_MCP__URL`
+
+#### Trace (Observability) Configuration
+
+Configure tracing and observability for monitoring agent execution.
+
+- **Enabled**
+  - **Field**: `trace.enabled`
+  - **Default**: `false`
+  - **Description**: Enable tracing/observability
+  - **Environment Variable**: `AK_TRACE__ENABLED`
+
+- **Type**
+  - **Field**: `trace.type`
+  - **Options**: `langfuse`, `openllmetry`
+  - **Default**: `langfuse`
+  - **Description**: Type of tracing provider to use
+  - **Environment Variable**: `AK_TRACE__TYPE`
+
+**Langfuse Setup:**
+
+To use Langfuse for tracing, install the langfuse extra:
+
+```bash
+pip install agentkernel[langfuse]
+```
+
+Configure Langfuse credentials via environment variables:
+
+```bash
+export LANGFUSE_PUBLIC_KEY=pk-lf-...
+export LANGFUSE_SECRET_KEY=sk-lf-...
+export LANGFUSE_HOST=https://cloud.langfuse.com  # or your self-hosted instance
+```
+
+Enable tracing in your configuration:
+
+```yaml
+trace:
+  enabled: true
+  type: langfuse
+```
+
+**OpenLLMetry (Traceloop) Setup:**
+
+To use OpenLLMetry for tracing, install the openllmetry extra:
+
+```bash
+pip install agentkernel[openllmetry]
+```
+
+Configure Traceloop credentials via environment variables:
+
+```bash
+export TRACELOOP_API_KEY=your-api-key
+export TRACELOOP_BASE_URL=https://api.traceloop.com  # Optional: for self-hosted
+```
+
+Enable tracing in your configuration:
+
+```yaml
+trace:
+  enabled: true
+  type: openllmetry
+```
 
 ### Configuration Examples
 
@@ -384,14 +405,22 @@ Use the `AK_` prefix and underscores for nested fields:
 
 ```bash
 export AK_DEBUG=true
-export AK_SESSION_TYPE=redis
-export AK_SESSION_REDIS_URL=redis://localhost:6379
-export AK_SESSION_REDIS_TTL=604800
-export AK_SESSION_REDIS_PREFIX=ak:sessions:
-export AK_API_HOST=0.0.0.0
-export AK_API_PORT=8000
-export AK_A2A_ENABLED=true
-export AK_MCP_ENABLED=false
+export AK_SESSION__TYPE=redis
+export AK_SESSION__REDIS__URL=redis://localhost:6379
+export AK_SESSION__REDIS__TTL=604800
+export AK_SESSION__REDIS__PREFIX=ak:sessions:
+export AK_API__HOST=0.0.0.0
+export AK_API__PORT=8000
+export AK_A2A__ENABLED=true
+export AK_MCP__ENABLED=false
+export AK_TRACE__ENABLED=true
+export AK_TRACE__TYPE=langfuse  # or openllmetry
+# For Langfuse:
+# export LANGFUSE_PUBLIC_KEY=pk-lf-...
+# export LANGFUSE_SECRET_KEY=sk-lf-...
+# export LANGFUSE_HOST=https://cloud.langfuse.com
+# For OpenLLMetry:
+# export TRACELOOP_API_KEY=your-api-key
 ```
 
 #### .env File
@@ -400,14 +429,22 @@ Create a `.env` file in your working directory:
 
 ```env
 AK_DEBUG=false
-AK_SESSION_TYPE=redis
-AK_SESSION_REDIS_URL=rediss://my-redis:6379
-AK_SESSION_REDIS_TTL=1209600
-AK_SESSION_REDIS_PREFIX=ak:prod:sessions:
-AK_API_HOST=0.0.0.0
-AK_API_PORT=8080
-AK_A2A_ENABLED=true
-AK_A2A_URL=http://localhost:8080/a2a
+AK_SESSION__TYPE=redis
+AK_SESSION__REDIS__URL=rediss://my-redis:6379
+AK_SESSION__REDIS__TTL=1209600
+AK_SESSION__REDIS__PREFIX=ak:prod:sessions:
+AK_API__HOST=0.0.0.0
+AK_API__PORT=8080
+AK_A2A__ENABLED=true
+AK_A2A__URL=http://localhost:8080/a2a
+AK_TRACE__ENABLED=true
+AK_TRACE__TYPE=langfuse  # or openllmetry
+# Langfuse credentials (if using langfuse):
+# LANGFUSE_PUBLIC_KEY=pk-lf-...
+# LANGFUSE_SECRET_KEY=sk-lf-...
+# LANGFUSE_HOST=https://cloud.langfuse.com
+# OpenLLMetry credentials (if using openllmetry):
+# TRACELOOP_API_KEY=your-api-key
 ```
 
 #### config.yaml
@@ -435,6 +472,9 @@ mcp:
   expose_agents: false
   agents: ["*"]
   url: http://localhost:8000/mcp
+trace:
+  enabled: true
+  type: langfuse
 ```
 
 #### config.json
@@ -468,6 +508,10 @@ mcp:
     "expose_agents": false,
     "agents": ["*"],
     "url": "http://localhost:8000/mcp"
+  },
+  "trace": {
+    "enabled": true,
+    "type": "langfuse"
   }
 }
 ```