Integrate Observability

[bonk1t]

Observability

Agency Swarm now supports tracking your agents using Langchain callbacks. This allows you to monitor and analyze the behavior and performance of your agents.

To use tracking with Langchain callbacks, you need to install the langchain package:

pip install langchain

Langfuse

Langfuse is an observability platform that allows you to track and analyze the execution of your agents in detail. It provides features like tracing, metrics, and debugging tools.

To use Langfuse with Agency Swarm, follow these steps:

1. Install the langfuse package:

pip install langfuse

2. Set the LANGFUSE_SECRET_KEY and LANGFUSE_PUBLIC_KEY environment variables:

export LANGFUSE_SECRET_KEY=<your-secret-key>
export LANGFUSE_PUBLIC_KEY=<your-public-key>

You can get your keys from the Langfuse dashboard.

3. Initialize the tracking in your code:

from agency_swarm import init_tracking

init_tracking("langfuse")

You can pass additional configuration options to the Langfuse callback handler:

init_tracking(
    "langfuse",
    debug=True,
    host="custom-host",
    user_id="user-123",
)

For additional parameters and more information on the Langfuse callback handler, see the Langfuse documentation.

Local

The local tracker provides a lightweight solution for logging agent activities to a SQLite database.

To use the local tracker, simply initialize it in your code:

from agency_swarm import init_tracking

init_tracking("local")

This will create a SQLite database in the current working directory.

For custom database location:

from agency_swarm import init_tracking

init_tracking("local", db_path="path/to/your/database.db")