agops-sdk 0.1.0

Agent observability SDK for Ag-Ops — wrap your LLM clients, see what your agents do.

agops-sdk

Lightweight observability wrapper for Anthropic and OpenAI Python SDKs. Part of Ag-Ops.

Your API key never leaves your machine. The SDK intercepts each request/response and ships the session log asynchronously — fire-and-forget. SDK errors never break your app.

Install

pip install agops-sdk

With your LLM client of choice:

pip install "agops-sdk[anthropic]"   # or [openai]

Quickstart

import agops_sdk
from anthropic import Anthropic

agops_sdk.configure(token="ag_...", project="my-project")
# or set AGOPS_TOKEN + AGOPS_PROJECT env vars

client = agops_sdk.wrap(Anthropic())

# Works exactly like the original client
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello"}],
)

# Streaming works too
with client.messages.stream(...) as stream:
    for text in stream.text_stream:
        print(text)

OpenAI works the same way:

import agops_sdk
from openai import OpenAI

client = agops_sdk.wrap(OpenAI())
response = client.chat.completions.create(...)

What gets shipped

Each call ships a session payload containing: model, messages (user + assistant + tool), token counts, duration, timestamps, and errors. The full transcript appears in the Ag-Ops dashboard within seconds.

Delivery reliability

Failed shipments retry with exponential backoff (3 attempts: 1s, 2s, 4s). On repeated failure, sessions queue to disk at ~/.agops/queue/ and drain on the next successful call.

Configuration

Env var	Purpose
AGOPS_TOKEN	Ag-Ops API token (get one from the dashboard).
AGOPS_PROJECT	Project slug — optional, shown in the dashboard feed.
AGOPS_ENDPOINT	Override the backend endpoint (default: hosted Ag-Ops).

License

MIT