File size: 2,624 Bytes
b4f2238 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | # Enterprise Data（MCP）使用说明
## 已接入能力
- Provider 抽象：`tianyancha`（已接入）、`qichacha`（骨架预留）
- 协议策略：优先 `streamable_http`，失败自动回退 `sse`
- 标准化能力：
- `search_companies`
- `get_company_profile`（映射 `get_company_info`）
- `get_company_risks`
- `get_company_shareholders`
- `get_company_personnel`
- `get_person_profile`
- `search_bidding_info`
## 后端 API
统一入口：`/api/v1/enterprise-data/*`
- `GET /providers`
- `GET /companies/search`
- `GET /companies/profile`
- `GET /companies/risks`
- `GET /companies/shareholders`
- `GET /companies/personnel`
- `GET /persons/profile`
- `GET /bidding/search`
统一响应骨架：
```json
{
"query": {},
"data": {},
"meta": {
"provider": "tianyancha",
"tool": "search_companies",
"transport": "sse",
"requested_transport": "streamable_http",
"fallback_used": true,
"cached": false,
"observability": {
"window_seconds": 300,
"total": 20,
"success_rate": 0.95,
"fallback_rate": 0.25,
"avg_duration_ms": 1280
}
},
"raw": null
}
```
## Admin 工作台
路径：`/admin/enterprise_data/mcpworkbench/`
- 仅超级管理员可访问（页面权限 + 服务端权限双重校验）
- 可查看工具列表、参数 schema、最近样例
- 可执行调试、查看执行历史并一键重放
- 执行结果已做敏感字段脱敏
## 关键配置项（SystemConfig）
- 基础：
- `ENTERPRISE_DATA_DEFAULT_PROVIDER`
- `ENTERPRISE_DATA_CACHE_TTL_SECONDS`
- 天眼查：
- `TIANYANCHA_MCP_ENABLED`
- `TIANYANCHA_MCP_TRANSPORT`
- `TIANYANCHA_MCP_BASE_URL`
- `TIANYANCHA_MCP_SSE_URL`
- `TIANYANCHA_MCP_API_KEY`
- `TIANYANCHA_MCP_TIMEOUT_SECONDS`
- 限流/重试：
- `ENTERPRISE_DATA_RATE_LIMIT_REQUESTS`
- `ENTERPRISE_DATA_RATE_LIMIT_WINDOW_SECONDS`
- `ENTERPRISE_DATA_RETRY_MAX_ATTEMPTS`
- `ENTERPRISE_DATA_RETRY_BACKOFF_SECONDS`
- 可观测告警：
- `ENTERPRISE_DATA_METRICS_WINDOW_SECONDS`
- `ENTERPRISE_DATA_ALERT_MIN_SAMPLES`
- `ENTERPRISE_DATA_ALERT_SUCCESS_RATE_THRESHOLD`
- `ENTERPRISE_DATA_ALERT_FALLBACK_RATE_THRESHOLD`
- `ENTERPRISE_DATA_ALERT_AVG_LATENCY_MS_THRESHOLD`
- 企查查预留：
- `QICHACHA_MCP_ENABLED`
- `QICHACHA_MCP_TRANSPORT`
- `QICHACHA_MCP_BASE_URL`
- `QICHACHA_MCP_SSE_URL`
- `QICHACHA_MCP_API_KEY`
- `QICHACHA_MCP_TIMEOUT_SECONDS`
## 运行注意事项
- `is_secret=True` 的配置需要稳定的 `CREDENTIAL_ENCRYPTION_KEY`。
开发环境若每次进程启动都随机生成密钥，密文将无法跨进程解密。
|