https://github.com/agile-lab-dev/agent-specification
https://github.com/agile-lab-dev/agent-specification
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/agile-lab-dev/agent-specification
- Owner: agile-lab-dev
- License: apache-2.0
- Created: 2025-03-05T17:30:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-07T10:18:56.000Z (10 months ago)
- Last Synced: 2025-08-07T10:31:41.658Z (10 months ago)
- Language: Python
- Size: 1.34 MB
- Stars: 18
- Watchers: 5
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.MD
- License: LICENSE
Awesome Lists containing this project
README
# Agent Descriptor Specification
This repo hosts the specification for **Agent Descriptors**. These descriptors define the attributes of different **agent components** that can be used within an **agentic system**. These components allow for modular, reusable structures that enable the agent to interact with data, execute actions, and enforce policies.
## Specification
The specification is also available as [OpenAPI 3.0 endpoints](agent-specification.yaml), to create the foundation of an **Agent Descriptor Registry**.
📄 **[Read the full Agent Descriptor Specification](spec.md)**
Examples of an agent can be found in the [examples](examples) directory.
## How to run validation
1. [Install](https://docs.astral.sh/uv/getting-started/installation/) `uv` package manager.
2. Run this command from the repo's root folder to validate the example descriptor:
```sh
./scripts/validate_model.sh
```
If you change the Agent Descriptor Specs (`agent-specifications.yaml`), you need to regenerate the pydantic models used for validation with:
```sh
./scripts/generate_model.sh
```
## Roadmap
- [x] Define the specification
- [x] Create OpenAPI 3.0 endpoints
- [ ] Launch site
- [ ] Create a reference implementation
- [ ] Implement authentication and authorization mechanisms
- [ ] Support for multi-agent coordination
- [ ] Implement storage backends
---
For improvements, open an issue or submit a pull request. 🚀