Skip to main content

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

Project description

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

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

traceagently-0.1.0.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

traceagently-0.1.0-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file traceagently-0.1.0.tar.gz.

File metadata

  • Download URL: traceagently-0.1.0.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for traceagently-0.1.0.tar.gz
Algorithm Hash digest
SHA256 82ddade53fe4276f2d126205c12464c66822fe1c485b075ee2be081065cc81be
MD5 b521a4d3cfe329447bb8725862083341
BLAKE2b-256 cc8354d0cdeb29f0270897d281c9ece1a7d738e91b964b1f6afad33968a5a2f4

See more details on using hashes here.

File details

Details for the file traceagently-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: traceagently-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for traceagently-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b28fb025e308547420d3a387fe4789dc1ce0a2c049503892af3ba020153bba6b
MD5 b425fc0845e3d2128e05a08aeb527345
BLAKE2b-256 63471670884832673027cc197624f56af5d55050227a7545b21d6a18e85bce6e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page