agent-semantic-protocol

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

agent-semantic-protocol

★ 27 Open GitHub ↗

Agent Semantic Protocol v1.0.0— Semantic interoperability layer for AI agents (MCP extension)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Agent Semantic Protocol

> **Connecting AI agents through meaning, not schema.**

The **Agent Semantic Protocol (ASP)** connects agents to each other, unlike MCP, which connects LLMs to tools. Instead of rigid APIs, ASP uses **semantic intent vectors** to describe goals, enabling agents to dynamically discover, negotiate, and collaborate. This makes ASP more flexible, scalable, and interoperable, fostering a smarter, decentralized multi-agent ecosystem.

![Go Report Card](https://goreportcard.com/badge/github.com/olserra/agent-semantic-protocol)
[![CI](https://github.com/olserra/agent-semantic-protocol/actions/workflows/ci.yml/badge.svg)](https://github.com/olserra/agent-semantic-protocol/actions/workflows/ci.yml)
[![Codecov](https://codecov.io/gh/olserra/agent-semantic-protocol/branch/main/graph/badge.svg)](https://codecov.io/gh/olserra/agent-semantic-protocol)
[![Go Version](https://img.shields.io/github/go-mod/go-version/olserra/agent-semantic-protocol)](https://golang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/olserra/agent-semantic-protocol/main/LICENSE)

---

## Why Agent Semantic Protocol?

MCP connects LLMs to tools. **ASP connects agents to agents.**

ASP enables AI agents to communicate **by meaning, not schema**. Instead of rigid JSON APIs, agents share **semantic intent vectors** \
— compact embeddings that describe goals in a shared latent space. This allows:

- **Dynamic Discovery**: Agents appear/disappear at runtime.
- **Spontaneous Negotiation**: No central broker needed.
- **Federated Trust**: Decentralized identifiers (DIDs) ensure authenticity.

### Why is this important?

In traditional systems, agents rely on predefined APIs and schemas to interact. This approach is brittle and limits flexibility. ASP introduces a paradigm shift by enabling agents to understand each other's goals and capabilities dynamically, fostering:

- **Interoperability**: Agents from different vendors can collaborate seamlessly.
- **Scalability**: New agents can join or leave without disrupting the network.
- **Resilience**: Decentralized trust mechanisms reduce single points of failure.

By focusing on meaning rather than structure, ASP paves the way for a more adaptive and intelligent multi-agent ecosystem.

---

## Core Concepts

| Concept | Description |
|---|---|
| **Intent Vector** | A `[]float32` embedding that encodes the *semantic goal* of a request |
| **Spontaneous Negotiation** | Agents advertise capabilities and bid on intents |
| **Dynamic Discovery** | TTL-based capability registry |
| **Federated Trust (DIDs)** | Self-sovereign identity with Ed25519 keys |
| **Distributed Workflows** | Multi-step workflows across peers |

---

## Architecture

```
+-------------------+   +-------------------+
|   Agent Alpha     |   |   Agent Beta      |
|-------------------|   |-------------------|
| Capabilities: NLP|   | Capabilities: Math|
|-------------------|   |-------------------|
| Intent Vector --> |   | <-- Negotiation   |
+-------------------+   +-------------------+
```

---

## Quickstart

### Prerequisites

- Go 1.22+
- `git`

### Install & Run

```bash
git clone https://github.com/olserra/agent-semantic-protocol.git
cd agent-semantic-protocol
go mod download

# Run the handshake demo
go run ./examples/simple-handshake/main.go
```

---

## Roadmap

See [ROADMAP.md](ROADMAP.md) for details.

---

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

---

## License

MIT — see [LICENSE](LICENSE).

agent-semantic-protocol

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README