工具是赋予AI扩展能力的关键模块。通过添加和创建工具，您的AI将不再局限于对话，而是能够连接外部服务、执行真实世界的任务，例如搜索网页、分析数据、查询订单等，成为您团队中不知疲倦的智能助手。

此外，Kocoro目前暂不支持MCP（多智能体协作平台）类型的工具接入，若您有此类需求，欢迎随时联系我们的客户成功团队，我们非常乐意倾听您的建议。

核心特性

• 能力扩展：让AI突破语言模型的限制，具备查询、计算、执行等多种实用能力。

• 预置工具箱：Kocoro内置了网页搜索、图表生成等常用工具，您可以即开即用。

• 自定义接入：您可以将公司的内部系统（如CRM、ERP、数据库）封装成工具，让AI能够调用您独有的数据和服务。

• 无缝融合：无论是在与AI的日常对话中，还是在构建复杂的智能体时，工具都能被AI在合适的时机自动调用。

使用场景

工具的价值在于将AI与您的实际工作流连接起来。想象一下这些场景：

• 销售团队：当客户在对话中问及某个产品的库存时，AI能自动调用“库存查询”工具，从您的ERP系统中获取实时数据并立即答复。

• 市场团队：您在回顾一场活动，可以直接让AI调用“图表生成”工具，为您绘制易于分析的可视化图表。

• 客户成功团队：当需要了解某个客户的续约情况时，AI可以调用“客户信息”工具，直接从CRM中查询合同到期日、客户健康度等信息，并生成摘要报告。

使用说明

1. 查看已有工具

• 分类筛选： 点击分类，可以快速筛选您想查看的工具列表。

• 搜索工具： 您可以在右上角的搜索框中输入工具名称的关键字，快速找到目标工具。

• 查看详情： 点击工具卡片上的“详情”按钮，可以查看该工具更具体的描述和技术规格。

2. 创建新工具

当您希望将内部系统或某个API服务接入Kocoro时，在工具库页面点击右上角的“新建工具”按钮，即可开始。

2.1 工具信息填写

• 工具图标： 上传一个直观的图标，方便您和团队成员在使用时快速识别。

• 工具名称： 为工具取一个清晰、易懂的名字，例如：“查询订单状态”。这有助于AI和使用者理解其核心功能。

• 工具描述： 请用自然语言、详细地描述这个工具的用途、功能以及在什么情况下应该使用它。AI会根据您的描述来判断何时调用此工具。一个好的描述应该是：“当用户需要根据订单号查询订单的物流状态、支付情况或物流信息时，使用此工具。”

• Schema： 在此粘贴符合OpenAPI v3规范的Schema定义。它就像一份给AI阅读的“使用说明书”，精确地告诉AI这个工具如何工作、需要什么参数（比如订单号）、会返回什么结果。
  如果您不熟悉OpenAPI，可以点击输入框下方的“查看OpenAPI-Swagger规范页”获取详细指引，或寻求团队中开发人员的帮助。一个准确的Schema是工具能被AI正确调用的前提。 请详细查看： https://swagger.io/specification/

• 认证： 如果您的工具需要访问受保护的系统，请在此处配置相应的认证方式，如API Key，确保数据传输的安全。
  请使用认证方式进行授权，而不是将Token写入Schema，以更好保护您的数据安全。

• 隐私政策链接：如果您的工具涉及到一定隐私政策，请在此处配置隐私政策链接。

2.2 预览与保存

您填写的内容可以直接在右侧预览效果，包括结合切换模型、附件、知识库、工具等组合应用的情况。

这方便您一边预览，一边继续在左侧灵活调整内容。

2.3 分享

您可以将保存后的工具分享给整个团队或团队中的特定用户。

请详细参考：资源分享与权限管理

3. 在对话中使用工具

在对话窗口中，如果您希望使用特定工具完成当前工作，可以点击“工具”按钮并在弹出窗口中进行选择。

请详细参考： AI 对话

4. 在智能体中使用工具

在智能体的设置页面中，找到“工具”配置模块，从您的工具库中选择一个或多个工具添加给该智能体。例如，您可以创建一个“售后客服智能体”，并为它配备“查询订单”和“创建工单”两个工具。

请详细参考： 智能体

使用技巧和注意事项

• 描述决定一切：AI能否在恰当的时机使用您的工具，很大程度上取决于“工具描述”是否清晰、准确。请花些时间打磨它。

• 从简单开始：如果您是初次尝试，建议先创建一个不需要认证、参数简单的工具，例如一个“内部术语查询”工具，以便熟悉整个流程。

• 充分测试：在将工具分享给团队前，请在预览窗口用不同的提问方式进行充分测试，确保它在各种情况下都能被稳定触发和执行。

• 安全第一：当工具需要连接到核心业务系统时，请务必使用安全的认证方式，并遵循最小权限原则，仅授予工具完成其任务所必需的权限。

FAQ