工具
<p>工具用于拓展智能体应用的能力边界。通常包含一个或多个API或其他能力，例如内容检索、图片理解、数据处理等。例如在智能体内添加天气搜索工具，那么此智能体将拥有搜索天气的能力。</p>
<p><img src="https://k36drdpyul.feishu.cn/space/api/box/stream/download/asynccode/?code=YjcxZjAxYmRkNWUwOGE3MTM5YmIwMzhhZTJlOWNhOGZfZlBnOVdJVVRMSENwODQ4TTdTTExXV1Rwam5JTm5QU1NfVG9rZW46VkZDTGJlbjYwb3JzMVh4Wlc2dmNNZjNPbklkXzE3MzUwMTAzMjE6MTczNTAxMzkyMV9WNA" alt="" /></p>
<h2>内置工具</h2>
<p>平台集成一些常用内置工具，点击左侧导航进入工具页面后切换至内置tab后可以查看内置工具。用户可以选择内置工具辅助开发者创建自主规划应用或工作流编排应用。</p>
<h2>自定义工具</h2>
<h3>通过工作流创建</h3>
<ul>
<li>
<p>登录智能体应用开发平台</p>
</li>
<li>
<p>在页面左侧的<strong>工具</strong>后，点击页面中右侧的<strong>创建工具</strong>按钮，点击<strong>通过工作流创建</strong>。</p>
</li>
<li>输入应用名称和简介，使用内置头像或单击<strong>头像图标</strong>上传自定义头像</li>
</ul>
<p><img src="https://k36drdpyul.feishu.cn/space/api/box/stream/download/asynccode/?code=YzVkYTZlYTIyNmZjMmNjNWJhNDgyMGJiYTI0YjAwMzFfYXdJV1BlWlRhUndGSUNncmxGRk5LRkhZcWw5eE1JcnZfVG9rZW46WFZpVWI1VVpXb3NGRHB4Z014cmNYUE9GbkZmXzE3MzUwMTAzMjE6MTczNTAxMzkyMV9WNA" alt="" /></p>
<p>完成创建后会进入工作流编排页面，工作流编排功能与工作流编排应用大致相同，因工具中的工作流创建方式不包含对话功能，故存在以下区别：</p>
<ul>
<li>
<p><strong>开始节点中的系统变量如下：</strong></p>
<p><!--br {mso-data-placement:same-cell;}--> td {white-space:nowrap;border:0.5pt solid #dee0e3;font-size:10pt;font-style:normal;font-weight:normal;vertical-align:middle;word-break:normal;word-wrap:normal;}</p>
<p><table style="border-collapse: collapse;"><colgroup><col width="171"><col width="105"><col width="443"></colgroup><tbody><tr height="27"><td style="background-color:rgb(41, 114, 244);color:rgb(255, 255, 255);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">变量名称</td><td style="background-color:rgb(41, 114, 244);color:rgb(255, 255, 255);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">数据类型</td><td style="background-color:rgb(41, 114, 244);color:rgb(255, 255, 255);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">说明</td></tr><tr height="27"><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">sys.files</td><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">Array[File]</td><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">文件参数，存储用户初始使用应用时上传的图片</td></tr><tr height="45"><td style="background-color:rgb(229, 239, 255);color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">sys.user_id</td><td style="background-color:rgb(229, 239, 255);color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">String</td><td style="background-color:rgb(229, 239, 255);color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">用户 ID，每个用户在使用工作流应用时，系统会自动向用户分配唯一标识符，用以区分不同的对话用户</td></tr><tr height="45"><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">sys.app_id</td><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">String</td><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">应用 ID，系统会向每个 应用分配一个唯一的标识符，用以区分不同的应用，并通过此参数记录当前应用的基本信息</td></tr><tr height="27"><td style="background-color:rgb(229, 239, 255);color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">sys.workflow_id</td><td style="background-color:rgb(229, 239, 255);color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">String</td><td style="background-color:rgb(229, 239, 255);color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">用于记录当前 应用内所包含的所有节点信息</td></tr><tr height="27"><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">sys.workflow_run_id</td><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">String</td><td style="color:rgb(0, 0, 0);word-wrap:break-word;word-break:break-word;white-space:pre-wrap;border-top:0.5pt solid rgb(203, 205, 209);border-right:0.5pt solid rgb(203, 205, 209);border-bottom:0.5pt solid rgb(203, 205, 209);border-left:0.5pt solid rgb(203, 205, 209);">应用运行 ID，用于记录应用中的运行情况</td></tr></tbody></table></p>
</li>
<li>
<p><strong>结束节点</strong></p>
<p><img src="https://k36drdpyul.feishu.cn/space/api/box/stream/download/asynccode/?code=MGJiZDA1ZjEzMzRhMDk3MWNhNDZlMDg4ZmI0OGJiM2RfUGVzZm5sb2hQRm40bFJWZVhzU1NCeGFwQk5kRjJNTDdfVG9rZW46VHBiRGIzbDJtb1F4Mk54YTFZV2M5TlVubmpiXzE3MzUwMTAzMjE6MTczNTAxMzkyMV9WNA" alt="" /></p>
<ul>
<li>
<p>定义一个工作流程结束的最终输出内容。工作流在完整执行后都需要至少一个结束节点，用于输出完整执行的最终结果。</p>
</li>
<li>
<p>结束节点为流程终止节点，后面无法再添加其他节点，工作流应用中只有运行到结束节点才会输出执行结果。若流程中出现条件分叉，则需要定义多个结束节点。</p>
</li>
<li>结束节点需要声明一个或多个输出变量，声明时可以引用任意上游节点的输出变量。</li>
</ul>
</li>
<li>
<p><strong>其他与工作流编排应用区别</strong></p>
<ul>
<li>
<p>无会话变量配置</p>
</li>
<li>
<p>无回复节点</p>
</li>
<li>
<p>无日志与标注功能</p>
</li>
<li>无监控功能</li>
</ul>
</li>
<li>
<p><strong>保存与发布</strong></p>
<ul>
<li>
<p>支持单次运行或者上传批量运行所需的入参文件进行工具效果测试。</p>
</li>
<li>
<p>完成配置的工作流需要点击右上角发布菜单中的工具配置进行入参设置，正确完成设置的工具支持添加至应用。</p>
<p><img src="https://k36drdpyul.feishu.cn/space/api/box/stream/download/asynccode/?code=ZDA5Y2VjMDAwODFkNGE2Mjc5NTE4ZjBjY2FiYjM3MmRfbXR3eDdqc0hoeWtlZHNrMmNSeUJ2ZTBoc2VnMGQ0OXVfVG9rZW46VWlMN2JFbWtxb1lyNTd4d2VHeGM0a2hwblZjXzE3MzUwMTAzMjE6MTczNTAxMzkyMV9WNA" alt="" /></p>
</li>
</ul>
</li>
</ul>
<h3>通过OPENAPI Schema创建</h3>
<ul>
<li>
<p>登录智能体应用开发平台</p>
<ul>
<li>
<p>点击<strong>工具页面</strong>中右侧的<strong>创建工具</strong>按钮，点击<strong>OPENAPI Schema</strong>工具。</p>
</li>
<li>输入工具配置信息进行工具创建，完成创建的工具支持在应用中使用。</li>
</ul>
<p><img src="https://k36drdpyul.feishu.cn/space/api/box/stream/download/asynccode/?code=Nzk1ZTE3NGM2ZWVkODQzMDA0MWJiZGY2ZmVlMTc1ODlfRHg5VzZ3cjhsRlRLdDBVRDVsSUN4OTBVQmQyN2JtdVpfVG9rZW46RXV6NGJxcXpwb0VjaE54aHRRemNSd0FEbjNVXzE3MzUwMTAzMjE6MTczNTAxMzkyMV9WNA" alt="" /></p>
<ul>
<li>
<p>工具名称：用户可自定义工具名称</p>
</li>
<li>
<p>Schema：</p>
<ul>
<li>
<p>支持 OpenAPI / Swagger 规范。你可以将 OpenAPI schema 内容直接粘贴或从 URL 内导入。</p>
</li>
<li>工具目前支持两种鉴权方式：无鉴权 和 API Key。</li>
</ul>
</li>
<li>
<p>工具列表：</p>
<ul>
<li>在导入 Schema 内容后系统会主动解析文件内的参数，并可预览工具具体的参数、 方法、路径。您也可以在此对工具参数进行测试。</li>
</ul>
</li>
</ul>
</li>
</ul>