Tutorial-Codebase-Knowledge项目解析：Google A2A协议中的Agent Card机制-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00392/article/details/148440045

Tutorial-Codebase-Knowledge项目解析：Google A2A协议中的Agent Card机制

Tutorial-Codebase-Knowledge Turns Codebase into Easy Tutorial with AI 项目地址: https://gitcode.com/gh_mirrors/tu/Tutorial-Codebase-Knowledge

引言：AI代理间的名片交换

在现代分布式AI系统中，各种功能各异的AI代理（Agent）需要相互协作完成任务。这就如同人类社会中的专业人士需要交换名片来建立联系一样，AI代理之间也需要一种标准化的"自我介绍"机制。这正是Google A2A（Agent-to-Agent）协议中Agent Card的设计初衷。

Agent Card的核心概念

什么是Agent Card？

Agent Card可以理解为AI代理的"数字名片"，它是一个标准化的JSON格式文件，通常命名为agent.json。这个文件包含了代理的基本信息、功能描述以及交互方式等关键元数据。

为什么需要Agent Card？

在分布式AI系统中，Agent Card主要解决三个核心问题：

发现机制：帮助其他代理或应用找到目标代理
能力描述：明确告知外界自己能做什么
交互规范：定义如何与自己进行通信

Agent Card的技术实现细节

文件结构与内容

一个典型的Agent Card包含以下关键字段：

{
  "name": "文本摘要专家",
  "description": "专业处理长文本摘要任务",
  "version": "1.2.0",
  "url": "http://text-summarizer.ai/a2a",
  "capabilities": {
    "streaming": false,
    "batchProcessing": true
  },
  "defaultInputModes": ["text", "markdown"],
  "defaultOutputModes": ["text", "json"],
  "skills": [
    {
      "id": "summarize_v1",
      "name": "文本摘要",
      "description": "将长文本压缩为关键摘要"
    }
  ],
  "provider": {
    "organization": "智能文本处理实验室"
  }
}

技术实现要点

标准化路径：Agent Card通常存放在/.well-known/agent.json路径下，这是遵循互联网标准惯例的做法。
HTTP协议交互：通过简单的HTTP GET请求即可获取Agent Card信息。
版本控制：version字段确保客户端能识别代理的版本变化。
能力描述：
- capabilities字段描述高级功能支持
- skills字段列举具体能力
- input/output modes定义数据格式

实际应用示例

Python实现Agent Card获取

以下是使用Python获取并解析Agent Card的典型实现：

import requests
from dataclasses import dataclass
from typing import List, Dict, Optional

@dataclass
class Skill:
    id: str
    name: str
    description: str

@dataclass
class Provider:
    organization: str

@dataclass
class AgentCard:
    name: str
    description: str
    version: str
    url: str
    capabilities: Dict[str, bool]
    defaultInputModes: List[str]
    defaultOutputModes: List[str]
    skills: List[Skill]
    provider: Provider

def fetch_agent_card(agent_base_url: str) -> AgentCard:
    """获取并解析Agent Card"""
    card_url = f"{agent_base_url}/.well-known/agent.json"
    try:
        response = requests.get(card_url, timeout=5)
        response.raise_for_status()
        return AgentCard(**response.json())
    except requests.exceptions.RequestException as e:
        raise ValueError(f"获取Agent Card失败: {str(e)}")

# 使用示例
try:
    card = fetch_agent_card("http://example-agent.com")
    print(f"成功获取代理: {card.name}")
    print(f"支持技能: {[skill.name for skill in card.skills]}")
except ValueError as e:
    print(e)