Spaces:
Sleeping
Sleeping
| <!--Copyright 2024 The HuggingFace Team. All rights reserved. | |
| Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with | |
| the License. You may obtain a copy of the License at | |
| http://www.apache.org/licenses/LICENSE-2.0 | |
| Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on | |
| an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the | |
| specific language governing permissions and limitations under the License. | |
| ⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be | |
| rendered properly in your Markdown viewer. | |
| --> | |
| # 工具 | |
| <Tip warning={true}> | |
| Smolagents 是一个实验性 API，可能会随时更改。由于 API 或底层模型可能发生变化，代理返回的结果可能会有所不同。 | |
| </Tip> | |
| 要了解更多关于智能体和工具的信息，请务必阅读[入门指南](../index)。本页面包含底层类的 API 文档。 | |
| ## 工具 | |
| ### load_tool | |
| [[autodoc]] load_tool | |
| ### tool | |
| [[autodoc]] tool | |
| ### Tool | |
| [[autodoc]] Tool | |
| ### launch_gradio_demo | |
| [[autodoc]] launch_gradio_demo | |
| ## 默认工具 | |
| ### PythonInterpreterTool | |
| [[autodoc]] PythonInterpreterTool | |
| ### FinalAnswerTool | |
| [[autodoc]] FinalAnswerTool | |
| ### UserInputTool | |
| [[autodoc]] UserInputTool | |
| ### DuckDuckGoSearchTool | |
| [[autodoc]] DuckDuckGoSearchTool | |
| ### GoogleSearchTool | |
| [[autodoc]] GoogleSearchTool | |
| ### VisitWebpageTool | |
| [[autodoc]] VisitWebpageTool | |
| ### SpeechToTextTool | |
| [[autodoc]] SpeechToTextTool | |
| ## 工具集合 | |
| [[autodoc]] ToolCollection | |
| ## 智能体类型 | |
| 智能体可以处理工具之间的任何类型的对象；工具是完全多模态的，可以接受和返回文本、图像、音频、视频以及其他类型的对象。为了增加工具之间的兼容性，以及正确呈现在 ipython（jupyter、colab、ipython notebooks 等）中的返回结果，我们为这些类型实现了包装类。 | |
| 被包装的对象应该继续保持其初始行为；例如，一个文本对象应继续表现为字符串，一个图像对象应继续表现为 `PIL.Image`。 | |
| 这些类型有三个特定的用途： | |
| - 调用 `to_raw` 方法时，应返回底层对象 | |
| - 调用 `to_string` 方法时，应将对象转换为字符串：对于 `AgentText` 类型，可以直接返回字符串；对于其他实例，则返回对象序列化版本的路径 | |
| - 在 ipython 内核中显示时，应正确显示对象 | |
| ### AgentText | |
| [[autodoc]] smolagents.agent_types.AgentText | |
| ### AgentImage | |
| [[autodoc]] smolagents.agent_types.AgentImage | |
| ### AgentAudio | |
| [[autodoc]] smolagents.agent_types.AgentAudio | |