enterprise-api-orchestrator

核心能力

1. 配置驱动工具生成

给定 YAML 配置文件，自动识别可用工具：

# 工具配置示例 (api_config.yaml)
tools:
  - name: verify_enterprise_four_factors
    endpoint: https://api.juhe.cn/enterprise/verify
    params: [company_name, legal_person, id_card, account_no]

  - name: get_enterprise_brief
    endpoint: https://api.juhe.cn/enterprise/brief
    params: [company_name]

读取并解析配置：

# 查找项目中的 api_config.yaml
find . -name "api_config.yaml" -o -name "api_config.yml" | head -3

# 或查看 ragent/tools/api_tools/config/ 目录
ls /workspace/ragent/tools/api_tools/config/

2. 单工具调用

根据用户需求匹配合适的工具，直接调用：

工具	适用场景
verify_enterprise_four_factors	营业执照+法人+身份证+账号四要素核验
get_enterprise_brief	企业基本信息（名称/法人/注册资本/成立日期）
get_enterprise_business_info	工商信息全量（注册地址/经营范围/状态）
get_enterprise_branches	分支机构查询（分公司/子公司）
get_enterprise_employees	主要人员（董事长/总经理/监事）
get_enterprise_shareholders	股东信息（持股比例/出资额）
get_enterprise_investment	对外投资（子公司/参股公司）
get_enterprise_annual_report	工商年报（营收/资产/社保）
query_legal_case	涉诉信息（立案/开庭/判决）
get_enterprise_qualification	工程资质（建筑业/专业承包资质）
get_enterprise_high_tech	高新技术企业认定状态
query_micro_enterprise	小微企业认定
get_enterprise_tax_arrears	欠税信息

3. 多工具编排工作流

企业尽职调查（DD）工作流：

1. verify_enterprise_four_factors  → 确认四要素真实
2. get_enterprise_brief             → 获取基本信息
3. get_enterprise_shareholders     → 核查股权结构
4. get_enterprise_investment       → 核查对外投资
5. query_legal_case                 → 核查法律风险
6. get_enterprise_tax_arrears      → 核查税务风险
→ 汇总输出《企业尽调报告》

批量查询工作流：

输入: [公司A, 公司B, 公司C]
对每个公司并行执行:
  - get_enterprise_brief
  - query_legal_case
  - get_enterprise_high_tech
→ 汇总输出《批量企业报告》

---

工作流模式

快速查询（单工具）

当用户需求明确对应单一工具时，直接调用：

1. 解析用户输入 → 提取参数（公司名/法人名/身份证号等）
2. 匹配最合适的工具
3. 调用工具，返回结构化结果
4. 格式化输出（中文/表格/摘要）

完整尽调（多工具编排）

当用户需求复杂或模糊时，启动多工具编排：

step 1: 意图识别 + 参数提取
  tool: 自然语言理解
  params: { user_input: "帮我查一下这家公司靠不靠谱" }
  description: 从用户输入中识别公司名称和查询意图

step 2: 基础信息获取
  tool: exec / python
  params: { command: "python -c 'from src.tools import get_enterprise_brief; print(get_enterprise_brief(company_name))'" }
  description: 调用 get_enterprise_brief 获取基本信息

step 3: 风险筛查
  tool: exec / python
  params: { parallel: ["query_legal_case", "get_enterprise_tax_arrears"] }
  description: 并行调用涉诉+欠税API

step 4: 结果汇总
  tool: llm-task
  params: { prompt: "将以下企业数据汇总成尽调报告..." }
  description: LLM汇总所有结果，生成结构化报告