Английский | 简体中文

Введение

Agent Protocol предоставляет SDK протоколов и реестр сервисов для совместимости агентов в экосистеме openJiuwen. Он помогает разработчикам подключать агентов к инструментам, взаимодействовать с удалёными агентами, выявлять доступные сервисы и обеспечивать проверяемую авторизацию пользователя перед конфиденциальными операциями.

Агентному приложению нужно больше, чем просто модель и логика задач: ему нужен способ доступа к внешним возможностям, поиску подходящих соавторов, обмена сообщениями и результатами задач, а также ограничения того, что оно может выполнять от имени пользователя. Этот репозиторий удовлетворяет эти потребности через четыре дополняющих компонента: MCP C++ SDK, A2A C++ SDK, A2X Registry и A4P Python SDK. Разработчики могут выбирать отдельные компоненты или комбинировать их в соответствии с потребностями интеграции.

Основные возможности

Интеграция инструментов и ресурсов с MCP

Протокол Model Context Protocol (MCP) C++ SDK предоставляет как клиентские, так и серверные возможности, поддерживая Streamable HTTP и stdio транспорты. Разработчики могут предоставлять инструменты, ресурсы и запросы через MCP-сервер или создавать клиент, который подключается к существующим MCP-сервисам.

Agent Protocol

English | 简体中文

Introduction

Agent Protocol provides protocol SDKs and a service registry for agent interoperability in the openJiuwen ecosystem. It helps developers connect agents to tools, communicate with remote agents, discover available services, route requests across LLM deployments, and enforce verifiable user authorization before sensitive operations.

An agent application needs more than a model and task logic: it needs a way to access external capabilities, locate suitable collaborators, exchange messages and task results, and constrain what it can execute on a user’s behalf. This repository addresses these needs through six complementary components: MCP C++ SDK, A2A C++ SDK, A2X Registry, A4P Python SDK, A4P Java SDK, and IntelliRouter. Developers can choose individual components or combine them according to their integration needs.

Core Capabilities

Tool and resource integration with MCP

The Model Context Protocol (MCP) C++ SDK provides both client and server capabilities, supporting Streamable HTTP and stdio transports. Developers can expose tools, resources, and prompts through an MCP server, or build a client that connects to existing MCP services. The SDK also includes support for authentication, sampling, progress notifications, and roots.

Agent communication with A2A

The Agent2Agent (A2A) C++ SDK implements agent communication over HTTP and JSON-RPC. Clients can discover Agent Cards, send messages, query or cancel tasks, and receive streaming events. Servers can register an AgentExecutor, manage task lifecycles, and expose JSON-RPC endpoints, with extension points such as request interceptors and custom task stores.

Service registration and discovery with A2X

A2X Registry manages agents and services that agents can invoke. It supports registration and deregistration, field-based queries, service-card updates, online/busy/offline states, ownership-based access control, and short-lived reservation leases for Agent Team coordination.

For capability discovery, A2X search combines an automatically constructed hierarchical capability catalog with LLM-guided semantic navigation, allowing agents to locate services from natural-language requests. The registry also provides optional vector search, dataset isolation, HTTP APIs, a Python client, and a web UI for service management and search exploration. A2X search and catalog construction require an LLM configuration; basic registry operations do not.

Verifiable authorization with A4P