aip-facade · 个人金融治理助手

AIC2026「智能体互联」赛题 · ACPs/AIP Partner 智能体 · 梧桐智能体互联平台已注册上线

---

面向个人基金 / ETF / REITs 持仓治理场景的 Partner 智能体：七项能力挂载 AIP 国标协议，全部返回合成数据（synthetic=true），仅用于智能体互联演示与评测，不构成投资建议。

能力清单

skill id	能力	实现方式
aip_facade.portfolio-snapshot	持仓快照查询	合成数据集＋按日种子随机游走
aip_facade.portfolio-diagnose	持仓体检	规则引擎（集中度/偏离度/类型相关性）
aip_facade.news-query	财经资讯检索	合成语料关键词检索
aip_facade.news-digest	资讯摘要解读	LLM（OpenAI 兼容接口）＋合成语料
aip_facade.coach-ask	调仓教练问答	LLM（教练 persona，不给个股/时点建议）
aip_facade.risk-alert	风险警报查询	规则引擎（偏离度/回撤阈值）
aip_facade.agent-capabilities	能力自描述	ACS 镜像＋版本与能力成长日志

架构

flowchart LR
    subgraph 平台侧
        L[Leader / 评测方] -->|mTLS JSON-RPC| F
        F[facade.velno.top:443] 
        R[Kafka 上报器] -->|amp.* 六类日志| K[wt.ioa.pub:19092]
    end
    subgraph VPS
        F --> RT[FacadeRunner<br/>关键词路由＋任务表]
        RT --> SK[skills_impl<br/>5×规则/检索＋2×LLM]
        SK --> D[(合成数据<br/>facade/data)]
        SK --> LLM[LLM API]
        F --> LOG[/logs/amp_*.jsonl/]
        LOG --> R
    end

Loading

• 协议层：ACPs SDK（AIP v02.02），/rpc 单端点承载 Start→Complete 任务全生命周期
• 安全层：平台 CA（ACME/EAB）签发的 mTLS 双证书——serverAuth 用于对外服务、clientAuth 用于出站
• 可观测：SDK 六类 AMP Emitter 落盘 NDJSON → tools/kafka_reporter.py 增量 tail 上报平台 Kafka（offset 持久化，不重发不丢行）；access 日志 correlationId=taskId 对齐平台排行榜口径
• 部署：境外 VPS 直挂公网 443（自家域名 DNS-only），systemd 双服务（facade＋reporter）开机自启、崩溃自愈

为什么不用 CDN/隧道：ACPs 调用方以平台 trust-bundle 验证服务端证书，TLS 必须由 Agent CA 证书在源头终结——边缘终结会同时破坏双向身份。

快速开始

# 本地开发（明文 HTTP，无需证书）
cp .env.example .env      # 填 PARTNER_LLM_*；不填则两个 LLM 技能降级提示，其余正常
uv sync
uv run python -m facade.main          # http://127.0.0.1:9107
./tools/healthcheck.sh                # 七接口 Start→Complete 自检
uv run python tools/rollup.py         # logs/requests.jsonl → logs/daily.csv
uv run python tools/acs_lint.py       # ACS 六条隐性驳回规则静态自检

生产部署（一键）

前置：已注册域名、梧桐平台审核通过并拿到 AIC。

# 1. 取证书三件套（agent-cert/agent-key/trust-bundle，永不入库）
acps-cli --config agent/acps-cli.toml auth login
acps-cli --config agent/acps-cli.toml cert eab fetch --aic <AIC> --output eab.json --json
acps-cli --config agent/acps-cli.toml cert issue -a <AIC> --eab-file eab.json \
  -u serverAuth --key-path ./agent-server-key.pem \
  --cert-path ./agent-server-cert.pem --trust-bundle-path ./trust-bundle.pem

# 2. 回填 AIC 与域名到 acs.json
./deploy/cutover.sh <AIC> <主域名>

# 3. VPS 首装（Ubuntu 24.04，装依赖＋systemd 双服务＋mTLS 自检）
bash deploy/vps_setup.sh

agent/config.toml 生产形态：tls_enabled=true、监听 0.0.0.0:443、verify_client=false（连通优先，确认平台各触点均持证后可收紧）。

目录结构

facade/            # 服务实现（main.py 端点 / runner.py 路由与任务表 / skills_impl.py 能力）
facade/data/       # 合成数据（持仓 8 条 / 资讯 20 条 / 教练日志）
agent/             # acs.json、config.toml、prompts.toml、skills.toml、acps-cli.toml（证书不入库）
tools/             # healthcheck 七接口自检 / rollup 日报 / acs_lint 静态自检 / kafka_reporter 上报器
deploy/            # vps_setup.sh 一键部署 / cutover.sh 回填 / cloudflared（开发期隧道，仅存档）

合规声明

• 零上游连接：不接任何真实账户、真实行情或真实资讯源；数据全部合成并显式标记 synthetic=true
• 明确拒绝：加密货币/数字资产、个股推荐与收益承诺、真实账户操作与资金划转、境外市场标的；混合请求仅处理范围内部分并声明拒绝项
• 缺必填输入时返回 awaiting-input 并列出缺失字段，不臆造参数
• 证书私钥、LLM key、EAB 凭据永不入库（.gitignore 已覆盖 *.pem / *.key / .env / eab.json / keyfiles/）