Agent2Agent 协议 (A2A)

A2A

一个开放协议，旨在实现不透明的智能代理应用程序之间的通信和互操作性。

企业采用人工智能的最大挑战之一是如何让基于不同框架和供应商构建的代理协同工作。这就是我们创建开放的 Agent2Agent (A2A) 协议的原因，这是一种协作方式，旨在帮助不同生态系统中的代理相互通信。Google 正在推动这项行业开放协议倡议，因为我们相信这个协议对于支持多代理通信至关重要，它将为您的代理提供一种通用语言——无论它们构建于哪个框架或供应商之上。借助 A2A，代理可以相互展示它们的功能并协商如何与用户交互（通过文本、表单或双向音频/视频）——所有这些都在安全地协同工作的同时进行。

观看 A2A 的实际应用

观看此演示视频，了解 A2A 如何实现不同代理框架之间的无缝通信。

概念概述

Agent2Agent (A2A) 协议促进了独立 AI 代理之间的通信。以下是核心概念：

  • 代理卡片 (Agent Card): 一个公开的元数据文件（通常位于 /.well-known/agent.json），描述了代理的功能、技能、端点 URL 和身份验证要求。客户端使用它进行发现。
    • A2A 服务器 (A2A Server): 一个公开 HTTP 端点并实现 A2A 协议方法（定义在 json 规范 中）的代理。它接收请求并管理任务执行。
    • A2A 客户端 (A2A Client): 一个消费 A2A 服务的应用程序或另一个代理。它向 A2A 服务器的 URL 发送请求（如 tasks/send）。
    • 任务 (Task): 中心的工作单元。客户端通过发送消息（tasks/send 或 tasks/sendSubscribe）来启动任务。任务具有唯一的 ID，并经历以下状态：submitted（已提交）、working（工作中）、input-required（需要输入）、completed（已完成）、failed（失败）、canceled（已取消）。
    • 消息 (Message): 表示客户端（role: "user"）和代理（role: "agent"）之间的通信轮次。消息包含 Parts（部件）。
    • 部件 (Part): Message 或 Artifact（工件）中的基本内容单元。可以是 TextPart（文本部件）、FilePart（文件部件，包含内联字节或 URI）或 DataPart（数据部件，用于结构化 JSON，例如表单）。
    • 工件 (Artifact): 表示代理在任务期间生成的输出（例如，生成的文件、最终的结构化数据）。工件也包含 Parts（部件）。
    • 流式传输 (Streaming): 对于长时间运行的任务，支持 streaming 功能的服务器可以使用 tasks/sendSubscribe。客户端接收服务器发送事件 (SSE)，其中包含 TaskStatusUpdateEvent（任务状态更新事件）或 TaskArtifactUpdateEvent（任务工件更新事件）消息，提供实时的进度。
    • 推送通知 (Push Notifications): 支持 pushNotifications 的服务器可以主动向客户端提供的 webhook URL 发送任务更新，该 URL 通过 tasks/pushNotification/set 配置。
a2aagent2agentagentmulti-agentagent-interoperabilitymcpgoogleprotocoljson-rpc

智能编码新范式 (Cline + DeepSeek) × MCP

  • 提示词：使用 React 技术实现 Tic Tac Toe 游戏

  • 运行游戏

  • 创建新仓库

  • 快速设置仓库

  • 退出游戏

  • 查看已安装的 MCP 服务器

  • 创建新问题（issue）

  • 查看 wang-junjian/tictactoe 项目中分配给我 issue，使用 GitHub MCP 服务器的工具 list_issues

  • 当前仓库 wang-junjian/tictactoe 中有1个开放的 issue

  • 分步实现 issue #1 玩家获胜时添加烟花效果

  • 实现 issue #1 玩家获胜时添加烟花效果

  • 运行游戏 - 获胜后的烟花效果

  • 创建新问题 - Refactoring

  • 创建分支 git switch -c Refactoring，对项目中的代码进行重构

  • 完成代码重构

  • 推送到远程仓库，git push -u origin Refactoring

  • Compare & pull request

  • 创建拉取请求（pull request），关联问题（issue #2）

  • wang-junjian/tictactoe 项目中分配给我的 PR，使用 GitHub MCP 服务器的工具 get_pull_request

  • 使用 GitHub MCP 服务器的工具 get_pull_request_files 获取 PR 的变更文件列表

  • 完成 PR #3 的代码评审

  • 使用 GitHub MCP 服务器的工具 add_issue_comment，提交代码评审
clinedeepseekmcpgithub-mcp-servervscodetictactoereactai-codingissuepull-request

Git 命令

使用 Git 的工作流程

配置

查看全局配置

git config --global --list

filter.lfs.clean=git-lfs clean -- %f
filter.lfs.smudge=git-lfs smudge -- %f
filter.lfs.process=git-lfs filter-process
filter.lfs.required=true
user.name=军舰
user.email=wang-junjian@qq.com
http.postbuffer=524288000
http.version=HTTP/1.1

设置全局配置

git config --global user.name "军舰"
git config --global user.email wang-junjian@qq.com

初始化仓库

git init

Initialized empty Git repository in /Users/junjian/GitHub/wang-junjian/HelloGit/.git/

设置远程仓库

git remote add origin https://github.com/wang-junjian/HelloGit.git

基础

查看状态

gitgithubversion-controlbranchcommitpull-requestworkflowgit-commandscollaboration

开发 RAGFlow MCP Server

开发

这是第一次开发 MCP Server，想着使用智能编码工具（GitHub Copilot、Cursor、Trae）进行氛围编程，发现真不容易，Claude 3.7 sonnet 效果不错，在 GitHub Copilot 没用多长时间超限制了；Cursor 没有达到之前那种随心的效果；Trae 要排长队，太有挫败感了。于是，开始了以人编码为主，大模型辅助的开发过程。

MCP Server 的工作流程

  1. 初始化：加载环境变量，初始化 RAGFlow 客户端。
  2. 工具注册：定义工具列表，描述工具的输入/输出。
  3. 工具逻辑：实现工具的具体调用逻辑。
  4. 服务器启动：通过 stdio 启动 MCP Server 并监听请求。

创建 RAGFlow MCP Server 项目

uvx create-mcp-server \
    --path ragflow-mcp-server \
    --name ragflow-mcp-server \
    --version 0.1.0 \
    --description "RAGFlow MCP Server" \
    --no-claudeapp
cd ragflow-mcp-server
uv sync --dev --all-extras
uv add ragflow-sdk

下载 MCP 开发文档和 RAGFlow Python API 文档

ragflowmcp-serverragflow-sdkmcpraggithub-copilotcontinueclineuvpypi

Visual Studio Code 2025年3月版本(1.99)的新功能

欢迎使用Visual Studio Code 2025年3月版本。此版本包含许多更新，我们希望您会喜欢，一些主要亮点包括：

  • 代理模式
    • 代理模式现已在VS Code稳定版中可用。通过设置setting(chat.agent.enabled:true)启用（更多...）。
    • 通过模型上下文协议(MCP)服务器工具扩展代理模式（更多...）。
    • 尝试代理模式中的新内置工具，用于获取网页内容、查找符号引用和深度思考（更多...）。
  • 代码编辑
    • 下一步编辑建议现已正式发布（更多...）。
    • 在编辑器中应用AI编辑时减少诊断事件等干扰（更多...）。
  • 聊天
    • 在聊天中使用自己的API密钥访问更多语言模型（预览版）（更多...）。
    • 从统一的聊天体验中轻松切换问答、编辑和代理模式（更多...）。
    • 通过即时远程工作区索引体验提高工作区搜索速度和准确性（更多...）。
  • 笔记本编辑
    • 借助编辑和代理模式的支持，像编辑代码文件一样轻松创建和编辑笔记本（更多...）。

如果您想在线阅读这些发布说明，请前往code.visualstudio.com上的更新页面。 Insiders版本： 想尽快尝试新功能吗？您可以下载每晚构建的Insiders版本，并在功能可用后立即尝试最新更新。

聊天

代理模式在 VS Code 稳定版中可用

设置：setting(chat.agent.enabled:true)

vscoderelease-notesgithub-copilotagent-modemcpcopilotnext-edit-suggestionsunified-chatai-notebooksemantic-search

构建AI代理：5个常见障碍及解决方案

构建AI代理的新手指南，帮助您克服挑战。

AI代理正变得越来越复杂，能够自动化工作流程、做出决策并与外部工具集成。然而，在现实世界中部署AI代理面临着很多挑战，这些挑战会影响其可靠性、性能和准确性。现在优先建立AI代理设计的强大基础，将为未来可靠、安全的自主系统奠定基础。

👉 本指南探讨了开发人员在创建AI代理时面临的五个最常见障碍，以及克服这些障碍的实用解决方案。 无论您是刚刚入门的新手还是正在改进方法的资深开发人员，这些最佳实践都将帮助您设计出在复杂环境中更可靠、更具扩展性和更有效的AI代理。

让我们开始构建代理式AI吧！

1. 管理工具集成

随着AI代理变得越来越复杂，管理它们对各种工具的访问和使用变得越来越具有挑战性。每增加一个工具都会引入新的潜在故障点、安全考虑因素和性能影响。确保代理适当地使用工具并优雅地处理工具故障对于可靠运行至关重要。

要解决这一挑战，请为代理工具箱中的每个工具创建精确的定义。包括何时使用该工具的明确示例、有效参数范围和预期输出。构建能够强制执行这些规范的验证逻辑，并从一小组定义明确的工具开始，而不是许多定义松散的工具。定期监控将帮助您识别哪些工具最有效，以及哪些定义需要完善。

2. 管理模型推理和决策

构建AI代理的一个基本挑战是确保一致可靠的决策。与遵循明确规则的传统软件系统不同，AI代理必须解释用户意图，对复杂问题进行推理，并最终基于概率分布做出决策。

ai-agentllmtool-integrationreact-promptinglangchainllama-indexllmopshallucinationmulti-step-workflowenterprise-ai

利用多张 GPU 训练大语言模型

参考资料

llm-trainingmulti-gpudeepspeedflash-attentionquantizationliger-kerneldistributed-traininggpu-cluster李宏毅2025

git pull 批量更新多个仓库

git -C <目录> pull

这个命令用于从远程仓库获取最新代码并合并到当前分支。-C 选项允许你在指定的目录中运行 git 命令，而不需要先切换到那个目录。

下面是 MCP 相关的仓库

create-python-server
create-typescript-server
docs
inspector
python-sdk
quickstart-resources
servers
specification
typescript-sdk

更新所有仓库

方法一：手动更新

gitgit-pullbatch-operationscommand-linemcprepository-managementshell-scriptingworkflowdeveloper-tools

Continue Agent 使用 GitHub MCP Server

Continue 智能体

  • 必须使用 Agent 模式才支持 MCP Server。
  • Agent 模式不支持 DeepSeek 系列的模型（包括官方API和开源）。
  • 大模型使用本地 Ollama 的模型：qwen2.5-coder:32b 和 qwq:latest。

申请 GitHub 个人访问令牌（Personal Access Token）

  • 访问 GitHub 的 Settings 页面，点击 Developer settings。
  • 点击 Personal access tokens，然后点击 Tokens (classic)。
  • 点击 Generate new token 按钮。

Continue 配置

config.yaml 文件配置如下：

name: Local Assistant
version: 1.0.0
schema: v1
models:
  - name: Autodetect
    provider: ollama
    model: AUTODETECT
  - name: DeepSeek Chat
    provider: deepseek
    model: deepseek-chat
    apiKey: sk-xxx
  - name: DeepSeek Coder
    provider: deepseek
    model: deepseek-coder
    apiKey: sk-xxx
// ...
continuegithub-mcp-servermcpollamadeepseekai-coding-assistantagent-modeqwencode-reviewlocal-llm

GitHub MCP 服务器

GitHub MCP 服务器

GitHub API 的 MCP 服务器，支持文件操作、仓库管理、搜索功能等。

功能特点

  • 自动分支创建：创建/更新文件或推送更改时，如果分支不存在则自动创建
  • 全面的错误处理：对常见问题提供清晰的错误信息
  • Git 历史保留：操作保持适当的 Git 历史记录，不强制推送
  • 批量操作：支持单文件和多文件操作
  • 高级搜索：支持搜索代码、议题/PR 和用户

工具

  1. create_or_update_file
    • 在仓库中创建或更新单个文件
    • 输入：
      • owner (字符串)：仓库所有者（用户名或组织）
      • repo (字符串)：仓库名称
      • path (字符串)：创建/更新文件的路径
      • content (字符串)：文件内容
      • message (字符串)：提交消息
      • branch (字符串)：要在其中创建/更新文件的分支
      • sha (可选字符串)：被替换文件的 SHA（用于更新）
    • 返回：文件内容和提交详情
  1. push_files
    • 在单个提交中推送多个文件
    • 输入：
      • owner (字符串)：仓库所有者
      • repo (字符串)：仓库名称
      • branch (字符串)：要推送到的分支
      • files (数组)：要推送的文件，每个包含 path 和 content
      • message (字符串)：提交消息
    • 返回：更新的分支引用

search_repositories 搜索 GitHub 仓库 输入： query (字符串)：搜索查询

github-mcp-servermcpmodel-context-protocolgithubgithub-apirepository-managementdockernpxpersonal-access-tokencode-review

使用 Trae 开发 RAGFlow 助手

⚠️ Trae 试用感受

  • 热门模型（Claude-3.7-sonnet）需要排队
  • 在当前会话中，我引用过一个文件，接着提问还需要添加引用，太麻烦了。
  • 都知道它是中国字节开发的，有一种亲切感，确让我翻墙来用她。

功能界面

操作

提示词

使用 Streamlit UI 库开发一个连接 RAGFlow 的客户端应用，左边列出可选的知识库，右边是聊天对话框。

traeragflowai-coding-assistantstreamlitknowledge-basechatbotretrieval-augmented-generationllmclient-appbytedance

MCP 服务器示例和实现列表

本页展示了各种模型上下文协议(MCP)服务器，这些服务器展示了该协议的功能和多样性。这些服务器使大型语言模型(LLM)能够安全地访问工具和数据源。

参考实现

这些官方参考服务器展示了核心 MCP 功能和 SDK 用法：

数据和文件系统

  • 文件系统 - 具有可配置访问控制的安全文件操作
  • PostgreSQL - 具有架构检查功能的只读数据库访问
  • SQLite - 数据库交互和商业智能功能
  • Google Drive - Google Drive 的文件访问和搜索功能

开发工具

  • Git - 读取、搜索和操作 Git 仓库的工具
  • GitHub - 仓库管理、文件操作和 GitHub API 集成
  • GitLab - GitLab API 集成，支持项目管理
  • Sentry - 从 Sentry.io 检索和分析问题

Web 和浏览器自动化

  • Brave 搜索 - 使用 Brave 的搜索 API 进行网络和本地搜索
  • Fetch - 为 LLM 使用优化的网络内容获取和转换
  • Puppeteer - 浏览器自动化和网页抓取功能

生产力和通信

  • Slack - 频道管理和消息功能
  • Google Maps - 位置服务、方向和地点详情
  • Memory - 基于知识图谱的持久记忆系统

AI 和专业工具 EverArt - 使用各种模型的 AI 图像生成 Sequential Thinking -

mcpmodel-context-protocolmcp-servergithubgitlabpostgressqlitefilesystembrave-searchpuppeteer

LLM 推理在软件任务中扮演什么角色？

大型语言模型(LLM)的工作原理根植于模式匹配和对下一个词元的统计预测("随机鹦鹉")。从这种方法中产生的一个有些出人意料的能力是它们也能在一定程度上"推理"解决问题。有些模型的推理能力比其他模型更强，OpenAI的"o1"和"o3"模型是两个突出的推理模型，而DeepSeek的"R1"最近引起了很大轰动。但是当我们在编码任务中使用AI时，这种能力发挥什么作用呢？

剧透提醒：我还没有答案！但我有问题和想法。

我将从两个方面开始讨论，这两个方面在我的理解中是推理能力的限制，而且这些限制在编码环境中是相关的。然后我将分享我的想法，即推理在哪些编码任务中可能有用，在哪些任务中可能没用。

上下文至关重要，尤其是对推理而言

苹果公司去年发表的一篇关于大型语言模型推理局限性的论文引起了广泛关注。作者引入了一个新的基准测试，用来测试LLM在"数学推理"方面的能力。他们的基准测试基于一个已有的包含小学数学问题的测试集。他们选取了100个问题，将其转化为带有变量占位符的模板，然后为每个模板创建了50个变体，形成了一个包含5,000个问题的数据集。在第二步中，他们还创建了一个新的数据集，在问题中添加了无关信息。

他们发现：

llm-reasoningchain-of-thoughtsoftware-developmentcoding-assistantdebuggingplanningai-limitationscontext-engineeringgenerative-aireasoning-model

探索生成式人工智能

生成式人工智能和特别是大型语言模型（LLM）已迅速进入公众意识。像许多软件开发人员一样，我对其可能性感到好奇，但不确定它最终对我们的职业意味着什么。我现在在Thoughtworks担任一个角色，协调我们关于这项技术将如何影响软件交付实践的工作。我将在这里发布各种备忘录，描述我和同事们正在学习和思考的内容。

随着智能代理编码助手变得越来越强大，反应各不相同。有些人从最近的进步推断并声称，"一年后，我们将不再需要开发人员。"其他人则对AI生成代码的质量以及为初级开发人员准备应对这一变化的挑战表示担忧。

在过去几个月中，我定期使用Cursor、Windsurf和Cline中的智能代理模式，几乎完全用于更改现有代码库（而不是从头创建井字游戏）。总体而言，我对IDE集成的最新进展以及这些集成如何极大地提升工具辅助我的方式印象深刻。它们

  • 执行测试和其他开发任务，并尝试立即修复出现的错误
  • 自动识别并尝试修复代码检查和编译错误
  • 能够进行网络研究
  • 有些甚至集成了浏览器预览功能，可以捕获控制台错误或检查DOM元素

所有这些都带来了与AI令人印象深刻的协作会话，有时帮助我在创纪录的时间内构建功能和解决问题。

然而。

即使在那些成功的会话中，我也一直在干预、纠正和引导。而且我经常决定不提交更改。

generative-ai生成式AIllmai-coding-assistantagent-modecursorwindsurfclinecode-qualitysoftware-development