Python SDK Overview

Installation

pip install agentx-python

Requires Python 3.9+. Framework extras pull in only what each integration needs, e.g. pip install "agentx-python[langchain]" - see Framework Integrations.

Initialization

from agentx import AgentX

# From environment: AGENTX_API_KEY (+ AGENTX_API_BASE_URL for self-host)
client = AgentX.from_env()

# Explicit
client = AgentX(
    api_key="agtx_local_...",
    base_url="http://localhost:4700/api/v1",   # your self-host engine
)

The key comes from the engine’s startup log or Settings → API access - see Authentication. Construction is lazy (no network call), and tracing is fire-and-forget - a wrong URL or key surfaces as a one-time log warning, not an exception. To fail fast instead, verify once at startup:

client.ping()
# AgentXConnectionError: Cannot reach AgentX at http://fake-url.com/api/v1 (...)
# AgentXAuthError: AgentX at ... rejected the API key (HTTP 401). Check api_key / AGENTX_API_KEY ...

The client at a glance

Module	What it does	Guide
`client.tracer`	Record traces: decorator, context manager, sessions, tool calls, span trees	Tracing
`agentx.integrations.*`	One-line capture for LangChain/LangGraph, OpenAI Agents, CrewAI, AutoGen, ADK, LlamaIndex, Databricks/MLflow, Moveworks, and raw OpenAI/Anthropic clients	Integrations
`client.evaluations`	Datasets, evaluator configs, runs: `run(...).execute(fn).finalize()`	Evaluations
`client.evaluations.prompts`	The prompt registry: pull versioned prompts at runtime	Prompt Management
`client.monitor`	Patterns, online evaluators, and per-agent profiles from code	Monitor
`client.outcomes` / `client.feedback`	Report real-world outcomes and end-user votes for judge calibration	Outcomes
`report.gate()` / `run_eval()`	CI pass/fail gates with rating floors and no-regression checks	CI/CD
CLI: `agentx-moveworks`, `agentx-databricks`	Pull importers replaying external platforms’ activity as traces	Moveworks · Databricks

Guides

Tracing

Record agent runs - spans, sessions, tool calls

Evaluations

Score any agent against a dataset in one script

Monitor

Continuous detection on production traffic

CI/CD

Gate releases on measured quality

Get Started

Self-Hosting

Python SDK

Python SDK Overview

Installation

Initialization

The client at a glance

Guides

Tracing

Evaluations

Monitor

CI/CD

​Installation

​Initialization

​The client at a glance

​Guides

Tracing

Evaluations

Monitor

CI/CD

Installation

Initialization

The client at a glance

Guides