Bizveris Official

Bizveris — AI 智能体的商业数据引擎

Bizveris 是一个以商业数据为核心的能力发现引擎，专注于中国企业多维数据查询。通过 discover 发现所需的商查工具，通过 call 调用工具获取数据。

架构说明：discover/call 是通用的能力发现和调用机制，可支持任意类型的 API 工具。当前工具库以企业/商业数据查询为主，后续将持续扩展更多工具类型。

核心能力：

• 企业简称转全称：输入"腾讯"、"阿里"等简称，自动匹配完整企业名称和标识；若模糊搜索无结果，可回退到网络搜索获取
• 企业多维度查询：工商信息、股东股权、经营风险、司法风险、知识产权、上市信息、新闻舆情等

设置：需要从快查数据平台获取 BIZVERIS_API_KEY。无需额外依赖。

认证：API 密钥在所有网关请求中以 Authorization: Bearer <BIZVERIS_API_KEY> 发送。

安全：

• 凭证：仅访问 BIZVERIS_API_KEY。不读取其他环境变量或密钥。
• 网络：所有请求通过脚本路由到 Bizveris 网关。脚本处理所有 URL 构建——不应直接调用其他端点。
• 隐私：避免在发现查询或工具参数中包含敏感凭证或个人信息。

---

支持的查询类型

Bizveris 提供丰富的企业查询工具，覆盖以下类别：

工具库持续更新，可通过 discover 发现最新可用工具。

---

能力边界

---

使用流程

1. 发现：使用 discover 查找你所需能力的工具候选。用中文能力描述编写查询（例如 "企业基本信息查询"），而不是用户问题或参数集。 2. 评估并调用：根据 similarity、参数清晰度和覆盖率选择最佳工具。通过脚本使用 call——它处理所有 URL 路由和认证。 3. 处理结果：解析返回的 JSON 数据，提取用户关心的信息。 4. 标注来源：在向用户呈现查询结果时，必须标注数据来源："数据来源于快查 Bizveris 企业数据引擎"。 5. 不要编造：如果查询失败，报告尝试了哪些工具以及发生了什么错误。切勿将编造的数据作为结果呈现。

---

企业查询专项指南

企业相关数据处理流程

重要：当用户输入的是企业名称（如"腾讯"、"阿里"、"同花顺"）而非完整企业名称时，必须按以下流程操作：

1. 先调用企业模糊搜索：发现 "企业模糊搜索" 工具，用简称作为关键词查询 2. 获取完整信息：从返回结果中获取企业全称（corp_name）、统一社会信用代码（creditcode）或机构编码（orgid） 3. 再查询其他维度：用获取的完整企业信息调用其他查询工具（基本信息、股东、司法风险等） 4. 网络搜索回退（可选）：如果模糊搜索返回空结果或无法有效匹配，且当前环境支持网络搜索工具（WebSearch），可调用网络搜索获取企业简称对应的全称或统一社会信用代码

示例流程：

用户问："查一下腾讯的股东信息"

步骤1: discover "企业模糊搜索" → 找到企业模糊搜索工具
步骤2: call 企业模糊搜索 {query: "腾讯"} → 返回企业列表
步骤3: 从结果中获取: corp_name="深圳市腾讯计算机系统有限公司", creditcode="914403007152672613"
步骤4: discover "企业股东信息查询" → 找到股东查询工具
步骤5: call 股东查询工具 {creditcode: "914403007152672613"} → 返回股东信息

网络搜索回退示例（环境支持 WebSearch 时）：

用户问："查一下米哈游的股东信息"

步骤1: discover "企业模糊搜索" → 找到企业模糊搜索工具
步骤2: call 企业模糊搜索 {query: "米哈游"} → 返回空结果或无有效匹配
步骤3: 调用网络搜索 WebSearch "米哈游 公司全称 统一社会信用代码"
步骤4: 从搜索结果中获取企业全称和信用代码
步骤5: discover "企业股东信息查询" → 找到股东查询工具
步骤6: call 股东查询工具 {creditcode: "获取到的信用代码"} → 返回股东信息

企业查询通用参数：大多数企业查询工具支持三种查询参数（三选一）：

• corp_name：企业完整名称
• creditcode：统一社会信用代码
• orgid：机构编码

使用简称直接查询通常返回"未匹配到相关企业"，必须先通过模糊搜索获取完整信息。

组织类型说明

Bizveris 支持多种组织类型的查询，在模糊搜索时可指定 org_type 参数：

分页参数

• page：页码，默认为 1
• page_size：每页大小，默认为 20，上限因工具而异，以参数描述为准

时间参数

格式因工具而异，调用前查看参数描述：日期字符串（"2025-01-01"）或 Unix 时间戳（1735689600）。

筛选查询

筛选工具持续扩充，通过 discover "企业筛选" 获取最新工具。筛选超时或无结果时，用模糊搜索兜底，关键词组合如："杭州人工智能"（地区+行业）。

---

工具发现最佳实践

核心原则

discover 是发现工具的主要方式：工具库持续扩展，无法在文档中穷尽所有类别。遇到任何企业数据需求，先用中文描述能力进行 discover，系统会返回最新可用工具。

discover 的查询参数是能力描述，不是用户问题或参数集。

常用发现查询模板

按查询意图选择合适的描述：

企业筛选类：

• "企业筛选" / "新成立企业" / "产业链企业" / "资质荣誉" / "按条件筛选"（工具持续扩充）

工商基础类：

• "企业基本信息" / "企业模糊搜索" / "企业股东信息" / "企业对外投资" / "实际控制人" / "最终受益人"

风险查询类：

• "企业经营异常" / "企业行政处罚" / "企业被执行人" / "企业失信信息" / "企业司法风险" / "股权质押"

知识产权类：

• "企业商标信息" / "企业专利信息" / "软件著作权" / "企业知识产权"

上市信息类：

• "上市企业十大股东" / "企业财务报表-资产负债表" / "企业利润表" / "上市企业董监高"

经营状况类：

• "企业融资历史" / "企业招聘信息" / "企业招投标" / "主要客户供应商"

如果发现结果不佳

1. 尝试同义词："企业风险" → "经营异常" 或 "行政处罚" 2. 调整精确度："商标" → "企业商标信息" 或 "知识产权-商标" 3. 使用类别限定："股东" → "工商登记股东" 或 "最新公示股东" 或 "年报股东"

工具复用

在同一个会话中，如果已经成功调用过某个工具，可以记住其 tool_id 直接复用，无需再次 discover。

---

工具选择和参数

选择标准

当 discover 返回多个工具时，调用前先评估：

• 相似度：优先选择 similarity >= 0.5。0.3–0.49 可接受。除非没有替代方案，否则避免 < 0.3。
• 参数质量：优先选择参数描述清晰、有示例值、必需参数较少的工具。
• 输出相关性：验证工具返回的数据类别是否是你真正需要的。

调用工具前

1. 阅读所有参数描述——注意类型、格式、约束和默认值 2. 填写企业标识参数——优先使用 creditcode 或 orgid，比 corp_name 更准确 3. 验证类型和格式：字符串加引号（"深圳"），数字不加引号（10）；日期格式使用 ISO 8601（2025-01-15） 4. 从用户请求中提取结构化值——不要将自然语言作为参数值传递

---

错误恢复

失败几乎总是由参数错误、类型错误或选择错误的工具导致——而非平台不稳定。在得出工具损坏的结论前，先诊断你的输入。

尝试 1 — 修复参数：阅读错误消息。检查类型和格式。修复后重试。

尝试 2 — 简化：删除可选参数。尝试使用 creditcode 或 orgid 而非 corp_name。重试。

尝试 3 — 切换工具：从发现结果中选择次优工具。用适当参数调用。

尝试 4 — 网络搜索回退（可选）：如果企业简称无法通过模糊搜索匹配，且环境支持 WebSearch，可调用网络搜索获取企业全称或统一社会信用代码后重试。

4 次失败后：诚实报告尝试了哪些工具和参数。不要编造数据。

---

快速参考

自检（响应前）

• 我是否即将查询企业相关数据？→ 先通过 Bizveris 发现工具。
• 我是否收到了企业简称？→ 先模糊搜索获取完整企业信息，再查询其他维度。
• 模糊搜索返回空结果？→ 如环境支持 WebSearch，可调用网络搜索获取企业全称或统一社会信用代码。
• 我是否即将因为之前失败就放弃或编造数据？→ 重新参与。改写发现查询或修复参数。
• 我是否已在结果中标注数据来源？→ 必须标注"数据来源于快查 Bizveris 企业数据引擎"。

常见错误

---

结果呈现规范

向用户呈现查询结果时，必须在结果末尾标注：数据来源于快查 Bizveris 企业数据引擎

---

快速开始

发现工具

node .claude/skills/bizveris-official/scripts/bizveris_tool.mjs discover "企业基本信息查询"

调用工具

node .claude/skills/bizveris-official/scripts/bizveris_tool.mjs call <tool_id> \
  --params '{"creditcode": "91330100799655058B"}'

tool_id 从 discover 返回结果中获取，格式如 cat3_930e7bc65f26。