名称： agent-contact-card
描述： 发现并创建 Agent 联系卡片——一种类似 vCard 的 AI 代理联系方式格式。当需要查找如何联系某人的代理，或帮助用户在其域名下的 /.well-known/agent-card 设置自己的代理联系信息时使用。
许可证： CC0-1.0
元数据：
author: davedean
version: "1.0"
homepage: https://github.com/davedean/agent-contact-card

Agent 联系卡片

一种用于发布 AI 代理联系方式的简单格式。类似于 vCard，但专为代理设计。

使用场景

• 用户询问如何让其他代理联系自己的代理
• 用户希望查找如何联系他人的代理
• 你需要代表用户联系另一个代理
• 用户提及“agent-card”、“agent contact”或代理间通信

快速参考

发现 Agent 联系卡片

尝试在其域名下获取 /.well-known/agent-card：

https://example.com/.well-known/agent-card

该文件为包含 YAML 前置元数据的 Markdown 文件。解析前置元数据以获取结构化通道信息，阅读正文了解路由规则。

创建 Agent 联系卡片

创建一个包含 YAML 前置元数据的 Markdown 文件：

---
**版本：** "1"
human_contact: "+1 555 123 4567"
channels:
  email: "agent@example.com"
  discord: "my-agent#1234"
  webhook:
    url: "https://example.com/agent/incoming"
    method: "POST"
    format: "JSON with 'message' field"
capabilities:
  - scheduling
  - accepts_ical
---

# 我的代理

如果您是人类，请拨打上方电话。

如果您是代理：
- 预约请求，请使用 Discord
- 紧急事务，请在邮件主题中注明“URGENT”
- 响应时间：几小时内

将此文件托管在用户域名的 /.well-known/agent-card 路径下。

格式详情

必填字段

推荐字段

可选字段

通道

通道名称可自由定义。常见的有：

• email - 电子邮件地址
• discord - Discord 用户名
• webhook - 用于结构化消息的 HTTP 端点
• signal - Signal 电话号码
• telegram - Telegram 用户名

对于 webhook，需提供详细信息：

channels:
  webhook:
    url: "https://example.com/agent/incoming"
    method: "POST"
    auth: "Authorization 头中的 Bearer 令牌"
    format: "包含 'message' 和 'from' 字段的 JSON"

多代理设置

可列出多个专用代理：

agents:
  - name: "日历代理"
    handles: ["scheduling", "availability"]
    channel: discord
    id: "cal-agent#1234"
  - name: "支持代理"
    handles: ["technical questions"]
    channel: webhook
    id: "https://example.com/support"

Markdown 正文应解释它们之间的路由规则。

隐私层级

不同访问级别对应不同 URL 模式：

每个层级可暴露不同的通道和功能。

发现方法

1. Well-known URL：检查 https://domain/.well-known/agent-card
2. vCard 扩展：在联系卡片中查找 X-AGENT-CARD 字段
3. 询问本人：直接请求 URL

读取 Agent 卡片

获取 Agent 卡片时：

1. 解析 YAML 前置元数据获取结构化数据
2. 阅读 Markdown 正文了解自然语言路由规则
3. 根据您的目的选择合适的通道
4. 遵循提及的任何身份验证要求

测试示例

以下是一个可测试的实时演示：

https://city-services-api.dave-dean.workers.dev/.well-known/agent-card

这是一个虚构的“Millbrook 市”热线。获取卡片后，尝试向 webhook 端点发送 POST 请求。您的体验可能因发送内容而异。

完整规范

完整规范请参阅 references/SPEC.md。

示例

更多完整示例请参阅 references/EXAMPLES.md。