# Enterprise API Orchestrator

> 核心能力

- Skill: `an8079/enterprise-api-orchestrator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add an8079/enterprise-api-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/an8079/enterprise-api-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: an8079 (https://skillmd.com/u/an8079)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/an8079/enterprise-api-orchestrator

---


## 核心能力

### 1. 配置驱动工具生成

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

```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]
```

**读取并解析配置：**
```bash
# 查找项目中的 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汇总所有结果，生成结构化报告
```

---

## 调用工具

### exec（Python直接调用）

在 `/workspace/ragent/tools/api_tools/` 目录下运行：

```bash
cd /workspace/ragent/tools/api_tools
export JUHE_API_KEY=your_api_key
python -c "
from src.tools import get_enterprise_brief, query_legal_case
import json

# 示例调用
result = get_enterprise_brief(company_name='示例公司')
print(json.dumps(result, ensure_ascii=False, indent=2))
"
```

### wecom_mcp（若配置了企业微信MCP）

使用 wecom_mcp 调用已部署的企业数据接口。

---

## 响应格式

### 查询成功

```
✅ 企业基础信息
━━━━━━━━━━━━━━━━━
公司名称: [name]
法定代表人: [legal_person]
注册资本: [registered_capital]
成立日期: [establishment_date]
经营状态: [business_status]
统一社会信用代码: [credit_code]

⚠️ 风险提示
━━━━━━━━━━━━━━━━━
欠税记录: [tax_arrears]
涉诉案件: [N] 件
...
```

### 查询失败

```
❌ 查询失败
━━━━━━━━━━━━━━━━━
原因: [API错误信息]
建议: [重试/检查API Key/更换查询参数]
```

---

## 环境要求

- Python 3.10+
- 依赖包: `pip install -r /workspace/ragent/tools/api_tools/requirements.txt`
- API Key: 聚合数据平台 API Key（配置在 `.env` 或环境变量 `JUHE_API_KEY`）
- Redis（可选）: 用于缓存加速

---

## 缓存策略

工具内置 Redis 缓存，相同查询在 TTL 内直接返回缓存结果：

- 企业基本信息缓存: 24小时
- 涉诉/欠税数据缓存: 1小时
- 四要素核验缓存: 不缓存（实时性要求高）

---

## 错误处理

| 错误类型 | 处理方式 |
|---------|---------|
| API Key 无效 | 提示配置 API Key，参考 `.env.example` |
| 请求超限（429） | 自动退避 + 重试，最多重试3次 |
| 网络超时 | 重试，最多重试3次 |
| 字段映射错误 | 日志记录 + 返回原始响应 |

---

## 扩展方向

- 接入更多数据源（天眼查API、启信宝API）
- 支持企业关系图谱生成（股权+任职+投资关系）
- 支持报告导出（Markdown/PDF）