A2A 皮层（或A2A 腔室，具体翻译取决于上下文，若指大脑结构则译为“A2A 皮层”）
利用A2A、MCP实现AI编排，包括授权和权限管理（概念验证）。
项目概述
多智能体系统，展示基于Python的专用智能体之间使用A2A协议进行的智能体到智能体通信。该系统为AI智能体交互提供智能编排、安全认证和权限管理功能。
特点
- 代理到代理（A2A）通信基于协议的专用AI代理之间的通信
- MCP集成模型上下文协议支持，用于增强上下文管理
- 认证与授权使用SuperTokens和Permit.io确保代理交互的安全性
- 单体仓库架构可扩展的工作区，配备UV包管理功能
- Docker 支持使用Docker Compose进行容器化部署
- 网页界面用于代理管理和监控的交互式仪表板
快速入门
先决条件
- Python 3.13或更高版本
- 紫外线（UV）包管理器
- 用于代理功能的Google API密钥
- Docker 和 Docker Compose（可选，用于容器化部署）
安装
# Install dependencies for all packages
just install
# or manually:
uv sync --all-packages开发服务器
# Start the development environment
just dev
# This will start:
# - A2A Orchestrator agent
# - MCP Gateway
# - Context7 documentation agent
# - Web interface (accessible at http://localhost:3000)项目结构
a2a-cortex/
├── apps/ # Individual agent applications
│ ├── a2a-math/ # Mathematical computation agent
│ ├── a2a-orchestrator/ # Main orchestration agent
│ ├── mcp-gateway/ # MCP protocol gateway
│ └── a2a-context-7/ # Documentation agent
├── packages/
│ └── shared/ # Shared utilities and types
├── docs/ # Architecture documentation
├── Justfile # Command definitions
├── compose.yml # Docker Compose configuration
└── pyproject.toml # Workspace configuration可用代理
A2A数学代理
专门用于数学运算和计算的代理。
A2A（异步消息传递）编排器
中央协调代理，负责管理代理通信和任务分配。
MCP网关
利用模型上下文协议在智能体之间建立桥梁，以增强上下文共享。
A2A Context7（可译为“A2A上下文7”或根据具体语境调整为更贴切的表述，如“A2A情境7”等）
提供智能访问技术文档和API的文档代理。
命令
# Development
just dev # Start all services in development mode
just inspector # Launch MCP Inspector for debugging
just web # Start web interface only
# Code Quality
uv run ruff check . # Lint code
uv run ruff format . # Format code
uv run mypy . # Type checking
# Testing
uv run pytest # Run tests (run in individual app directories)
cd apps/a2a_math && uv run pytest配置
- 环境变量通过（某种方式）进行管理
.env文件 - 代理端口可以通过环境变量进行配置
- 要提供Google API密钥以获得全部功能
部署
Docker 部署
# Build and run all services
docker-compose up --build
# Run in background
docker-compose up -d --build认证与安全
该系统与以下系统集成：
- SuperTokens（可译为“超级令牌”或根据具体语境保持原样，若“SuperTokens”是一个特定产品或服务的名称，则可能需要查找官方或通用的中文译名）认证和会话管理
- Permit.io（可译为“许可管理.io”或根据具体语境简化为“许可.io”，但通常直接保留原名以体现其作为特定产品或服务的名称）细粒度的权限和授权
这确保了安全的代理交互和适当的访问控制。
架构文档
详细的架构指南和API文档可在 docs/ 目录。
参考文献
做出贡献
- 为仓库创建分支（或“克隆仓库”）
- 创建一个特性分支
- 安装依赖项：
just install - 运行测试：
pytest - 提交拉取请求
许可证
此项目采用MIT许可证授权——详见LICENSE文件。