agent-communication-protocol

分类: 工具与效率 | 上传者: Kickflip73 | 下载: 0 | 版本: v1.0（最新）

**任意两个 Agent 建立直接通信。零注册、零配置、框架无关。**

更新日志: Source: GitHub https://github.com/Kickflip73/agent-communication-protocol

目录结构

当前层级: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 docker-publish.yml 4.2 KB
  - 📄 docs.yml 928 B
📁 acp-research/
- 📁 reports/
  - 📄 2026-03-19-a2a-evening-scan.md 2.2 KB
  - 📄 2026-03-19-late-scan.md 1.7 KB
  - 📄 2026-03-21-a2a-scan.md 2.7 KB
  - 📄 2026-03-21-research-scan.md 3.7 KB
  - 📄 2026-03-21-research.md 1.6 KB
  - 📄 2026-03-22-a2a-heartbeat-agent.md 2.7 KB
  - 📄 2026-03-22-a2a-issue-1667-update.md 3.7 KB
  - 📄 2026-03-22-did-acp-design.md 4.3 KB
  - 📄 2026-03-24-scan.md 3.6 KB
  - 📄 2026-03-24-scan2.md 2.6 KB
  - 📄 2026-03-24-scan3.md 2.6 KB
  - 📄 2026-03-24-scan4.md 4.6 KB
  - 📄 2026-03-25-scan-3.md 2.5 KB
  - 📄 2026-03-25-scan.md 2.6 KB
  - 📄 2026-03-25-scan2.md 2.6 KB
  - 📄 2026-03-25-scan3.md 2.3 KB
  - 📄 2026-03-26-scan.md 3.8 KB
  - 📄 2026-03-26-scan2.md 5.0 KB
  - 📄 2026-03-26-scan3.md 922 B
  - 📄 2026-03-26-scan4.md 4.1 KB
  - 📄 2026-03-28-scan.md 5.9 KB
  - 📄 2026-03-29-scan.md 4.4 KB
  - 📄 2026-03-30-scan.md 4.0 KB
  - 📄 2026-03-31-evening-scan.md 6.3 KB
  - 📄 2026-03-31-scan.md 2.4 KB
  - 📄 2026-04-01-scan.md 3.8 KB
  - 📄 2026-04-02-afternoon-scan.md 4.8 KB
  - 📄 2026-04-02-evening-scan.md 2.5 KB
  - 📄 2026-04-02-morning-scan.md 3.5 KB
  - 📄 2026-04-02-night-scan.md 3.5 KB
  - 📄 2026-04-02-scan.md 2.2 KB
  - 📄 2026-04-03-scan.md 4.8 KB
  - 📄 2026-04-05-scan-2.md 5.7 KB
  - 📄 2026-04-05-scan.md 4.5 KB
  - 📄 2026-04-05-scan2.md 4.4 KB
  - 📄 2026-04-06-scan.md 4.0 KB
  - 📄 2026-04-06-scan10.md 4.1 KB
  - 📄 2026-04-06-scan11.md 5.2 KB
  - 📄 2026-04-06-scan2.md 5.6 KB
  - 📄 2026-04-06-scan3.md 4.9 KB
  - 📄 2026-04-06-scan4.md 5.5 KB
  - 📄 2026-04-06-scan5.md 7.3 KB
  - 📄 2026-04-06-scan8.md 5.4 KB
  - 📄 2026-04-06-scan9.md 6.4 KB
- 📄 ROADMAP.md 45.7 KB
📁 adrs/
- 📄 adr-001-p2p-relay-architecture.md 2.6 KB
- 📄 adr-002-no-oauth-ed25519-only.md 2.8 KB
- 📄 adr-003-event-replay-since-seq.md 3.5 KB
- 📄 adr-004-jwks-compat-layer.md 6.6 KB
- 📄 adr-template.md 615 B
📁 docs/
- 📁 assets/
  - 📄 extra.css 685 B
- 📁 blog/
  - 📄 2026-03-23-acp-v1-3-announcement.md 4.8 KB
  - 📄 2026-03-23-hn-post-draft.md 3.7 KB
  - 📄 2026-03-24-hn-post-final.md 7.2 KB
  - 📄 index.md 281 B
- 📁 getting-started/
  - 📄 concepts.md 4.4 KB
  - 📄 installation.md 3.2 KB
  - 📄 quickstart.md 2.9 KB
- 📁 guides/
  - 📄 team-collaboration.md 4.0 KB
  - 📄 two-agents.md 2.9 KB
- 📁 spec/
  - 📄 core-v0.8.md 16.7 KB
  - 📄 nat-traversal-v1.4.md 15.6 KB
  - 📄 peer-trust-v2.34.md 9.7 KB
  - 📄 transports.md 13.4 KB
  - 📄 typing-indicator-v2.37.md 8.5 KB
- 📄 architecture.md 2.6 KB
- 📄 benchmark-2026-03-23.md 4.9 KB
- 📄 CHANGELOG.md 94.1 KB
- 📄 cli-reference.md 15.9 KB
- 📄 comparison.md 8.8 KB
- 📄 compatibility-matrix.md 7.9 KB
- 📄 conformance.md 9.2 KB
- 📄 index.md 4.7 KB
- 📄 integration-guide.md 26.8 KB
- 📄 nat-traversal.md 9.7 KB
- 📄 openapi-skills.yaml 52.5 KB
- 📄 README.zh-CN.md 19.2 KB
- 📄 ROADMAP.md 36.1 KB
- 📄 security.md 8.5 KB
- 📄 show-hn-draft.md 12.4 KB
- 📄 whats-new.md 29.7 KB
📁 examples/
- 📁 orchestrator-workers/
  - 📄 demo.py 4.3 KB
- 📁 quickstart/
  - 📄 agent_summarizer.py 3.7 KB
  - 📄 demo_two_agents.py 3.6 KB
  - 📄 orchestrator.py 5.9 KB
📁 gateway/
- 📄 docker-compose.yml 476 B
- 📄 Dockerfile 335 B
- 📄 server.py 9.7 KB
📁 p2p/
- 📁 examples/
  - 📄 demo_group.py 5.5 KB
  - 📄 demo_lifecycle.py 5.6 KB
  - 📄 demo_p2p.py 5.0 KB
- 📁 sdk/
  - 📄 __init__.py 0 B
  - 📄 acp_p2p.py 24.4 KB
- 📁 spec/
  - 📄 acp-p2p-v0.1.md 5.2 KB
  - 📄 acp-p2p-v0.1.zh.md 8.5 KB
📁 relay/
- 📁 examples/
  - 📄 config-relay.json 91 B
  - 📄 config-secure.yaml 219 B
  - 📄 config.json 137 B
- 📁 references/
  - 📄 modes.md 3.5 KB
- 📄 acp_relay.py 546.9 KB
- 📄 acp_worker.js 12.5 KB
- 📄 identity.py 12.9 KB
- 📄 py.typed 0 B
- 📄 SKILL.md 201 B
📁 research/
- 📁 reports/
  - 📄 2026-03-19-a2a-deep-dive.md 8.3 KB
  - 📄 2026-03-19-queryskill-analysis.md 3.7 KB
  - 📄 2026-03-20-a2a-afternoon-scan.md 3.7 KB
  - 📄 2026-03-20-a2a-evening-scan.md 3.9 KB
  - 📄 2026-03-20-a2a-morning-scan.md 2.6 KB
  - 📄 2026-03-20-a2a-night-scan.md 3.8 KB
  - 📄 2026-03-20-a2a-noon-scan.md 3.4 KB
  - 📄 2026-03-20-aps-ed25519-analysis.md 5.4 KB
  - 📄 2026-03-20-morning-scan.md 2.9 KB
- 📁 weekly/
  - 📄 2026-03-25-weekly-scan.md 1.1 KB
  - 📄 2026-04-01-weekly-scan-analysis.md 5.0 KB
  - 📄 2026-04-01-weekly-scan.md 1.2 KB
  - 📄 2026-04-03-weekly-scan.md 5.3 KB
- 📄 2026-03-18-competitive-analysis.md 4.0 KB
- 📄 2026-03-18-protocol-landscape-v2.md 7.1 KB
- 📄 RESEARCH-PROTOCOL.md 1.5 KB
- 📄 ROADMAP.md 15.2 KB
📁 scripts/
- 📄 gen_changelog.py 5.2 KB
📁 sdk/
- 📁 go/
  - 📁 acprelay/
    
    📄 client.go 9.0 KB
    
    📄 client_test.go 8.7 KB
    
    📄 stream.go 4.5 KB
    
    📄 stream_test.go 6.5 KB
  - 📄 go.mod 74 B
  - 📄 README.md 2.2 KB
- 📁 java/
  - 📁 src/
    
    📁 main/
    
    📁 java/
    
    📁 dev/
    
    📁 acp/
    
    📁 relay/
    
    📄 AcpException.java 1.2 KB
    
    📄 Json.java 10.6 KB
    
    📄 Message.java 1.8 KB
    
    📄 Part.java 3.0 KB
    
    📄 RelayClient.java 19.7 KB
    
    📄 SendRequest.java 4.7 KB
    
    📄 SendResponse.java 1.2 KB
    
    📄 SseEvent.java 746 B
    
    📄 Task.java 1.2 KB
    
    📁 test/
    
    📁 java/
    
    📁 dev/
    
    📁 acp/
    
    📁 relay/
    
    📄 AcpJavaSmokeTest.java 5.8 KB
    
    📄 JsonTest.java 5.0 KB
    
    📄 RelayClientTest.java 14.2 KB
  - 📁 target/
    
    📁 classes/
    
    📁 dev/
    
    📁 acp/
    
    📁 relay/
    
    📄 AcpException.class 962 B
    
    📄 Json$Parser.class 4.8 KB
    
    📄 Json.class 5.5 KB
    
    📄 Message.class 3.4 KB
    
    📄 Part$Builder.class 897 B
    
    📄 Part.class 2.1 KB
    
    📄 RelayClient.class 14.1 KB
    
    📄 SendRequest$Builder.class 1.6 KB
    
    📄 SendRequest.class 2.7 KB
    
    📄 SendResponse.class 1.5 KB
    
    📄 SseEvent.class 1019 B
    
    📄 Task.class 1.5 KB
    
    📁 test-classes/
    
    📁 dev/
    
    📁 acp/
    
    📁 relay/
    
    📄 JsonTest.class 4.7 KB
    
    📄 RelayClientTest.class 14.2 KB
  - 📄 pom.xml 3.1 KB
  - 📄 README.md 6.9 KB
- 📁 node/
  - 📁 src/
    
    📄 index.d.ts 5.8 KB
    
    📄 index.js 569 B
    
    📄 index.mjs 621 B
    
    📄 relay_client.js 24.0 KB
  - 📁 tests/
    
    📄 relay_client.test.js 29.8 KB
  - 📄 .npmignore 125 B
  - 📄 LICENSE 755 B
  - 📄 package.json 1.2 KB
  - 📄 README.md 4.5 KB
- 📁 python/
  - 📁 acp_client/
    
    📁 integrations/
    
    📄 __init__.py 316 B
    
    📄 langchain.py 13.2 KB
    
    📄 __init__.py 2.1 KB
    
    📄 _cli.py 4.3 KB
    
    📄 async_client.py 17.2 KB
    
    📄 client.py 18.8 KB
    
    📄 exceptions.py 3.7 KB
    
    📄 models.py 18.5 KB
  - 📁 acp_sdk/
    
    📁 integrations/
    
    📄 __init__.py 90 B
    
    📄 autogen.py 3.6 KB
    
    📄 fastapi_middleware.py 4.5 KB
    
    📄 langchain.py 5.1 KB
    
    📄 __init__.py 416 B
    
    📄 agent.py 4.1 KB
    
    📄 bus.py 2.6 KB
    
    📄 client.py 2.5 KB
    
    📄 message.py 5.5 KB
    
    📄 relay_client.py 42.4 KB
  - 📁 tests/
    
    📄 test_async_relay_client.py 12.7 KB
    
    📄 test_langchain_integration.py 23.5 KB
    
    📄 test_message.py 2.9 KB
    
    📄 test_relay_client.py 6.1 KB
    
    📄 test_relay_client_v17.py 12.7 KB
    
    📄 test_sdk_package.py 20.7 KB
    
    📄 test_v23_features.py 13.5 KB
  - 📄 pyproject.toml 2.0 KB
  - 📄 README-sdk.md 14.1 KB
  - 📄 setup.py 1.4 KB
- 📁 rust/
  - 📁 src/
    
    📄 lib.rs 13.4 KB
  - 📄 Cargo.toml 775 B
  - 📄 README.md 5.0 KB
📁 spec/
- 📄 auth-evaluation.md 7.2 KB
- 📄 compatibility-certification.md 5.9 KB
- 📄 core-v0.1.md 11.2 KB
- 📄 core-v0.1.zh.md 16.2 KB
- 📄 core-v0.5.md 12.2 KB
- 📄 core-v0.8.md 16.7 KB
- 📄 core-v1.0.md 45.1 KB
- 📄 core-v1.3.md 18.5 KB
- 📄 error-codes.md 4.3 KB
- 📄 identity-v0.8.md 7.3 KB
- 📄 identity-v1.5.md 3.0 KB
- 📄 identity-v2.0.md 10.4 KB
- 📄 identity.md 745 B
- 📄 nat-traversal-v1.4.md 15.6 KB
- 📄 README.md 5.2 KB
- 📄 transports.md 16.3 KB
- 📄 transports.zh.md 14.1 KB
- 📄 v0.6-minimal-agent.md 7.2 KB
- 📄 v0.8-planning.md 5.3 KB
- 📄 v1.0-planning.md 5.3 KB
📁 tests/
- 📁 cert/
  - 📄 test_level1.py 10.4 KB
- 📁 compat/
  - 📄 compat_base.py 3.9 KB
  - 📄 README.md 2.3 KB
  - 📄 run.py 4.9 KB
  - 📄 test_agentcard.py 3.9 KB
  - 📄 test_error_codes.py 3.0 KB
  - 📄 test_hmac.py 3.0 KB
  - 📄 test_message_send.py 6.6 KB
  - 📄 test_peers.py 3.1 KB
  - 📄 test_query_skills.py 1.2 KB
  - 📄 test_stream.py 10.5 KB
  - 📄 test_tasks.py 4.7 KB
- 📁 integration/
  - 📄 conftest.py 3.6 KB
  - 📄 test_relay_integration.py 14.3 KB
- 📁 unit/
  - 📄 test_relay_core.py 46.2 KB
  - 📄 test_transport_modes_v24.py 11.7 KB
- 📄 conftest.py 3.7 KB
- 📄 helpers.py 708 B
- 📄 run_scenario_ab_test.py 20.5 KB
- 📄 run_scenario_cd_heartbeat.py 23.0 KB
- 📄 scenario_b_team.py 8.2 KB
- 📄 scenario_c_pipeline.py 18.8 KB
- 📄 test_agentcard_limitations.py 8.3 KB
- 📄 test_availability.py 11.0 KB
- 📄 test_availability_schedule.py 11.0 KB
- 📄 test_b_three_agents.py 9.3 KB
- 📄 test_broadcast.py 11.0 KB
- 📄 test_broadcast_v23.py 11.7 KB
- 📄 test_bug037_messages_received.py 13.3 KB
- 📄 test_caller_signature.py 14.3 KB
- 📄 test_capabilities_groups.py 14.9 KB
- 📄 test_capability_token.py 10.3 KB
- 📄 test_card_signature.py 11.8 KB
- 📄 test_concurrent.py 21.8 KB
- 📄 test_concurrent_and_integration.py 20.9 KB
- 📄 test_context_id_sse.py 8.1 KB
- 📄 test_context_query.py 11.8 KB
- 📄 test_dcutr.py 31.2 KB
- 📄 test_dcutr_t1_stun.py 5.9 KB
- 📄 test_dcutr_t2_messages.py 10.2 KB
- 📄 test_dcutr_t3_fallback.py 6.2 KB
- 📄 test_dcutr_t4_handshake.py 11.5 KB
- 📄 test_dcutr_t6_scenario_a.py 15.9 KB
- 📄 test_delegation_chain.py 11.9 KB
- 📄 test_delivery_ack.py 12.7 KB
- 📄 test_direct_message.py 16.8 KB
- 📄 test_effective_tier.py 10.2 KB
- 📄 test_event_replay.py 18.3 KB
- 📄 test_extensions.py 18.8 KB
- 📄 test_external_token_verify.py 14.6 KB
- 📄 test_failed_msg_id.py 5.9 KB
- 📄 test_governance_metadata.py 14.6 KB
- 📄 test_http2_transport.py 11.3 KB
- 📄 test_identity.py 22.5 KB
- 📄 test_import_evidence.py 17.3 KB
- 📄 test_interaction_records.py 11.9 KB
- 📄 test_ir_test_vectors.py 17.6 KB
- 📄 test_jwks.py 11.8 KB
- 📄 test_lan_discovery.py 9.1 KB
- 📄 test_limitations.py 12.3 KB
- 📄 test_limitations_patch.py 10.1 KB
- 📄 test_limitations_structured.py 12.6 KB
- 📄 test_message_dedup.py 13.1 KB
- 📄 test_message_priority.py 11.4 KB
- 📄 test_messages_list.py 23.2 KB
- 📄 test_nat_http_reflect.py 8.4 KB
- 📄 test_nat_integration.py 15.4 KB
- 📄 test_nat_signaling.py 10.4 KB
- 📄 test_nat_traversal_integration.py 13.7 KB
- 📄 test_offline_queue.py 9.9 KB
- 📄 test_peer_card.py 8.7 KB
- 📄 test_peer_card_verify.py 13.0 KB
- 📄 test_peer_message_history.py 14.5 KB
- 📄 test_peer_ping.py 15.3 KB
- 📄 test_peer_trust.py 13.0 KB
- 📄 test_peer_verify_card.py 7.6 KB
- 📄 test_peers_pagination.py 10.0 KB
- 📄 test_principal_chain.py 8.4 KB
- 📄 test_pubkey_discovery.py 7.2 KB
- 📄 test_queryskill_constraints.py 17.9 KB
- 📄 test_read_receipt.py 12.2 KB
- 📄 test_reconnect.py 29.4 KB
- 📄 test_recv_long_poll.py 14.6 KB
- 📄 test_round12_b.py 19.1 KB
- 📄 test_round12_c.py 18.9 KB
- 📄 test_round_20260328.py 16.0 KB
- 📄 test_scenario_ab.py 15.9 KB
- 📄 test_scenario_bc.py 15.3 KB
- 📄 test_scenario_d.py 10.0 KB
- 📄 test_scenario_d_stress.py 17.5 KB
- 📄 test_scenario_e.py 11.8 KB
- 📄 test_scenario_fg.py 12.0 KB
- 📄 test_scenario_h.py 9.8 KB
- 📄 test_skill_authorization_tier.py 13.6 KB
- 📄 test_skill_limitations.py 9.3 KB
- 📄 test_skill_limitations_patch.py 10.8 KB
- 📄 test_skill_param_constraints.py 14.9 KB
- 📄 test_skill_rate_limit.py 12.4 KB
- 📄 test_skill_status.py 8.1 KB
- 📄 test_skills_list.py 22.9 KB
- 📄 test_skills_openapi.py 6.2 KB
- 📄 test_supported_transports.py 3.6 KB
- 📄 test_t3_human_confirmation.py 16.7 KB
- 📄 test_task_cancel.py 18.2 KB
- 📄 test_task_event_sequence.py 27.2 KB
- 📄 test_task_rejected.py 13.3 KB
- 📄 test_tasks_filtering.py 9.0 KB
- 📄 test_tasks_list.py 16.7 KB
- 📄 test_tasks_pagination.py 18.8 KB
- 📄 test_three_level_connection.py 12.4 KB
- 📄 test_trust_signals.py 7.6 KB
- 📄 test_typing_indicator.py 10.2 KB
- 📄 test_v15_hybrid_identity.py 6.0 KB
- 📄 test_v252_audit_deprecation.py 22.6 KB
- 📄 test_verify_card_v2.py 10.2 KB
- 📄 test_well_known_headers.py 4.9 KB
- 📄 test_ws_stream.py 16.9 KB
- 📄 test_wtrmrk_attestation.py 15.8 KB
📄 .dockerignore 143 B
📄 .gitignore 69 B
📄 acp_diag.sh 5.4 KB
📄 acp_diag2.sh 1.8 KB
📄 BUGS.md 69.2 KB
📄 CHANGELOG.md 156.5 KB
📄 CONTRIBUTING.md 1.3 KB
📄 CONTRIBUTING.zh.md 2.3 KB
📄 docker-compose.yml 2.7 KB
📄 Dockerfile 3.4 KB
📄 heartbeat-state.json 303 B
📄 heartbeat_cd_results.json 336 B
📄 LICENSE 755 B
📄 mkdocs.yml 3.2 KB
📄 pyproject.toml 3.7 KB
📄 README.md 36.8 KB
📄 SKILL.md 5.1 KB

SKILL.md

# ACP — Agent Communication Protocol

**任意两个 Agent 建立直接通信。零注册、零配置、框架无关。**

> **本文档会持续更新。遇到问题请重新拉取最新版本再重试。**
> 文档地址：`https://raw.githubusercontent.com/Kickflip73/agent-communication-protocol/main/SKILL.md`

---

## 接入 SOP（每个 Agent 都执行相同步骤，无发起方/接入方之分）

### Step 1 — 安装依赖

```bash
pip install websockets
```

---

### Step 2 — 下载最新脚本（每次都重新下载，确保是最新版）

```bash
curl -sO https://raw.githubusercontent.com/Kickflip73/agent-communication-protocol/main/relay/acp_relay.py
```

---

### Step 3 — 启动通信服务

**后台启动，等待就绪：**

```bash
python3 acp_relay.py --name "你的Agent名" &
sleep 3
curl -s http://localhost:7901/status
```

启动成功后状态返回：
```json
{"connected": false, "link": "acp://IP:PORT/tok_xxx", "agent_name": "你的Agent名"}
```

---

### Step 4 — 拿到链接，发给对方

```bash
curl -s http://localhost:7901/link
```

返回：
```json
{"link": "acp://1.2.3.4:7801/tok_xxxxxx"}
```

**⚠️ 必须：把 `link` 的值发给对方 Agent。**

同时，如果对方也发来了链接，执行：

```bash
curl -s -X POST http://localhost:7901/connect \
  -H "Content-Type: application/json" \
  -d '{"link": "对方发来的链接"}'
```

**两个 Agent 各自启动、各自发链接、各自连对方，对等操作，没有主从之分。**

---

### Step 5 — 等待连接建立

轮询直到 `connected: true`：

```bash
curl -s http://localhost:7901/status
```

成功返回：
```json
{
  "connected": true,
  "peer_card": {"name": "对方Agent名", "skills": [...]},
  "session_id": "sess_xxxxxx"
}
```

---

### Step 6 — 启动消息监听（常驻后台，不能漏消息）

消息是**实时推送**的，必须用常驻进程持续监听，不能用轮询：

```bash
# 后台监听，消息写入日志
curl -sN http://localhost:7901/stream >> /tmp/acp_messages.log 2>&1 &
echo "监听已启动 PID=$!"
```

**用 Python 实时处理消息（推荐）：**

```python
import urllib.request, json

def listen_forever():
    """阻塞运行，有消息立刻触发 handle_message()"""
    with urllib.request.urlopen("http://localhost:7901/stream") as resp:
        for line in resp:
            line = line.decode().strip()
            if line.startswith("data:"):
                msg = json.loads(line[5:].strip())
                handle_message(msg)

def handle_message(msg):
    print(f"[{msg.get('from')}] {msg.get('text')}")
    # 根据消息决定是否回复
    reply = your_agent_logic(msg)
    if reply:
        send_message(reply)

def send_message(text):
    data = json.dumps({"text": text}).encode()
    req = urllib.request.Request(
        "http://localhost:7901/message:send", data=data,
        headers={"Content-Type": "application/json"}
    )
    urllib.request.urlopen(req)

listen_forever()  # 持续阻塞，永不退出
```

---

### Step 7 — 发消息

```bash
curl -s -X POST http://localhost:7901/message:send \
  -H "Content-Type: application/json" \
  -d '{"text": "你好！"}'
```

返回 `{"ok": true}` 即成功。

---

### Step 8 — 连接保活（心跳，每 60 秒一次）

心跳**只检查连接是否还活着**，消息由 Step 6 的 SSE 监听负责：

```bash
curl -s http://localhost:7901/status | python3 -c \
  "import json,sys; d=json.load(sys.stdin); print('OK' if d.get('connected') else 'RECONNECT')"
```

返回 `RECONNECT` 时，重新执行 Step 2-4 即可。

---

## 网络受限时（沙箱/K8s/NAT）

如果对方链接是 `acp://` 但连不上，改用公共中继：

```bash
# 停掉旧服务
pkill -f "acp_relay.py"
sleep 1
# 重新启动，走中继
python3 acp_relay.py --name "你的Agent名" --relay &
sleep 3
curl -s http://localhost:7901/link
```

返回 `acp+wss://...` 格式的链接，发给对方。对方收到后同样用 Step 4 的 `/connect` 接入，操作完全一致。

---

## API 快速索引

| 功能 | 方法 | 路径 | 说明 |
|------|------|------|------|
| 查状态 | GET | `/status` | `connected` / `peer_card` / `link` |
| 获取本机链接 | GET | `/link` | 返回 `{"link": "acp://..."}` |
| 主动连接对方 | POST | `/connect` | body: `{"link": "对方链接"}` |
| 发消息 | POST | `/message:send` | body: `{"text": "..."}` 或任意 JSON |
| 实时收消息 | GET | `/stream` | SSE 长连接，永久阻塞 |
| 取收件箱 | GET | `/inbox` | 返回历史消息列表 |

HTTP 接口默认端口：`localhost:7901`（`--port 7802` 时为 `7902`）

---

## 核心红线

- **Step 2 每次都重新下载** — 确保脚本是最新版，旧版可能有 bug
- **Step 6 必须常驻运行** — 消息实时推送，不能用轮询代替
- **Step 4 两边都要互发链接** — 不分主从，各自连对方
- **connected: false 时不要发消息** — 会静默失败

---

## 底层传输（Agent 无需关心）

`acp_relay.py` 自动选择：P2P 直连（首选）→ 收不到则自动走 HTTP 中继（降级）。链接格式不同，操作完全一样。

---

## 完整文档 & 源码

https://github.com/Kickflip73/agent-communication-protocol

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

agent-communication-protocol

目录结构

SKILL.md

举报内容

提示