ProtoLink

ProtoLink 是一个轻量级的 Python 框架，以 A2A（Agent-to-Agent）协议为核心设计理念，专门用于构建可插拔的 Agent 和多 Agent 系统。相比 LangChain 等以链式调用为中心的框架，ProtoLink 将每个 Agent 视为自包含的运行时实体，具备身份、能力、生命周期、工具、可选推理和直接基于任务通信的能力。

核心设计原则：A2A 是架构核心而非附加集成。ProtoLink 原生构建于 A2A 0.3 规范，后扩展支持推理、工具、结构化 Agent 流程和运营模块，同时不放弃协议原语。这种设计保持了 Agent/Task API 的简洁性和运行时的可插拔性。

每个 Agent 由独立模块组合而成，模块完全可选且可替换。支持的组件包括：API 或本地 LLM、应用知识（RAG）、内置工具、Native 工具或 MCP 工具、传输层、注册表、存储和状态、遥测、认证、日志、策略和持久化运行记录。用户只需为 Agent 实际需要的组件付费，不需要的功能不会引入依赖。

ProtoLink 刻意追求 LLM 无关和本地优先策略。优先使用 Provider 原生工具调用，当不可用时，严格的 JSON action 回退机制使本地模型和小模型也能在 Ollama、llama.cpp、LM Studio、vLLM 或自定义后端上正常工作。更改模型不需要重写 Agent、工具或通信层。

基础包只有一个运行时依赖：Pydantic。其他如 HTTP 服务器、gRPC、托管模型 SDK、MCP、遥测提供者等扩展仅在用户明确选择时才安装。

使用方式简洁：只需安装 HTTP 扩展（uv add "protolink[http]"），然后导入 Agent 和 AgentCard，配置名称、描述和 URL，启动后即可运行，无需 async main()、事件循环设置、模型账号或 API Key。start() 方法拥有完整生命周期管理，对于独立服务直接阻塞运行，对于嵌入场景可传 background=True 后台运行。

框架提供完整的文档站，包含入门指南、核心概念、API 文档和大量示例。