siweimofang/zhishe-a2a

README 摘要

知设 AI 装修顾问 (zhishe-a2a) 沈阳本地化装修报价 · 自建 Agent 版 通过 Google A2A 0.2.5 协议被千问 APP 调用 当前状态: V1.0 ✅ 跑通端到端 (2026/6/10 验证:28 个测试全绿,真对话调通 DeepSeek) 这是什么 一个 自建 FastAPI 服务 ,不是百炼里"创建智能体"。它通过 A2A 0.2.5 协议 暴露给千问 APP,千问发现你的 AgentCard 后主动调你。 30 秒跑起来 前置 - Python 3.11+ (项目用的是 3.11.9,装在 C:\Users\Administrator\AppData\Local\Programs\Python\Python311 ) - DeepSeek API Key (去 https://platform.deepseek.com 申请) 三步启动 看到 Application startup complete. Uvicorn running on http://127.0.0.1:8765 就 OK。 关键端点 端点 作用 验证命令 GET / 服务元信息 curl http://127.0.0.1:8765/ GET /.well-known/agent.json AgentCard(千问发现 Agent) curl http://127.0.0.1:8765/.well-known/agent.json POST /a2a/message/send 主路径 - JSON-RPC 同步调用 python examples\client basic.py POST /a2a/message/stream SSE 流式(V1.0 返回 -32601) — GET /health/ready LLM 就绪检查 curl http://127.0.0.1:8765/health/ready 配置文件 .env .env 不要 commit 到 git (已在 .gitignore )。 测试 当前测试覆盖(28 个) : - test protocol.py (11个) : A2A 协议层 - message/send、错误码、鉴权、LLM mock、JSON-RPC 解析 - test agents.py (15个) : AgentCard 结构、3 个 skill、配置加载、LLM 服务层 - test smoke.py : Mavis 写权限验证(非 pytest 风格,直接 python tests/test smoke.py 跑) 跑完预期: 28 passed 。 调通性验证(2026/6/10 实测) 项 结果 服务启动 ✅ PID 26520,端口 8765 监听中 GET / ✅ HTTP 200 GET /.we…

分类