# Agent Observability for AutoGPT

[![PyPI version](https://badge.fury.io/py/agent-observability-autogpt.svg)](https://pypi.org/project/agent-observability-autogpt/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

AutoGPT plugin for structured logging, cost tracking, and compliance audit trails.

## Installation

```bash
pip install agent-observability-autogpt
```

## Setup

### 1. Get Your Free API Key

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

### 2. Set Environment Variable

```bash
export AGENT_OBS_API_KEY=ao_live_your_key_here
```

### 3. Enable in AutoGPT

Add to your AutoGPT plugins configuration:

```
agent-observability-autogpt
```

## What Gets Logged Automatically

| Event | When | Data |
|-------|------|------|
| `task_started` | New instruction received | instruction preview |
| `command_executed` | After each command | command name, arguments |
| `agent_response` | Agent generates response | response length, preview |
| `planning` | Planning phase starts | prompt length, message count |

## Manual Logging

Your AutoGPT agent can also log custom events:

```python
from agent_observability_autogpt import AgentObservabilityPlugin

plugin = AgentObservabilityPlugin()

# Log an API call with cost
plugin.log_event(
    event_type="api_call",
    metadata={
        "provider": "openai",
        "model": "gpt-4",
        "cost_usd": 0.03,
        "latency_ms": 1200
    }
)

# Log a decision
plugin.log_event(
    event_type="decision",
    metadata={
        "decision": "use_web_search",
        "reason": "need current information"
    }
)

# Get task summary
summary = plugin.get_task_summary()
print(f"Task cost so far: ${summary['total_cost_usd']}")
print(f"Commands executed: {summary['commands_executed']}")
```

## Features

- **Automatic Logging**: All commands and responses logged automatically
- **Cost Tracking**: Track spending per task
- **Task Metrics**: Elapsed time, command count, cumulative costs
- **Compliance Ready**: SOC 2, GDPR audit trail requirements
- **Zero Configuration**: Just set the API key

## Pricing

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

## Related Packages

- **[agent-observability](https://pypi.org/project/agent-observability/)** — Core Python SDK
- **[agent-observability-langchain](https://pypi.org/project/agent-observability-langchain/)** — LangChain integration
- **[agent-observability-crewai](https://pypi.org/project/agent-observability-crewai/)** — CrewAI integration

## License

MIT License — see [LICENSE](LICENSE) for details.

## Links

- [API Documentation](https://api-production-0c55.up.railway.app/docs)

