Observability SDK for AI Agent Execution — catches hallucinations, silent failures, and missing executions
Project description
AgentWatchX Python SDK
Observability for AI agents. Catches hallucinations, silent failures, and missing executions automatically.
Install
pip install agentwatchx
2-Line Integration
import agentwatchx
agentwatchx.init(api_key="your_api_key")
# That's it. Every OpenAI/Anthropic/LangChain/LlamaIndex call is now traced.
# No decorators, no wrappers, no code changes needed.
What it captures
- Model, input, output, token usage, latency — automatically
- Tool calls made by the LLM (function calling)
- Hallucination detection — agent claims actions it never performed
- Failure masking — tool errors the agent hides from users
- Missing execution — user asks for action, agent just talks
Supported Libraries
| Library | Auto-instrumented |
|---|---|
| OpenAI | ✅ |
| Anthropic | ✅ |
| LangChain | ✅ |
| LlamaIndex | ✅ |
Configuration
agentwatchx.init(
api_key="your_api_key",
endpoint="https://api.agentwatchx.com", # or self-hosted
service="my-agent",
flush_interval=5.0,
batch_size=100,
auto_instrument=True, # set False to disable auto-patching
)
Advanced Usage
# Manual trace decorator
@agentwatchx.trace
def my_agent(query: str):
return client.chat.completions.create(...)
# Manual logging
agentwatchx.log({"service": "my-agent", "input": "hello", "output": "world"})
# Check status
print(agentwatchx.status())
# → {"initialized": True, "instrumented": ["openai"], "buffered_traces": 0}
Links
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
agentwatchx-0.1.0.tar.gz
(12.1 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentwatchx-0.1.0.tar.gz.
File metadata
- Download URL: agentwatchx-0.1.0.tar.gz
- Upload date:
- Size: 12.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a55489795fd3088659f47070a05c5c283f551adc71d5bad47fcd93bc00f22852
|
|
| MD5 |
d33c7c26a9f491f1ee6e0730bfabd2a1
|
|
| BLAKE2b-256 |
22599b708c56f951c75e21db8d04aa8b261deaec52a808f1aad2496c8b3cde9a
|
File details
Details for the file agentwatchx-0.1.0-py3-none-any.whl.
File metadata
- Download URL: agentwatchx-0.1.0-py3-none-any.whl
- Upload date:
- Size: 15.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f6905acd5fbee59d5d36bae85095a4bd5cbb1c382db62ec4a2e4dcdaac028756
|
|
| MD5 |
8284d5132e695934642723ed399571ef
|
|
| BLAKE2b-256 |
158e561112ababd6aa38b37daa500ab8e9412701b60786c6f9a58c04fbf5e717
|