Skip to main content

traceagently

Real-time observability for AI agents. See every thought, tool call, and error — live.

Install

pip install traceagently

Quick Start

from traceagently import TraceAgently

ta = TraceAgently(api_key="ta_live_...")

with ta.trace(agent_id="support-bot", task="Refund user #123") as trace:
    trace.thought("I need to check the order database")
    trace.tool_call("check_order", {"user_id": 123})
    trace.tool_result({"status": "delivered"})
    trace.final_response("Cannot refund a delivered order")

Traces appear live at app.traceagently.com.

Event Types

Method Description
trace.thought(content) A reasoning step
trace.tool_call(name, args) Tool invocation
trace.tool_result(result) Tool result
trace.error(message) An error
trace.final_response(content) Final answer — also ends the trace

The context manager automatically:

  • Marks the trace completed on clean exit
  • Captures the exception and marks the trace failed on error

Works with any framework

# LangChain callback
# CrewAI hook
# Raw OpenAI loop
# Any agent you wrote yourself

API Keys

Get your API key at app.traceagently.com/dashboard/keys.

Links

Metadata

Release files for traceagently 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for traceagently 0.1.0
File Size Uploaded
traceagently-0.1.0.tar.gz 3.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for traceagently 0.1.0
File Interpreter ABI Platform
traceagently-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 7.4 kB

Release files / traceagently-0.1.0.tar.gz

Download URL traceagently-0.1.0.tar.gz
Size 3.4 kB
Tags Source
SHA-256 checksum
How to use checksums
82ddade53fe4276f2d126205c12464c66822fe1c485b075ee2be081065cc81be
BLAKE2b-256 checksum
How to use checksums
cc8354d0cdeb29f0270897d281c9ece1a7d738e91b964b1f6afad33968a5a2f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / traceagently-0.1.0-py3-none-any.whl

Download URL traceagently-0.1.0-py3-none-any.whl
Size 4.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b28fb025e308547420d3a387fe4789dc1ce0a2c049503892af3ba020153bba6b
BLAKE2b-256 checksum
How to use checksums
63471670884832673027cc197624f56af5d55050227a7545b21d6a18e85bce6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page