KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

www-project-agent-observability-standard

★ 57 Open GitHub ↗

Agent Observability Standard

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Agent Observability Standard

[![Apache License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://raw.githubusercontent.com/OWASP/www-project-agent-observability-standard/dev/LICENSE.txt)

![AOS Banner](https://raw.githubusercontent.com/OWASP/www-project-agent-observability-standard/dev/docs/assets/banner.png)

**Making AI agents trustworthy by standardizing observability.**

## Rational
Agents must become trustworthy to enable widescale adoption.

Transparency is the foundation of trust. Whether built in-house or adopted as part of a service. Consumed on cloud, as SaaS, on-prem or on endpoints. Agents must be fully observable by the enterprise that welcomes them in. We cannot trust a magic black-box.

For agents to become trustworthy they must be **inspectable, traceable and instrumentable**.

- **Inspectable:** we don’t have to guess what’s inside. Which tools, models and capabilities are being used. What software version is running and who built it. What are the services behind them, and which data they can access. Must dynamicly adapt to account for rapid changes in agent components.
- **Traceable:** we know what the agent did and why. We can trace back any action taken to the reasoning behind it and the originating task. Even if the thread goes through multiple agents and software systems. In case of compromise, we can identify and remediate the root cause.
- **Instrumentable:** we can hook into agent execution and steer it in the right direction. We can put hard controls around agents and define their scope of action. Apply centralized enterprise logic, be it security, compliance or legal, uniformly across agent platforms. Prevent or modify behavior to comply.

### Key Components

The standard covers the following aspects
1. AOS that defines the interaction between the Observed Agent and the Guardian Agent
2. Observability requirements and implementations for tracing all AOS events using OpenTelemetry and OCSF
3. Agent BOM (AgBOM) requirements and implementations for exposing dynamic Agent's bill-of-material via CoycloneDX, SWID and SPDX

## Getting Started

- 📚 **Explore the Documentation:** Visit the [Documentation Site](https://aos.owasp.org) for a complete overview, the full specification, tutorials, and guides.
- 📝 **View the Specification:** [Specification](https://github.com/OWASP/www-project-agent-observability-standard/tree/main/specification)

## Contributing

We welcome community contributions to enhance and evolve AOS!

- **Questions & Discussions:** Join our [GitHub Discussions](do we have github enterprise?).
- **Issues & Feedback:** Report issues or suggest improvements via [GitHub Issues](https://github.com/OWASP/www-project-agent-observability-standard/issues).
- **Contribution Guide:** See our [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute.

## What's next

#### v0.1 (Public Preview)
- Overall documentation and requirements
- AOS definitions and schema
- Observability definitions for for OpenTelemetry and OCSF
- AgBOM requirements

#### v1
- Implementation of Agent instrumentation
- Implementation of Guardian Agent sample app with
  - AOS Support
  - AOS to OpenTelemetry mapper
  - AOS to OCSF mapper
- FastMCP client instrumentation for AOS
- A2A client instrumentation for AOS

#### v2
- Requirements for CycloneDX, SPDX, SWID
- Implementation of AOS to AgBOM mappers for CycloneDX, SPDX, SWID

#### v3
- Extending A2A and MCP to support deny and modify operations
- Implementation of Agent with deny and modify support

## About

The AOS is an open-source project under the [Apache License 2.0](LICENSE), and is open to contributions from the community.

www-project-agent-observability-standard

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README