Skip to main content

CrewAI integration for Agent Observability - multi-agent logging, cost tracking, and compliance

Project description

Agent Observability for CrewAI

PyPI version Python 3.10+ License: MIT

Multi-agent observability for CrewAI — track costs, tasks, and delegations across your crew.

Installation

pip install agent-observability-crewai

With CrewAI dependencies:

pip install agent-observability-crewai[crewai]

Quick Start

1. Get API Key

curl -X POST https://api-production-0c55.up.railway.app/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-crew"}'

2. Set Environment Variable

export AGENT_OBS_API_KEY=ao_live_your_key_here

3. Add to Your Crew

from crewai import Agent, Task, Crew
from agent_observability_crewai import AgentObservabilityTool

# Create tool for each agent
obs_tool = AgentObservabilityTool(crew_id="research-crew")

researcher = Agent(
    role="Researcher",
    goal="Find accurate information",
    tools=[obs_tool],
    verbose=True
)

writer = Agent(
    role="Writer",
    goal="Create compelling content",
    tools=[AgentObservabilityTool(crew_id="research-crew", agent_role="writer")],
    verbose=True
)

# Create and run crew
crew = Crew(
    agents=[researcher, writer],
    tasks=[...]
)

result = crew.kickoff()

Automatic Callback (Alternative)

For fully automatic logging without giving agents the tool:

from crewai import Crew
from agent_observability_crewai import ObservabilityCallback

callback = ObservabilityCallback(crew_id="my-crew")

crew = Crew(
    agents=[...],
    tasks=[...],
    callbacks=[callback]  # Logs automatically
)

What Gets Tracked

Event Description
task_started When a task begins
task_complete Task finished with duration
delegation Task delegated between agents
tool_use Agent uses a tool
api_call External API calls
error Errors and failures

CrewAI-Specific Features

Per-Agent Cost Tracking

# Each agent logs with their role
obs = AgentObservabilityTool(
    crew_id="sales-crew",
    agent_role="lead-qualifier"
)

# Query later: "Show me costs for lead-qualifier role"

Task Delegation Logging

obs_tool.log_delegation(
    from_agent="Manager",
    to_agent="Researcher",
    task="Find competitor pricing",
    reason="Requires web search expertise"
)

Task Completion with Metrics

obs_tool.log_task_complete(
    task_description="Research competitors",
    output="Found 5 competitors...",
    cost_usd=0.15,
    duration_ms=45000
)

Pricing

Tier Logs/Month Price
Free 100,000 $0
Starter 1,000,000 $29/month
Professional 10,000,000 $199/month

Why Use This for CrewAI?

Multi-agent systems need observability more than single agents:

  • Which agent costs the most? Track per-role spending
  • Where are bottlenecks? See task durations per agent
  • Delegation chains Audit who delegated what to whom
  • Debug failures Trace errors back through agent interactions

Related Packages

License

MIT License — see LICENSE for details.

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

agent_observability_crewai-1.2.0.tar.gz (7.9 kB view details)

Uploaded Source

Built Distribution

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

agent_observability_crewai-1.2.0-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

Details for the file agent_observability_crewai-1.2.0.tar.gz.

File metadata

File hashes

Hashes for agent_observability_crewai-1.2.0.tar.gz
Algorithm Hash digest
SHA256 bf7e1aa80cc7dcf85525f274c91bbbc367d47acdb245ab5a98b74bb29871b5c3
MD5 f06b84d20d1436a5b8a7df69de3ade26
BLAKE2b-256 3f2622f702d395533e6da71c8bd912c3ac240c45848119b241cc1902f38d760d

See more details on using hashes here.

File details

Details for the file agent_observability_crewai-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_observability_crewai-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6413c67325be87938850a1f687cb288339e9dbc1e1cc03e3a62d35e21433e38a
MD5 b17fe523656044255e5495a7f18a975d
BLAKE2b-256 d2b40619ba26aa1cc063df4118599add9de7f727944d5e38b2665fd086368ca4

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