Skip to content

olserra/agent-semantic-protocol

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 CI Codecov Go Version License: MIT


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

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 for details.


Contributing

We welcome contributions! See CONTRIBUTING.md for details.


License

MIT — see LICENSE.

About

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

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors