a2a

分类: 数据库与数据存储 | 上传者: espennilsen | 下载: 0 | 版本: v1.0（最新）

通过 A2A 协议与远程代理进行通信，发现可用的代理，并通过 A2A Hub 向人类所有者请求澄清。当被要求向其他代理发送消息、发现可用的代理或需要人工输入才能继续时使用。 **触发器 — 在以下情况下使用此技能：** - 您需要人工输入才能继续（批准、决策、澄清） - 用户要求“向另一个代理发送消息” - 用户要求“发现代理”或“可用的代理” - 您遇到困难并需要升级给所有者 - 长期运行的任务需要人工批准才能继续 --- # A2A — 代理间通信和人机交互 ## 工具 |工具|目的| |------|---------| | `a2a_discover` |在集线器或静态注册表上查找远程代理 | | `a2a_发送` |按名称、ID 或 URL 向远程代理发送消息 | | `询问所有者` |问人类主人一个问题（非阻塞）| --- ## Ask_owner — 人机交互当您**在没有人工输入的情况下确实无法继续**时，请使用“ask_owner”。该工具将您的问题提交到中心并**立即返回** - 它不会阻止您的会话。当所有者响应时，会自动生成一个**新的 pi 子进程**，其中包含您的移交上下文 + 所有者的答案以继续工作。 ### 工作原理 1. 您使用问题 + 移交上下文调用 `ask_owner` 2. 问题被提交到 A2A Hub — 您会立即得到确认 3. 您继续其他工作或结束会话 4. 所有者通过中心的 Web UI 进行回答（可能在几分钟或几小时后） 5. 后台轮询器检测响应 6. 生成一个新的 `pi` 子进程，并带有一个独立的提示，其中包含： - 原始问题 -所有者的响应 - 您的完整移交上下文（已完成、剩余、决策等） 7. 新会话将从您上次停下的地方继续 - 不需要先前的对话上下文 ### 何时使用 - **需要批准** - 破坏性操作、合并 PR、部署 - **不明确的要求** - 多个值

更新日志: Source: GitHub https://github.com/espennilsen/pi

目录结构

当前层级: tree/main/extensions/pi-a2a/

📁 src/
- 📄 agent-card.ts 4.0 KB
- 📄 agent-executor.ts 17.4 KB
- 📄 client.ts 12.5 KB
- 📄 config.ts 2.6 KB
- 📄 hub.ts 15.0 KB
- 📄 index.ts 55.8 KB
- 📄 logger.ts 578 B
- 📄 server.ts 9.0 KB
- 📄 static-agents.ts 5.8 KB
- 📄 supervisor.ts 6.9 KB
- 📄 task-store.ts 11.9 KB
- 📄 types.ts 5.0 KB
📄 AGENTS.md 7.4 KB
📄 package-lock.json 163.6 KB
📄 package.json 901 B
📄 README.md 6.0 KB
📄 SKILL.md 6.1 KB
📄 tsconfig.json 270 B

SKILL.md

---
name: a2a
description: >
  Communicate with remote agents via A2A protocol, discover available agents,
  and ask the human owner for clarification via the A2A Hub. Use when asked
  to send messages to other agents, discover what agents are available, or
  when you need human input to proceed.

  **Triggers — use this skill when:**
  - You need human input to proceed (approval, decision, clarification)
  - User asks to "send a message to another agent"
  - User asks to "discover agents" or "what agents are available"
  - You're stuck and need to escalate to the owner
  - A long-running task needs human approval before continuing
---

# A2A — Agent-to-Agent Communication & Human-in-the-Loop

## Tools

| Tool | Purpose |
|------|---------|
| `a2a_discover` | Find remote agents on the hub or static registry |
| `a2a_send` | Send a message to a remote agent by name, ID, or URL |
| `ask_owner` | Ask the human owner a question (non-blocking) |

---

## ask_owner — Human-in-the-Loop

Use `ask_owner` when you **genuinely cannot proceed** without human input.
The tool submits your question to the hub and **returns immediately** — it
does NOT block your session. When the owner responds, a **fresh pi
subprocess** is automatically spawned with your handoff context + the
owner's answer to continue the work.

### How It Works

1. You call `ask_owner` with a question + handoff context
2. The question is submitted to the A2A Hub — you get an immediate confirmation
3. You continue with other work or end your session
4. The owner answers through the hub's web UI (could be minutes or hours later)
5. A background poller detects the response
6. A fresh `pi` subprocess is spawned with a self-contained prompt containing:
   - The original question
   - The owner's response
   - Your full handoff context (done, remaining, decisions, etc.)
7. The new session picks up where you left off — no prior conversation context needed

### When to Use

- **Approval needed** — destructive operations, merging PRs, deploying
- **Ambiguous requirements** — multiple valid approaches, unclear scope
- **Escalation** — blocked on something outside your control
- **Design decisions** — architectural choices with significant trade-offs

### When NOT to Use

- You can make a reasonable decision yourself
- The answer is in the codebase, docs, or context
- It's a minor style/formatting choice

### Always Include Handoff Context

**Every `ask_owner` call MUST include the `handoff` parameter.** The response
will be handled by a completely fresh session with zero prior context. Without
handoff context, the new session has no idea what to do.

```json
{
  "question": "The PR has conflicting review feedback — reviewer A wants JWT, reviewer B wants session tokens. Which approach should I take?",
  "handoff": {
    "done": [
      "Implemented Express server with route scaffolding",
      "Added user model with Kysely migrations",
      "PR #45 created on branch td-abc123/auth"
    ],
    "remaining": [
      "Implement auth middleware (blocked on JWT vs sessions decision)",
      "Write integration tests for auth endpoints",
      "Update API docs"
    ],
    "decisions": [
      "Using PostgreSQL via Kysely (not SQLite) for production readiness",
      "Argon2 for password hashing over bcrypt"
    ],
    "uncertain": [
      "JWT vs session tokens — conflicting reviewer feedback",
      "Whether to support OAuth2 providers in this PR or defer"
    ],
    "project": "my-api",
    "branch": "td-abc123/auth",
    "taskId": "td-abc123"
  },
  "priority": "normal"
}
```

### Handoff Fields

| Field | Required | Description |
|-------|----------|-------------|
| `done` | Yes | What's been completed — be specific (files, commits, PRs) |
| `remaining` | Yes | What still needs to be done — ordered by priority |
| `decisions` | If any | Key choices made and why |
| `uncertain` | If any | Open questions beyond the one being asked |
| `project` | Yes | Project name or absolute path to project root |
| `branch` | If applicable | Git branch being worked on |
| `taskId` | If applicable | td task ID |

### Priority Levels

| Priority | When to use |
|----------|-------------|
| `low` | Nice-to-know, no urgency |
| `normal` | Default — standard question |
| `urgent` | Blocking critical work, needs fast response |

### Poller Configuration

The background poller must be enabled in `settings.json` for responses to be
automatically processed:

```json
{
  "pi-a2a": {
    "poller": {
      "enabled": true,
      "intervalSeconds": 60,
      "extensions": ["extensions/pi-github", "extensions/pi-memory"],
      "skills": ["td", "github", "code-review"],
      "model": "claude-sonnet-4-5"
    }
  }
}
```

| Setting | Default | Description |
|---------|---------|-------------|
| `enabled` | `false` | Enable the poller |
| `intervalSeconds` | `60` | Poll interval (15–600) |
| `extensions` | `[]` | Extension paths for spawned subprocesses |
| `skills` | `[]` | Skill paths for spawned subprocesses |
| `model` | (default) | Model override for spawned subprocesses |

### Security Note

The poller spawns `pi` subprocesses with full tool access, using prompts
built entirely from hub-returned data (question, response, handoff context).
**Hub compromise = arbitrary code execution on the agent host.** Use HTTPS
for `hub.url` in production. The `handoff.project` path is validated (must
exist and be a directory) before being used as the subprocess working directory.

---

## a2a_discover — Find Agents

```json
{ "q": "search query", "tags": ["coding"], "category": ["development-tools"] }
```

All parameters are optional. Omit everything to list all agents.
Returns agent names, descriptions, skills, availability, and health status.

---

## a2a_send — Message an Agent

```json
{ "agent": "Agent Name", "message": "Your request here" }
```

The `agent` field accepts:
- Agent name (from `a2a_discover` results)
- Agent ID (UUID from hub)
- Direct URL (`https://...`)

The response arrives asynchronously — you'll see it when it comes back.
If the remote agent acknowledges but needs time, you'll get an ACK and the
full response arrives later as an inbound message.

登录后下载/点赞/收藏 ❤ 65 | ★ 0

a2a

目录结构

SKILL.md

举报内容

提示