小李是一家电商公司的客服主管。每天，她的团队都要回答几百个相同的问题：”我的订单到哪了？”
每次回答，客服得先打开ERP系统，输入订单号，等页面加载，找到物流页面，复制快递单号，再打开快递公司官网查一遍……一套流程走下来，至少3分钟。一天处理200个这样的咨询，光”查订单”这一件事就浪费掉4个小时。
小李之前已经学会了用AI处理两件关键的事：用官方插件给Agent添加各种现成能力，以及理解Function Calling让Agent自动调用工具的原理。现在她的Agent能查天气、能生成图片、能搜索网上的信息。
但面对公司自己的订单系统，Agent完全无能为力。
“能不能让Agent直接帮我查公司内部的订单、客户、库存？”这是小李每天最真实的想法。
这件事有一个标准答案，就是：API。这一篇我们就讲讲怎么能让自己的Agent接入企业内部系统，作为业务人员怎么理解API，怎么更好的提出自己的需求。
一、什么是API？
很多没IT背景的朋友一听API这个词就头大，感觉很技术，不用担心，其实本质非常简单。
想象一下，你去一家餐厅吃饭。你坐在座位上看菜单、点菜，服务员帮你把需求告诉厨房，厨房做好之后，服务员再把菜端给你。整个过程中，你不需要知道厨房长什么样、厨师用的什么锅、菜是怎么炒的。你只需要告诉服务员你想吃什么，然后等着结果就行。
API就是这个”服务员”。 它站在你和复杂系统之间，帮你传话、帮你取结果。你不需要了解系统内部的任何技术细节，只需要知道”怎么告诉服务员”就够了。
回到小李的场景：她不需要知道ERP系统的数据库是怎么设计的，也不需要了解订单数据存在哪张表里。她只需要通过API这个”服务员”，说一句”帮我查12345号订单”，API就会把订单状态、物流信息、预计送达时间整理好端给她。
1.API调用的五个要素
继续用餐厅类比，来认识API调用涉及的五个关键信息。这些概念不需要死记硬背，理解就行：
| 要素 | 说明 | 餐厅类比 | 实际例子 |
|---|---|---|---|
| 接口地址（URL） | 告诉系统”找谁办事” | 餐厅的地址和桌号 | https://company.com/api/order/query |
| 请求方式 | 你要”做什么” | 点菜、结账、改菜 | GET（查数据）、POST（提交数据） |
| 参数 | 你要查的具体内容 | 菜名、几份、什么口味 | 订单号、客户ID |
| 返回值 | 系统给你的回答 | 端上来的菜和账单 | 订单状态、物流信息 |
| 鉴权（认证） | 证明你有权限使用 | 会员卡、预约号 | API密钥、Token |
核心就一句话：每一次API调用，本质上就是”告诉服务员你要什么，然后等他给你结果”。
2.业务人员为什么要关心API？
你可能会想：API不是IT部门的事吗？我学这个干嘛？
看完下面这个对比你就明白了——同样的工作，有没有API完全是两种体验：
| 场景 | 没有API（手动操作） | 有API（Agent自动完成） |
|---|---|---|
| 查订单 | 登录ERP → 找模块 → 输入订单号 → 等加载 → 查看 | 直接问Agent：”订单12345到哪了？” |
| 查客户 | 打开CRM → 搜索客户名 → 翻页看详情 | 直接问Agent：”客户张三最近下单情况？” |
| 查库存 | 登录WMS → 筛选产品 → 看库存报表 | 直接问Agent：”产品A还剩多少？” |
从”登录多个系统、点击多个页面、等待多次加载”变成”问一句话、等几秒钟”，这就是API的必要性。
当然你不需要自己写API，你只需要做到三件事：知道API能帮你做什么、怎么跟IT提需求、怎么在Coze里把API配上。
二、在Coze中配置API节点
我们还是用coze平台来说明怎么把API接入Agent。
1.API节点是什么？在哪找？
在Coze的工作流编辑器中，有一个”HTTP请求”节点。它的功能很聚焦：帮你的Agent调用任何一个HTTP接口，不管是公司内部系统、还是外部第三方服务。
把这个节点拖进工作流、配置好参数，你的Agent就能跟外部系统”对话”了。
2.如何配置
这个配置对于非IT人员可能有点技术了，不过没关系，我们简单说说，这样就有一个概念，哪怕后面我们让IT来配置，或者让AI来配置，至少我们知道怎么提问题。
基本来说主要是分为以下四个步骤
第一步：填写接口地址
接口地址就是API的”门牌号”。IT部门会给你一个URL，类似这样：
https://company.com/api/order/query第二步：选择请求方式
请求方式决定你要”做什么”。对业务场景来说，最常用的就两种：
| 方式 | 用途 | 一句话理解 |
|---|---|---|
| GET | 查询数据 | “我想看菜单” 只看不动 |
| POST | 提交或创建数据 | “我要下单” 提交新东西 |
还有PUT（修改已有数据）和DELETE（删除数据），但日常80%的场景只需要GET和POST。
第三步：配置请求参数
参数就是你要传给API的具体信息。在Coze的API节点里，有三种参数类型，每种对应不同的用途：
| 参数类型 | 放在哪 | 适合什么情况 | 举个例子 |
|---|---|---|---|
| URL参数（Params） | 网址后面 | 简单查询 | ?order_id=12345 |
| Body参数 | 请求体内 | 复杂数据提交 | JSON格式的数据包 |
| Header参数 | 请求头里 | 认证和格式声明 | Authorization: Bearer xxx |
不用纠结选哪种，按接口文档填就行。文档里会明确标注每个参数应该放在什么位置。
第四步：配置返回值提取
API返回的结果通常是JSON格式，种像俄罗斯套娃一样层层嵌套的数据结构。你需要告诉Coze”我要从结果里取哪些字段”。
举个例子，一个订单查询API返回了这样的数据：
{
"data": {
"order_id": "12345",
"status": "已发货",
"logistics": {
"company": "顺丰速运",
"tracking_number": "SF123456789"
}
}
}你可以用”路径”的方式定位你想要的字段：
①订单状态 → data.status（第一层data里面的status）
②快递公司 → data.logistics.company（data → logistics → company）
③快递单号 → data.logistics.tracking_number
就像在文件夹里找文件一样，每个点号表示”进入下一层”。
三、怎么获取到API，怎么提需求
一般开放的系统产品都会有开发者平台，里面都会有写好的API文档，我们对着文档来看来配置就好。
如果是公司内部系统，可能就需要找IT人员要这个API了。
作为业务人员，我们不需要深入了解API的原理和开发实现，我们只需要会提需求就行。
那么这一章节就说说，作为业务人员，怎么给IT提出自己的诉求，让IT协助我们完成配置。
1.先想清楚这两个问题
①业务场景说明：你到底要解决什么问题？
不要上来就说”我需要一个API”。正确的做法是说清楚三件事：
- 痛点：客户每天打电话问订单状态，客服要登录3个系统才能查到，每次至少3分钟
- 现状：团队每天处理200个这类咨询，光查订单就占了4小时
- 目标：让Agent自动查询并回复，把客服的时间释放出来做更有价值的工作
带着数据去沟通，效果完全不一样。
②功能清单：具体需要查什么数据？
用一张简单的表格列出来，IT看到后就知道做什么了，大概如下：
| 功能 | 具体需求 | 预估调用频率 |
|---|---|---|
| 订单查询 | 输入订单号，返回状态和物流信息 | 每天约100次 |
| 客户查询 | 输入客户ID，返回历史订单记录 | 每天约50次 |
| 库存查询 | 输入产品编码，返回当前库存量 | 每天约200次 |
以上两点，站在业务的视角想明白，说清楚，就差不多了。
2.我们会拿到什么？
| IT给你的东西 | 它是什么 | 你拿到后该做什么 |
|---|---|---|
| 接口文档 | API的”使用说明书”，列出了地址、参数、返回值格式 | 仔细阅读，搞清楚每个参数的含义 |
| API密钥 | 你的访问”通行证” | 保管好，配置到Coze的环境变量里，不要泄露 |
| 测试环境地址 | 用来调试的接口地址 | 先在测试环境跑通，确认无误后再切换到正式环境 |
| 技术支持联系人 | 遇到问题找谁 | 记下来，调试时遇到报错随时沟通 |
四、举个例子：搭建”订单查询助手”
回到开头小李的故事。现在IT部门已经提供了订单查询API，我们来搭建这个”订单查询助手”。
我们用底下的虚拟数据做一个举例，帮助理解。
1.最终效果是这样的
客户：”我的订单12345到哪了？”
Agent：”您的订单12345已发货，由顺丰速运承运，快递单号SF123456789，目前正在运输中，预计明天14:00前送达。订单包含：产品A × 2、产品B × 1。”
从客户提问到收到回答，整个过程不超过5秒。
2.IT提供的API文档（示例）
下面这份是模拟的接口文档，实际项目中IT部门会给你类似格式的文档。重点看”请求参数”和”返回示例”这两部分：
{
"接口说明": "订单查询接口",
"请求方式": "GET",
"接口地址": "https://api.company.com/order/query",
"请求参数": {
"order_id": "订单号（必填）"
},
"Header": {
"Authorization": "Bearer {API_KEY}",
"Content-Type": "application/json"
},
"返回示例": {
"status": "success",
"data": {
"order_id": "12345",
"customer_name": "张三",
"status": "已发货",
"logistics": {
"company": "顺丰速运",
"tracking_number": "SF123456789",
"status": "运输中"
},
"eta": "2024-05-15 14:00",
"items": [
{"name": "产品A", "quantity": 2},
{"name": "产品B", "quantity": 1}
]
}
}
}2.动手搭建：五步完成
步骤1：创建工作流。
在Coze工作台点击”创建工作流”，命名为”订单查询助手”。
步骤2：配置输入节点。
在”开始”节点里，添加一个输入参数 order_number（类型：字符串），这就是用户要查询的订单号。
步骤3：配置API节点。
拖入”HTTP请求”节点，按IT给的文档填写（示例）：
①接口地址：填 https://api.company.com/order/query
②请求方式：选 GET
③URL参数：参数名 order_id，值填 {{order_number}}（引用开始节点的输入）
④Header：添加 Authorization，值填 Bearer {{API_KEY}}（引用环境变量）
步骤4：配置大模型节点。
拖入”大模型”节点，让AI把API返回的原始JSON数据”翻译”成客户能看懂的话。提示词参考：
你是一个订单查询助手。请根据以下API返回的订单数据，用友好清晰的语言回复客户。
订单数据：{{API节点的返回结果}}
要求：
1. 先告知订单当前状态
2. 有物流信息就给出快递公司和单号
3. 有预计送达时间就告知客户
4. 语气友好、专业，像一个耐心的客服
步骤5：连接节点并测试。 按顺序连线：开始 → HTTP请求 → 大模型 → 结束。输入测试订单号 12345，点击试运行，观察每个节点的执行结果是否正确。
这就是一个基础的在AI agent工作流里调用业务系统API的案例。
其实作为非IT业务人员，能看明白API是个什么东西、能做什么就行，重点是你怎么把自己的业务需求，清晰的传递给IT人员或者AI，这样才能更好的去搭建自己需要的AI agent。
📋 这套API入门相关模板，我整理成模板了
跟着上面步骤搭要花点时间。想直接拿现成的改，加我微信备注「API入门」，我发你。
🤔 卡在某一步了？
搭建过程里如果哪一步卡住了，如果你照着做没跑通，或者你们公司情况不太一样，可以找我聊聊，我免费帮你看看怎么调。不合适我也会直说。
扫码加我，备注「API入门」领模板
想看更多这类方案，我都整理在 吨师傅工具箱 里了：客户管理、进销存、工单报修……按场景分好类，可以直接抄。
