LinkAI Builder 自定义插件开发——让智能体对接你的业务系统
LinkAI 内置插件覆盖了搜索、文生图、天气、快递、图表、文件生成等常见场景，但企业的实际业务系统千差万别——ERP、CRM、订单系统、内部知识库……自定义插件 就是让你的智能体能与这些外部系统直接交互的通道。
两种自定义插件方式
1. HTTP 请求插件（最轻量）
如果你有现成的 HTTP API，直接告诉 LinkAI 如何调用：
插件名称：查询订单详情
触发条件：意图识别（"查询订单" / "订单状态" / "订单编号查询"）
API 地址：https://api.yourcompany.com/order/detail
请求方法：POST
请求体模板：{ "order_id": "{{用户提取的订单号}}" }
API Key：xxx（或由用户在渠道端自行配置）
响应解析：从 response.data 里提取订单状态、商品列表、物流信息保存后，当用户在对话里问"帮我查一下订单号 20251014001 的状态"，LinkAI 会：
- 意图识别命中"查询订单详情"插件
- 从用户输入中提取订单号
- 调用你的 API
- 把返回结果送给大模型，让它生成自然语言回复
2. OpenAPI Schema 插件（最规范）
如果你的 API 有 OpenAPI / Swagger 规范文档，直接把 YAML / JSON 格式的 Schema 导入，LinkAI 会自动解析所有接口、参数和返回值，帮你生成完整的插件配置。这种方式适合 API 数量多、接口复杂的场景。
自定义插件的配置清单
无论用哪种方式，配置一个自定义插件都需要以下信息：
| 配置项 | 说明 |
|---|---|
| 插件名称 | 清晰的标识，让意图识别能准确匹配 |
| 插件描述 | 告诉 AI 这个插件能做什么、什么时候该用 |
| 触发条件 | 意图识别（推荐）或关键词匹配（备选） |
| API 调用配置 | URL、方法、请求头、认证方式、参数映射 |
| 响应解析 | 如何从 API 返回值中提取有意义的内容 |
| 错误处理 | API 调用失败时的降级方案 |
与内置插件的协同
自定义插件可以和内置插件、知识库、数据库、应用等任意组合。比如：
- 用户问"帮我看看这个客户最近的订单，以及他在 CRM 里的画像" → 先调用自定义 CRM 插件查画像→ 再调用自定义订单插件查订单→ 大模型综合生成客户分析
API 安全注意事项
- API Key 不要硬编码在插件里——推荐让渠道端用户自行配置，或使用 LinkAI 的密钥管理功能加密存储
- 添加 IP 白名单——LinkAI 的出口 IP 是固定的，可以在你 API 服务器上配置白名单，只接收来自 LinkAI 的请求
- 设置调用频率限制——防止 AI 在短时间内高频调用 API 造成压力
- 使用只读权限——能只读就不要给写权限，写操作建议走更严格的二次确认
调试技巧
- 在插件管理页面手动输入测试参数调用 API，确认能正确返回
- 在应用调试页面开启插件执行过程展示，观察 AI 是如何识别意图、选择插件、解析结果的
- 如果触发不准，优化插件描述——描述要具体，包含"能做什么"+"什么时候该用"，避免模糊的"查询数据"
与工作流的关系
自定义插件不仅能被应用通过意图识别调用，还能在工作流的插件节点里直接调用——此时不需要意图识别，流程走到这一步就执行。这种方式适合"业务流程里固定需要调用某接口"的场景（比如工单创建完自动通知）。