创建HTTP类型插件-供应商准入风险外查服务示例
功能说明
本文介绍了创建HTTP类型插件-supplier_risk_mcp ，并挂载到智能体上使用的完整流程。
插件功能描述：供应商准入风险外查服务：提供企业工商登记核验、经营异常与行政处罚查询、供应商准入综合评分三项能力，用于采购准入前对供应商主体做真实性核验与风险定级。
插件挂载至智能体后，大模型可解析用户自然语言，根据语义自动调用供应商风险查询工具，获取企业风险信息并输出核验与评分结果，无需在提示词中额外定义工具调用规则。
第一步 部署服务
开发人员将已经调试通过的代码部署到服务器，并启动服务。
第二步 在平台配置插件
1.新建插件
进入百数AI模式 >> 智能体开发 >> 资源库 >> +资源，新建插件，各项参数值如下：
| 配置项 | 填写内容 |
|---|---|
| 插件名称 | supplier_risk_mcp |
| 插件描述 | 供应商准入风险外查服务：提供企业工商登记核验、经营异常与行政处罚查询、供应商准入综合评分三项能力，用于采购准入前对供应商主体做真实性核验与风险定级。 |
| 插件工具创建方式 | HTTP/HTTPS |
| 插件 URL | https://plain-und-instrumental-lying.trycloudflare.com/mcp |
| Header 列表 | User-Agent ai/1.0 |
| 授权方式 | Service >> Service token / API key（请求头鉴权） |
| Parameter name | X-Api-Key |
| Service token / API key | bsy-demo-key-**** |
2.新建工具
插件新建完成后，需要手动创建工具，注意工具名称和代码中设置的函数名一致。
工具创建完成后，还需要设置输入参数和输出参数。
插件中包含3个工具，具体的配置信息如下：
工具 1：verify_enterprise
| 配置项 | 填写内容 |
|---|---|
| 工具名称 | verify_enterprise（严格一致） |
| 工具描述 | 根据企业全称或统一社会信用代码核验工商登记信息。当需要确认一家企业是否真实存在、核对其法人/注册资本/经营状态/成立日期时使用。输入 company_name（企业全称，必填）或 credit_code（统一社会信用代码，选填）；输出 统一社会信用代码、法定代表人、注册资本、经营状态、成立日期、注册地址、经营范围。查不到时返回 status=not_found，此时不得编造企业信息。 |
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
company_name |
单行文本 | 是 | 企业全称 |
credit_code |
单行文本 | 否 | 统一社会信用代码 |
输出参数
| 参数名 | 类型 | 说明 |
|---|---|---|
status |
单行文本 | found / not_found / error |
company_name |
单行文本 | 企业全称 |
credit_code |
单行文本 | 统一社会信用代码 |
legal_person |
单行文本 | 法定代表人 |
registered_capital |
单行文本 | 注册资本 |
operating_status |
单行文本 | 经营状态 |
establish_date |
单行文本 | 成立日期 |
address |
单行文本 | 注册地址 |
business_scope |
多行文本 | 经营范围 |
source |
单行文本 | 数据来源 |
工具 2：check_business_risk
| 配置项 | 填写内容 |
|---|---|
| 工具名称 | check_business_risk |
| 工具描述 | 查询企业的经营异常与行政处罚记录。在工商核验通过后，需要判断该企业是否存在经营风险时使用。输入 company_name（企业全称）；输出 经营异常条数与明细、行政处罚条数与明细、风险标签列表。 |
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
company_name |
单行文本 | 是 | 企业全称 |
输出参数
| 参数名 | 类型 | 说明 |
|---|---|---|
status |
单行文本 | found / not_found |
company_name |
单行文本 | 企业全称 |
exception_count |
数字 | 经营异常条数 |
exception_items |
多行文本 | 经营异常明细（数组） |
penalty_count |
数字 | 行政处罚条数 |
penalty_items |
多行文本 | 行政处罚明细（数组） |
risk_tags |
多行文本 | 风险标签（数组） |
message |
单行文本 | 未命中时的提示 |
工具 3：score_supplier
| 配置项 | 填写内容 |
|---|---|
| 工具名称 | score_supplier |
| 工具描述 | 对供应商做准入综合评分与定级。在工商核验与风险查询完成后，需要给出最终准入建议时使用。输入 company_name、on_time_rate（准时交付率0-100）、quality_score（质量评分0-100）、complaint_count（投诉次数）、has_exception（是否存在经营异常）、cooperation_years（合作年限）；输出 score（0-100综合分）、grade（优秀/良好/一般/较差）、risk_level（低/中/高）、suggestion（准入建议）。存在经营异常时风险等级不得评定为低。 |
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
company_name |
单行文本 | 是 | 企业全称 |
on_time_rate |
数字 | 否 | 准时交付率 0-100，默认 0 |
quality_score |
数字 | 否 | 质量评分 0-100，默认 0 |
complaint_count |
数字 | 否 | 投诉次数，默认 0 |
has_exception |
单行文本 | 否 | 是否存在经营异常，填 true / false |
cooperation_years |
数字 | 否 | 合作年限，默认 0 |
输出参数
| 参数名 | 类型 | 说明 |
|---|---|---|
company_name |
单行文本 | 企业全称 |
score |
数字 | 综合分 0-100 |
grade |
单行文本 | 优秀 / 良好 / 一般 / 较差 |
risk_level |
单行文本 | 低 / 中 / 高 |
suggestion |
单行文本 | 准入建议 |
detail |
多行文本 | 计算明细（对象：准时交付率、质量评分、服务得分、异常扣分、年限加分） |
3.工具试运行
工具配置完成后，点击试运行，验证是否运行通过。
运行失败则需要继续修改服务或连接方式，根据具体原因调试。
运行通过可进入下一步。
4.发布插件
插件下所有工具都运行通过后，发布插件。
第三步 在智能体中使用插件
新建智能体，添加插件及其工具，并在预览和调试页面验证结果。
智能体挂载 HTTP 类型 MCP 插件之后，不需要在提示词里手写固定工具调用语法、手动指定入参；大模型会自主理解用户问题语义，判断是否需要调用 MCP 工具、自动生成参数发起调用。
提示词如下：
# 可用工具
外部供应商风险查询（工商核验 / 风险记录 / 综合评分）
# 工作流
第一步：用公司全称核验工商登记信息。当status=not_found 时直接告知用户未查到，禁止编造。
第二步：查询经营异常与行政处罚。
第三步：得出综合评级与准入建议。
第四步：按以下 JSON 输出，不要附加任何解释文字。
{"供应商名称":"","统一社会信用代码":"","风险等级":"","准入建议":"","审核摘要":""}智能体验证符合预期后，发布智能体。智能体发布成功后，可配置到平台表单中使用。