智能体 (Agent) 能够帮您零代码构建专属的AI业务助手，它可以集成内部知识、连接外部工具，像一位真正的同事那样，自动处理特定领域的重复工作。
为什么构建智能体：
智能体不是简单的问答机器人，而是能够像人一样思考和工作：
- 理解复杂需求：听懂您的业务目标，即使描述不够详细
- 主动制定方案：像资深员工一样分析问题并提出解决思路
- 独立完成任务：从开始到结束，无需您一步步指导
核心特性
- 可视化配置：通过自然语言描述和选项勾选，即可完成智能体的所有设置，无需编写任何代码。
- 知识库集成：轻松关联企业内部的文档、FAQ和产品资料，让智能体基于准确、权威的知识进行回答。
- 工具与数据源扩展：支持接入外部应用工具和内部业务数据源，让智能体具备执行复杂任务和查询实时数据的能力。
- 团队共享与协作：创建好的智能体可以方便地分享给团队成员，让优质的AI能力在组织内快速复用。
使用场景
- 营销内容助手：结合产品资料和市场趋势，高效生成符合品牌调性的社交媒体文案、广告语和博客文章。
- 运营分析助手：自动聚合和分析多源运营数据，帮助管理层监控关键业绩指标（KPI），发现趋势与异常，支持业务及时调整。
- 销售支持助手：学习产品白皮书和成功案例，帮助销售团队快速生成定制化的销售方案和应答话术。
- 内部知识问答：作为新员工的入职伙伴或团队的知识库，随时回答关于公司流程、规章制度或业务规范的提问。
使用说明
1. 查看已有智能体
- 分类筛选： 点击分类，可以快速筛选您想查看的工具列表。
- 搜索智能体： 您可以在右上角的搜索框中输入智能体名称的关键字，快速找到目标智能体。
- 查看详情： 点击智能体卡片上的“详情”按钮，可以查看该智能体更具体的描述和操作说明。
- 新对话：当您决定使用时，点击新对话，即可发起与当前智能体的对话。
2. 新建智能体
在Kocoro工作台左侧导航栏进入「智能体」，然后点击页面右上角的”新建智能体”按钮，即可开始创建您的智能体。
2.1 智能体基本信息
- 智能体名称：一个简洁明了的名称，方便团队成员识别和使用，例如“售后问题小助手”。
- 描述：简单说明这个智能体的用途和擅长解决的问题，便于团队理解它擅长的工作。
- 头像：可以上传或选择系统预设的头像，在切换模型的列表中和对话记录中更容易找到这个智能体。
2.2 智能体系统指令
指令是智能体的“大脑”，它决定了智能体的角色、行为和沟通方式。请在指令中，用清晰的语言告诉它：
- 它的角色：例如，“你是一位专业的Kocoro产品客服。”
- 它的核心任务：例如，“你的任务是根据知识库内容，准确回答用户关于产品功能的问题。”
- 沟通风格和要求：例如，“请使用亲切、专业的语气。回答时必须优先引用知识库，并给出引用来源。”
- 限制与边界：例如，“如果知识库中没有相关内容，请不要猜测，并礼貌地引导用户联系人工客服。”
2.3 选择AI模型
点击”模型“选项，根据您的业务需求选择一个合适的底层AI模型。不同模型在推理能力、响应速度和成本上有所差异。
2.4 添加工具
工具是赋予AI外部能力的关键模块。通过添加官方工具，您的AI不仅能聊天，还能执行复杂任务，如网页搜索、内容读取、数据分析、图表生成等，大大扩展智能体的实用性和业务价值。
2.4.1 选择工具
在智能体配置界面，找到工具区域，点击添加按钮，打开工具选择列表。
勾选所需工具，保存即可，无需复杂配置。
目前平台内置以下主流官方工具：
| 工具名 | 功能简介 | 典型应用场景 |
|---|---|---|
| Artifacts | 让AI通过代码生成Web应用、数据图表、可视化内容 | 生成交互小程序、可视化报告 |
| Web Search | 实时检索互联网信息、获取最新数据 | 搜新闻、查资料、市场趋势分析 |
| Link Reader | 读取指定URL内容并总结要点 | 网页/长文内容提取、摘要 |
| Chart Generator | 多类型图表生成与数据可视化 | 自动画图、报表输出、KPI展示 |
| Math calculator | 支持复杂数学表达式和公式自动计算 | 财务分析、工程计算、自动评分 |
2.4.2 在提示词中说明工具使用
如需让AI主动调用工具，建议在指令中明确工具的调用场景和触发条件。例如：
- 如遇到需要查找最新信息，请优先使用”Web Search“工具。
- 遇到用户请求‘生成图表’，请先调用“Chart Generator”。
2.4.3 测试技能效果
完成工具添加后，在预览区域输入相关指令，如：
- 请帮我查找2025年AI行业最新趋势。
- 把下面的销售数据生成可视化柱状图。
- 帮我总结这篇网页内容：[URL]
- 计算表达式：(2+3)*8/5
确定AI是否正确使用了对应的工具，并返回相应结果。
- 信息检索+内容摘要：Web Search + Link Reader，适合知识密集型助手。
- 数据分析+可视化：Chart Generator + Math calculator，适合报表分析类Agent。
- 智能应用开发：Artifacts，适合需要自动生成Web小工具、交互内容的场景。
过多工具会导致AI理想意图和选择工具的场景变得格外复杂，甚至容易在使用时超出上下文窗口限制。
建议按需选择，避免过度堆砌，确保智能体行为简洁高效。
更多关于工具的说明，请详细参考： 工具
2.5 添加知识文档
为AI添加知识库后，AI将能够引用专业文档、产品说明、FAQ等结构化知识，实现更准确、更专业的智能问答与业务支持。这是打造企业专属AI助手的关键步骤。
2.5.1 选择知识文档
在智能体配置界面，找到知识区域，点击添加按钮，打开知识选择列表。
2.5.2 在提示词中说明知识文档使用
如需让AI主动调用知识查询，建议在指令中明确知识文档的调用场景和触发条件。例如：
- 请使用知识库”客户反馈“中的证言支持你的洞察建议。
- 请使用知识库“品牌规范”中的要求生成内容。
2.5.3 测试知识文档效果
完成知识文档添加后，在预览区域输入相关指令，如：
- 给我关于A行业的客户反馈
- 帮我基于品牌规范撰写页面内容
确定AI是否正确使用了对应的知识文档，并返回相应结果。
- 按业务需求选择知识库：如客服型AI选择FAQ、产品资料，分析型AI可选择行业报告、技术文档。
- 定期维护知识库：保持内容更新，确保AI输出的知识始终准确。
- 多知识库组合：支持同时关联多个知识库，满足复杂/多元的业务场景。
更多关于知识文档的说明，请详细参考： 知识管理
2.6 添加数据源
如果需要AI查询数据，可以在此连接已配置好的数据源。
2.6.1 选择数据源
在智能体配置界面，找到数据源区域，点击添加按钮，打开数据源选择列表。
2.6.2 在提示词中说明数据源使用
如需让AI主动调用数据源查询，建议在指令中明确知识文档的调用场景和触发条件。例如：
- 请查询数据源“Google Analytics”以获取最近网站表现，包括流量、转化、来源、页面表现等分析。
2.6.3 测试知识文档效果
完成数据源添加后，在预览区域输入相关指令，如：
- 最近转化怎么样？
- 最近哪些来源表现好？
确定AI是否正确使用了对应的数据查询，并返回相应结果。
2.7 引导用户：配置对话建议
为了让使用者能快速上手，您可以预设一些常见的提问。点击“提示词建议”下方的“添加”按钮，创建几个高质量的提问示例。这些建议会展示在对话窗口的初始界面，用户点击即可直接提问。
用法与您为自己创建常用提示词一直，请详细参考 提示词库
2.8 撰写智能体使用说明
想象成是您为智能体撰写的一份专属“Readme”或使用说明书，它能帮助团队里的其他同事快速了解这个智能体的能力：它擅长做什么、可以向它提什么样的问题，以及使用时有哪些注意事项。
一份清晰的介绍，能大大降低其他成员的使用门槛，让您的智能体发挥出最大价值。
当使用者点击查看智能体“详情”时，它将这样呈现：
2.8.1 撰写说明文档
- 在智能体创建或编辑页面的顶部，从「配置」切换到「请阅读」标签页。
- 在文本编辑器中，为您的智能体撰写介绍内容。您可以利用工具栏设置标题、加粗、列表等格式，让内容更清晰易读。
- 说明文档中支持插入图片，可以更清晰地介绍您的智能体使用方法
2.8.2 说明文档辅助生成
非常推荐您初始使用说明文档的辅助生成，它可以帮助您快速生成一份专业的介绍。
- 点击右上角的智能生成图标。
- 在弹出的“用户指南智能生成”窗口中，您可以选择性地补充一些额外说明，例如这个智能体的使用要点或注意事项，这能让AI生成的内容更精准、更贴心。
- 即使您不提供任何额外描述，Kocoro也会根据您前序的智能体设置为您撰写一份结构清晰的ReadMe初稿。
- 生成的内容会显示在右侧的“预览与修改”区域。您可以在这里直接对文案进行编辑和微调。确认内容满意后，点击右下角的“应用”按钮，这份介绍就会自动填充到ReadMe编辑器中，省去了您手动撰写的麻烦。
2.9 预览与保存
您智能体的效果可以直接在右侧预览效果，您可以一边预览，一边继续在左侧灵活调整内容。
同样地，用户在于智能体对话时，也将不能自由选择模型、工具与知识文档，以避免超出智能体设计能力范围的使用情况。
2.10 分享
您可以将保存后的提示词分享给整个团队或团队中的特定用户。
请详细参考：资源分享与权限管理
3. 智能体的使用
3.1 打开指定智能体
除了在智能体列表中选择“对话”，您还可以在新建对话后，直接在模型列表中搜索或选择指定智能体。
3.2 查看智能体介绍
- 对话前，在对话框上方点击智能体详情按钮，可以查看详细的智能体说明
- 对话中，也可以在右上角找到智能体详情按钮，便利地确认智能体说明，或快速调用“提示词建议”
使用技巧和注意事项
- 指令清晰是关键：指令写得越明确、具体，智能体的表现就越稳定。
- 工具与知识文档少而精：关联工具与知识文档时，优先选择与智能体职责最相关的内容。关联过多不相关的能力，反而可能影响回答的准确性和响应速度。
- 从简单到复杂：初次创建时，可以先不添加工具和数据源，只配置好指令和核心知识库，测试基础问答效果。待效果稳定后，再逐步为它增加更复杂的能力。
- 安全第一：在指令和知识库内容中，避免包含任何敏感数据或个人隐私信息。通过Kocoro的权限体系，严格控制智能体的分享范围。
- 持续优化：定期查看对话记录，分析用户的高频问题和智能体的回答情况，据此反向优化指令和知识库内容，让它越用越聪明。