摘要

AI Agent 要真正落地企业场景,必须解决 LLM 知识静态、无法感知实时数据的问题。本文将企业数据 API 封装为 Agent Tool 的实战过程,以工商、司法、招投标等接口为例,展示如何将数据查询能力转化为 Agent 可调用的工具。从 Tool 定义、参数设计到多工具协同的工作流,提供一套可直接参考的实践方案,适合正在探索 Agent 落地的开发者与产品经理。

正文

很多人开始用 Auto-GPT、LangChain 搭 Agent,希望能用它自动做一些复杂的任务,比如说在企业服务领域,用Agent批量筛查供应商或客户,自动标记有经营异常、行政处罚或司法风险的企业。

但LLM 内在知识是静态的,无法即时获取企业最新的动态,即使能联网搜,那也只是临时检索,并非模型自身知识更新。想让 AI Agent 真正干活,就必须让它主动接入实时数据。

【AI Agent + 企业数据 API】 的组合是一个不错的方案:Agent 负责拆解任务、制定计划,API负责提供最新的精确情报(工商、司法、招投标、知识产权等),共同完成任务。

具体该如何封装企业数据API为 Agent 能听懂、会调用的 Tool,落地到真实的智能体工作流中?以下是几个核心的实战示例。

示例中用到的API来自鲸海数据,我之前测评过,链接放最后了。新用户注册有 1000 次免费额度,够把整个流程跑通,需要的朋友也可以直接去官网(https://www.kqdaas.com/?utm_source=csdn&utm_medium=blog&utm_campaign=202606_brand_launch&utm_content=csdn_004 )领额度。

一、为什么企业数据 API 天然适合做成 Agent Tool?

在当前的 AI Agent 框架中,工具调用(Tool Calling)是个基础能力。LLM 负责理解用户意图、拆解任务、制定计划,而 Tool 负责执行具体的原子化操作,想了解更多可以看看我之前的文章:Python 实测|这家免费企业数据 API 连反爬都没有,数据质量却意外能打-CSDN博客

企业数据API本身就是按“一件事一个接口”设计的,和Agent Tool Calling“查一个数据、调一个接口、取一个字段”的执行逻辑天然同构。

不同的API接口,对应不同的数据字段图

以我用的鲸海数据为例,它的接口设计对 Agent Tool 封装尤其友好:

一是颗粒度小,工商、司法、招投标等上百个维度都拆成了独立的细分接口,恰好对应一个 Tool 查一件事

二是返回字段干净,返回标准 JSON,没有冗余嵌套,Agent 解析时 Token 消耗很低。

三是可组合,多个 Tool 可以串并联完成复杂任务

工商信息接口返回示例图

API提供的数据维度越多,做出来的工具包就越强大。

大类示例

可封装的细分 Tool 示例

基本信息

查工商信息、查股东列表、查主要人员、查分支机构

风险信息

查经营异常、查行政处罚、查被执行人、查失信被执行人、查限制高消费

司法信息

查裁判文书列表、查法院公告、查开庭公告、查终本案件

知识产权

查商标列表、查专利列表、查软件著作权、查作品信息

招投标

查招投标列表、查招投标详情

原本静态的企业数据接口,被转化为了 Agent 可以理解和执行的具体动作,Agent也得以深入真实数据、获取精确情报。

二、典型 Tool 封装示例

以下示例基于鲸海 API 接口,封装为 Agent 可调用的 Tool。以 Python + FastAPI 风格的 Tool 定义为例,实际封装时可根据 Agent 框架(Coze、Dify、LangChain 等)的规范调整。

Tool 示例 1:查询企业经营异常

对应 API:经营异常信息接口

Agent 使用场景:当用户说“帮我查一下 A 公司有没有经营异常”,Agent 自动调用此 Tool,将结果用自然语言回复。

{

  "name": "get_business_exception",

  "description": "查询企业在工商部门的经营异常名录记录,包括列入日期、列入原因、作出决定机关等信息。适用于供应商准入筛查、合作伙伴风险审查等场景。",

  "parameters": {

    "type": "object",

    "properties": {

      "company_name": {

        "type": "string",

        "description": "企业全称,如'华为技术有限公司'"

      },

      "pageIndex": {

        "type": "integer",

        "description": "页码,默认为1"

      },

      "pageSize": {

        "type": "integer",

        "description": "每页条数,默认为20"

      }

    },

    "required": [

      "company_name"

    ]

  },

  "response_mapping": {

    "total": "总数",

    "list": [

      {

        "exception_date": "列入日期",

        "exception_reason": "列入原因",

        "decision_authority": "决定机关",

        "removed_date": "移出日期",

        "removed_reason": "移出原因"

      }

    ]

  }

}

使用效果示例图

Tool 示例 2:查询企业司法风险全景

对应 API:被执行人 + 失信被执行人 + 限制高消费 + 终本案件总览 组合封装

Agent 使用场景:供应商入库时,Agent 自动调用此 Tool 输出风险评级。

{

  "name": "get_judicial_risk_summary",

  "description": "查询企业全面的司法风险信息,包括被执行人、失信被执行人、限制高消费、终本案件等。用于供应商风险评估、客户信用审查等场景。",

  "parameters": {

    "type": "object",

    "properties": {

      "company_name": {

        "type": "string",

        "description": "企业全称"

      }

    },

    "required": [

      "company_name"

    ]

  },

  "response_mapping": {

    "executed_count": "被执行人记录数",

    "dishonest_count": "失信被执行人记录数",

    "restricted_consumption_count": "限制高消费记录数",

    "closed_case_count": "终本案件数"

  }

}

其他应用场景的tool可以此类推:

  1. 查询企业知识产权布局

对应 API:商标信息列表 + 专利信息列表 + 软件著作信息 + 作品信息 组合封装

Agent 使用场景:用户说“帮我看看 B 公司的技术壁垒怎么样”,Agent 调用此 Tool 获取专利和商标数据后,结合上下文给出分析。

  1. 查询企业招投标动态

对应 API:招投标信息列表 接口

Agent 使用场景:市场分析时,用户问“C 公司最近半年中了哪些政府项目”,Agent 精确调用并汇总。

三、实际 Agent 工作流示例:供应商风险筛查

以“供应商风险筛查”为例,展示多个 Tool 如何协同工作。

【用户输入】

“请对以下3家潜在供应商做风险筛查:A公司、B公司、C公司,重点关注行政处罚和失信记录”

【Agent 内部执行】

Step 1 - 任务分解:

  - 每家供应商需要查:行政处罚 + 失信被执行人

Step 2 - Tool 并行调用(6个调用同时发出):

  tool_get_penalty("A公司")    tool_get_dishonest("A公司")

  tool_get_penalty("B公司")    tool_get_dishonest("B公司")

  tool_get_penalty("C公司")    tool_get_dishonest("C公司")

Step 3 - 结果汇总与推理:

  - A公司:行政处罚3条(含1条环保处罚),无失信 → 【建议:需进一步核实】

  - B公司:无行政处罚,无失信 → 【建议:可准入】

  - C公司:行政处罚5条,失信被执行人2条 → 【建议:高风险,不建议合作】

【Agent 最终输出】

生成一份带风险等级标记的供应商筛查报告(表格 + 文字结论)

整个过程 Agent 完成了“理解意图 → 拆解任务 → 并行调用 Tool → 汇总 → 推理 → 输出报告”的闭环,而每个 Tool 背后就是我们的一个或几个 API 接口。

四、总结

总的来说,将企业数据 API 封装为 Agent Tool,并不复杂。核心就两步:把每个细分接口封装成一个独立工具,然后在系统提示词里定义好任务编排逻辑。 剩下的,LLM 会自动帮你搞定任务拆解和工具调用。

文中用到的鲸海数据 API,我之前专门写过测评(链接),亲测数据质量能打,接口也没有乱七八糟的限制。新用户有 1000 次免费额度,官网直接注册就能领(https://www.kqdaas.com/?utm_source=csdn&utm_medium=blog&utm_campaign=202606_brand_launch&utm_content=csdn_004 )。有需要的可以去领个额度验证一下你的 Agent 场景。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐