Home

Awesome

NOTE: This Typescript SDK is for AgentOps legacy. There is no Typescript support for the current version of AgentOps.

<div align="center"> <img src="logo.png" style="margin: 15px; max-width: 300px" width="50%" alt="Logo"> </div> <p align="center"> <em>AI agents suck. Weโ€™re fixing that.</em> </p> <p align="center"> <a href="https://pypi.org/project/agentops/" target="_blank"> <img alt="Node" src="https://img.shields.io/badge/node-js?style=for-the-badge&logo=javascript&logoColor=ffdd54" /> <img alt="Version" src="https://img.shields.io/node/v/agentops?style=for-the-badge&color=3670A0"> </a> </p> <p align="center"> <a href="https://twitter.com/agentopsai/">๐Ÿฆ Twitter</a> <span>&nbsp;&nbsp;โ€ข&nbsp;&nbsp;</span> <a href="https://discord.gg/JHPt4C7r">๐Ÿ“ข Discord</a> <span>&nbsp;&nbsp;โ€ข&nbsp;&nbsp;</span> <a href="https://app.agentops.ai/?=gh">๐Ÿ–‡๏ธ AgentOps</a> <span>&nbsp;&nbsp;โ€ข&nbsp;&nbsp;</span> <a href="https://docs.agentops.ai/introduction">๐Ÿ“™ Documentation</a> </p>

AgentOps

Build your next agent with benchmarks, observability, and replay analytics. AgentOps is the toolkit for evaluating and developing robust and reliable AI agents.

AgentOps is open beta. You can sign up for AgentOps here.

License: MIT Node - Version <img src="https://img.shields.io/npm/dm/agentops"> <a href="https://twitter.com/agentopsai"> <img src="https://img.shields.io/badge/follow-%40agentops-1DA1F2?logo=twitter&style=social" alt="AgentOps Twitter" /> </a> <a href="https://discord.gg/mKW3ZhN9p2"> <img src="https://img.shields.io/badge/chat-on%20Discord-blueviolet" alt="Discord community channel" /> </a> <a href="mailto:investor@agentops.ai"><img src="https://img.shields.io/website?color=%23f26522&down_message=Y%20Combinator&label=Not%20Backed%20By&logo=ycombinator&style=flat-square&up_message=Y%20Combinator&url=https%3A%2F%2Fwww.ycombinator.com"></a> <a href="https://github.com/agentops-ai/agentops/issues"> <img src="https://img.shields.io/github/commit-activity/m/agentops-ai/agentops-node" alt="git commit activity" /> </a>

๐Ÿšจ NOTE: This Typescript library is still in alpha and does not currently support many of the functionalities available with the python SDK. If possible, using Python is recommended.

Quick Start

Install AgentOps npm install agentops

Add AgentOps to your code. Check out an example.

import OpenAI from "openai";
import { Client } from 'agentops';

const openai = new OpenAI();                        // Add your API key here or in the .env

const agentops = new Client({
    apiKey: "<Insert AgentOps API Key>",            // Add your API key here or in the .env
    tags: ["abc", "success"],                       // Optionally add tags to your run
    patchApi: [openai]                              // Record LLM calls automatically (Only OpenAI is currently supported)
});

// agentops.patchApi(openai)                        // Alternatively, you can patch API calls later

// Sample OpenAI call (automatically recorded if specified in "patched")
async function chat() {
    const completion = await openai.chat.completions.create({
        messages: [{ "role": "system", "content": "You are a helpful assistant." },
        { "role": "user", "content": "Who won the world series in 2020?" },
        { "role": "assistant", "content": "The Los Angeles Dodgers won the World Series in 2020." },
        { "role": "user", "content": "Where was it played?" }],
        model: "gpt-3.5-turbo",
    });

    return completion
}

// Sample other function
function orignal(x: string) {
    console.log(x);
    return 5;
}

// You can track other functions by wrapping the function.
const wrapped = agentops.wrap(orignal);
wrapped("hello");


chat().then(() => {
    agentops.endSession("Success"); // Make sure you end your session when your agent is done.
});

Time travel debugging ๐Ÿ”ฎ

(coming soon!)

Agent Arena ๐ŸฅŠ

(coming soon!)

Evaluations Roadmap ๐Ÿงญ

PlatformDashboardEvals
โœ… Python SDKโœ… Multi-session and Cross-session metrics๐Ÿšง Evaluation playground + leaderboard
๐Ÿšง Evaluation builder APIโœ… Custom event tag trackingย ๐Ÿ”œ Agent scorecards
โœ… Javascript/Typescript SDK๐Ÿšง Session replays๐Ÿ”œ Custom eval metrics

Debugging Roadmap ๐Ÿงญ

Performance testingEnvironmentsLAA (LLM augmented agents) specific testsReasoning and execution testing
โœ… Event latency analysis๐Ÿ”œ Non-stationary environment testing๐Ÿ”œ LLM non-deterministic function detection๐Ÿšง Infinite loops and recursive thought detection
โœ… Agent workflow execution pricing๐Ÿ”œ Multi-modal environments๐Ÿ”œ Token limit overflow flags๐Ÿ”œ Faulty reasoning detection
๐Ÿ”œ Success validators (external)๐Ÿ”œ Execution containers๐Ÿ”œ Context limit overflow flags๐Ÿ”œ Generative code validators
๐Ÿ”œ Agent controllers/skill tests๐Ÿ”œ Honeypot and prompt injection evaluation๐Ÿ”œ API bill tracking๐Ÿ”œ Error breakpoint analysis
๐Ÿ”œ Information context constraint testing๐Ÿ”œ Anti-agent roadblocks (i.e. Captchas)
๐Ÿ”œ Regression testing

Why AgentOps? ๐Ÿค”

Our mission is to make sure your agents are ready for production.

Agent developers often work with little to no visibility into agent testing performance. This means their agents never leave the lab. We're changing that.

AgentOps is the easiest way to evaluate, grade, and test agents. Is there a feature you'd like to see AgentOps cover? Just raise it in the issues tab, and we'll work on adding it to the roadmap.