> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk

> Search Zendesk Help Center articles for an Agent with ZendeskTools.

**ZendeskTools** enable an Agent to access Zendesk API to search for articles.

## Prerequisites

The following example requires the `requests` and `openai` libraries and auth credentials.

```shell theme={null}
uv pip install -U requests openai
```

```shell theme={null}
export ZENDESK_USERNAME=***
export ZENDESK_PASSWORD=***
export ZENDESK_COMPANY_NAME=***
```

## Example

The following agent will search Zendesk for "How do I login?" and print the response.

```python cookbook/91_tools/zendesk_tools.py theme={null}
from agno.agent import Agent
from agno.tools.zendesk import ZendeskTools

agent = Agent(tools=[ZendeskTools()])
agent.print_response("How do I login?", markdown=True)
```

## Toolkit Params

| Parameter | Type | Default | Description |
| - | - | - | - |
| `username` | `str` | - | The username used for authentication or identification purposes. |
| `password` | `str` | - | The password associated with the username for authentication purposes. |
| `company_name` | `str` | - | The name of the company related to the user or the data being accessed. |
| `timeout` | `int` | `30` | Timeout for HTTP requests, in seconds. |
| `enable_search_zendesk` | `bool` | `True` | Enable the search Zendesk functionality. |
| `all` | `bool` | `False` | Enable all functionality. |

## Toolkit Functions

| Function | Description |
| - | - |
| `search_zendesk` | This function searches for articles in Zendesk Help Center that match the given search string. |

## Developer Resources

* [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/zendesk.py)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.