工具 - 帆倍 - 帮助文档

1. 概述

工具（Tool）是智能体可以调用的外部功能模块，例如「网页搜索」或「对象数据访问工具组」。技能会根据任务需要决定是否调用这些工具。

在帆倍中，工具通常用于四类动作：读取表单数据、检索上下文、写入记录、执行外部系统动作。

本节列出日常维护工具时需逐项检查的五个点。

关注点	检查方式
工具是否启用	在「工具」列表确认目标工具存在且可用
工具权限是否正确	确认调用方（智能体使用人）具备对应表单与数据权限
数据范围是否合规	核对工具可访问的数据范围是否符合企业安全要求，重点关注通讯录、企业数据等工具组
是否与智能体正确关联	在工具基本信息中查看被哪些智能体挂载调用
调用失败是否可定位	用真实业务问题试跑一次，确认失败时有明确错误提示

1）只给智能体开放业务确实需要的工具，减少误调用与数据暴露面。

2）涉及写入、删除、外部调用的工具要更谨慎，例如对象数据访问工具组中的写操作。

3）当销售反馈 AI「查不到数据」时，排查工具可用性与权限完整性。

目前暂不支持企业自定义添加工具，只能使用帆倍内置的系统工具，且默认挂载。

下列两张表按用途分类，便于快速定位所需能力。

本类工具访问公开互联网或用户上传的附件，不读写 CRM 数据。

工具	说明	典型场景
网页搜索	查询公开互联网信息、新闻、公司官网	访前了解客户近期动态
网页内容提取	从指定 URL 获取全文内容	提取一篇招标公告或新闻正文
网站内容爬取	从指定 URL 开始递归爬取整个网站，返回多个页面的内容	整体了解客户官网的产品与业务结构
附件获取	根据 file_id 获取用户上传附件的文本内容	解析用户上传的会议记录或需求文档

本类工具直接访问 CRM 数据、企业通讯录或外部工商数据，是数据范围与权限核查的重点。

工具组	说明	核查要点
对象数据访问工具组	Agent Object Access 工具组，展开为 obj_* 对象数据增改查工具	含写入能力，需确认调用人具备对应表单的编辑权限
通讯录工具组	企业通讯录查询工具组，支持成员档案、部门、角色、组织树、按部门查成员，数据实时	涉及成员信息，需确认数据范围符合企业安全要求
企业数据工具组	企业外部数据工具组，含 13 个只读 company_* 工具：按名称搜索候选企业获取 credit_code；查询工商档案、股东、高管、集团归属、关系链；融资、招聘、招投标、上市财务信号；经营异常、严重违法、行政处罚风险	全部为只读，使用前需先取得 credit_code 作为查询主键

注意：对象数据访问工具组包含写入与修改能力。请务必只对确有需要的智能体开放，否则存在误写 CRM 数据的风险。

问：销售反馈 AI「查不到数据」，如何排查？

答：按三步排查：

1）在「工具」界面确认目标工具存在且可用；

2）在工具基本信息中确认该工具已挂载到对应智能体；

3）确认提问人具备相关表单与数据权限，权限不足会导致工具返回空结果。

问：能否自行添加企业自定义工具？

答：暂不支持。目前只能使用帆倍内置的系统工具。若内置工具无法满足需求，可通过自定义技能组合现有工具。

问：网页内容提取与网站内容爬取如何选择？

答：只需要某个 URL 的单页正文时用网页内容提取；需要了解整站结构或多页内容时用网站内容爬取。

问：为什么在应用后台看不到「工具」入口？

答：当前账号为普通管理员且未开启「智能体管理」权限。请由企业创建者或系统管理员在「权限中心>管理组」中调整管理范围。

问：如何控制工具能访问的数据范围？

答：工具本身不单独配置数据范围，实际可访问范围由调用人的表单与数据权限决定。请在「业务权限配置」中收紧权限，并只对必要的智能体挂载敏感工具组。