昨天我們談到了 A2A 協議的宏大願景——讓不同的 AI Agent 像人類團隊一樣協作。但在現實世界裡，協作的前提是相互了解。你總不能對著陌生人說：「嘿，幫我做個複雜的資料分析！」對方的第一個反應肯定是：「你是誰？我能做什麼？你需要什麼權限？」

於是要請到今天的主角：Agent Card 登場。

從商務名片到數位名片的進化

想像一下，你參加一個大型商務聚會。每個人胸前都別著名片，上面寫著：

張三
資深軟體工程師
專精：Python、機器學習、資料分析
聯繫方式：+886-912-345-678
公司：台北科技股份有限公司

這張名片告訴你三件關鍵的事：他是誰、他會什麼、怎麼聯繫他。

Agent Card 就是 AI Agent 世界的數位名片，但比人類的名片複雜得多。因為 AI Agent 不只要說明身份，還要精確定義能力邊界、安全需求、溝通協議等技術細節。

六大核心要素

1. 身份介紹：我是誰？

{
  "protocolVersion": "0.3.0",
  "name": "智慧客服小幫手",
  "description": "專門處理客戶諮詢、訂單查詢和技術支援的 AI 助手",
  "version": "2.1.3",
  "provider": {
    "organization": "台北科技股份有限公司",
    "url": "https://www.taipeitech.com"
  }
}

就像人類的名片有姓名、職稱、公司一樣，Agent Card 的身份證明讓其他 Agent 知道「這是一個什麼樣的夥伴」。

2. 能力宣告：我會什麼？

{
  "skills": [
    {
      "id": "customer-inquiry-handler",
      "name": "客戶諮詢處理",
      "description": "處理一般客戶問題、產品諮詢、服務說明等",
      "tags": ["客服", "諮詢", "產品", "服務"],
      "examples": [
        "我想了解你們的退貨政策",
        "這個產品有哪些顏色可以選？",
        "如何申請會員卡？"
      ]
    },
    {
      "id": "order-tracker",
      "name": "訂單查詢系統",
      "description": "查詢訂單狀態、物流資訊、交貨時間等",
      "tags": ["訂單", "物流", "查詢", "狀態"],
      "examples": [
        "訂單編號 TW20241125001 現在到哪裡了？",
        "我的包裹什麼時候會到？"
      ]
    }
  ]
}

每個技能都像是一個「服務項目」，清楚說明：

• 能做什麼：詳細的功能描述
• 怎麼使用：實際的使用範例
• 關鍵字：方便搜尋和分類的標籤

3. 聯繫方式：怎麼找到我？

{
  "url": "https://customer-ai.taipeitech.com/a2a/v1",
  "preferredTransport": "JSONRPC",
  "additionalInterfaces": [
    {
      "url": "https://customer-ai.taipeitech.com/a2a/grpc", 
      "transport": "GRPC"
    },
    {
      "url": "https://customer-ai.taipeitech.com/a2a/rest", 
      "transport": "HTTP+JSON"
    }
  ]
}

這就像是提供多種聯絡方式：「你可以打電話、發簡訊或用 LINE 聯絡我，我比較喜歡用 LINE。」

4. 溝通能力：我們用什麼語言？

{
  "defaultInputModes": [
    "text/plain",           // 純文字
    "application/json",     // JSON 資料
    "image/jpeg",          // 圖片  
    "audio/mpeg"           // 語音
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json", 
    "text/html",           // 網頁格式
    "image/png"            // 圖表
  ]
}

這定義了「溝通的共同語言」。就像有些人喜歡文字訊息，有些人偏好語音通話，不同的 Agent 也有不同的「溝通偏好」。

5. 安全門禁：誰能跟我說話？

{
  "securitySchemes": {
    "googleAuth": {
      "type": "openIdConnect",
      "openIdConnectUrl": "https://accounts.google.com/.well-known/openid-configuration"
    },
    "apiKeyAuth": {
      "type": "apiKey",
      "name": "X-API-Key",
      "in": "header"
    },
    "bearerAuth": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "JWT"
    }
  },
  "security": [
    { "googleAuth": ["openid", "profile", "email"] },
    { "apiKeyAuth": [] },
    { "bearerAuth": [] }
  ]
}

這就像是門禁卡系統：「員工可以存取所有功能，客戶只能查詢自己的訂單。」

6. 特殊能力：我有什麼獨家服務？

{
  "capabilities": {
    "streaming": true,               // 支援即時串流對話
    "pushNotifications": true,       // 可以主動推播通知
  }
}

這標示了進階功能，就像名片上的「24小時服務」或「免費到府維修」等特色服務。

當你的 Agent 拿著一張設計精良的數位名片走向 AI 協作的大世界時，它不再是孤軍奮戰的個體，而是智慧生態系統中不可或缺的一員。

明天，我們將繼續探索 A2A 協作的更深層奧秘