# Agents & Tools

Transformers Agents is an experimental API which is subject to change at any time. Results returned by the agents

can vary as the APIs or underlying models are prone to change.

To learn more about agents and tools make sure to read the [introductory guide](../transformers_agents). This page

contains the API docs for the underlying classes.

## Agents

We provide three types of agents: [`HfAgent`] uses inference endpoints for opensource models, [`LocalAgent`] uses a model of your choice locally and [`OpenAiAgent`] uses OpenAI closed models.

### HfAgent

[[autodoc]] HfAgent

### LocalAgent

[[autodoc]] LocalAgent

### OpenAiAgent

[[autodoc]] OpenAiAgent

### AzureOpenAiAgent

[[autodoc]] AzureOpenAiAgent

### Agent

[[autodoc]] Agent

    - chat

    - run

    - prepare_for_new_chat

## Tools

### load_tool

[[autodoc]] load_tool

### Tool

[[autodoc]] Tool

### PipelineTool

[[autodoc]] PipelineTool

### RemoteTool

[[autodoc]] RemoteTool

### launch_gradio_demo

[[autodoc]] launch_gradio_demo

## Agent Types

Agents can handle any type of object in-between tools; tools, being completely multimodal, can accept and return

text, image, audio, video, among other types. In order to increase compatibility between tools, as well as to 

correctly render these returns in ipython (jupyter, colab, ipython notebooks, ), we implement wrapper classes

around these types.

The wrapped objects should continue behaving as initially; a text object should still behave as a string, an image

object should still behave as a `PIL.Image`.

These types have three specific purposes:

- Calling `to_raw` on the type should return the underlying object

- Calling `to_string` on the type should return the object as a string: that can be the string in case of an `AgentText`

  but will be the path of the serialized version of the object in other instances

- Displaying it in an ipython kernel should display the object correctly

### AgentText

[[autodoc]] transformers.tools.agent_types.AgentText

### AgentImage

[[autodoc]] transformers.tools.agent_types.AgentImage

### AgentAudio

[[autodoc]] transformers.tools.agent_types.AgentAudio