必须通过标准化tool/plugin接入机制连接内部系统或saas服务，否则agent无法识别接口语义；未封装应用需提供openapi 3.0 schema或含method、url、parameters、auth_type的yaml；支持webhook快速注册（https必选）或上传openapi文件；配置启用开关、上下文注入json及调用策略后保存部署即可生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎AI Agent中调用企业内部系统、第三方SaaS或自建HTTP服务，必须通过标准化的Tool/Plugin接入机制完成连接，否则Agent无法识别接口语义、无法参与推理决策链路。
确认目标应用是否已封装为Tool
进入火山引擎控制台 →「Agent Plan」→「技能中心」→「已安装技能」列表。若目标应用（如飞书审批、钉钉考勤、CRM客户查询）已在列表中且状态为“已启用”，跳过本阶段；若未出现，需先完成封装。
未封装的应用必须提供符合OpenAPI 3.0规范的JSON Schema描述文件，或至少包含method、url、parameters、auth_type四项基础字段的YAML配置。缺少Schema会导致Agent无法理解参数含义，调用时会报错“Unknown parameter: xxx”。
手动接入自定义HTTP服务（无现成Tool时）
方法一：使用Webhook Skill快速注册
在「技能中心」→「创建新技能」→ 选择「Webhook」类型 → 填写服务地址（必须是HTTPS，【HTTP地址将被平台自动拒绝】）→ 设置请求方法（GET/POST）→ 在“请求头”中添加Authorization或X-API-Key（若服务要求鉴权）→ 保存后系统自动生成function_name，如webhook_crm_v1。
方法二：上传OpenAPI Schema文件
点击「上传OpenAPI定义」→ 选择本地openapi.json文件 → 系统解析后展示端点列表 → 为每个endpoint勾选“启用为Tool” → 点击「发布」。此方式支持复杂嵌套参数与多响应状态码映射，比Webhook更健壮。
注意：上传的Schema中若包含"securitySchemes"但未在请求头中配置对应凭证，该Tool在运行时会始终返回401错误，且不会提示具体缺失哪一项。
配置Agent调用权限与上下文注入
第一步：进入Agent编辑页 →「工具管理」→ 找到刚接入的Tool → 开启「启用」开关。
第二步：在「上下文配置」区域，粘贴一段JSON格式的初始化数据，例如：{"base_url": "https://api.example.com/v2", "tenant_id": "t-7a8b9c"}。这部分内容会在每次调用前自动注入请求体或URL路径中。
第三步：设置调用策略 → 选择「仅当用户明确提及[客户信息][审批单号]等关键词时触发」或「始终可用」。若选前者，Agent将忽略未命中关键词的请求，避免误调用生产接口。
第四步：点击「保存并部署」→ 等待右上角状态变为「已发布」。此时Agent已具备调用能力，无需重启服务或重新加载模型。
