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

# Zendesk

**ZendeskTools** 使代理能够访问 Zendesk API 来搜索文章。

## 先决条件

以下示例需要 `requests` 库和身份验证凭据。

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

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

## 示例

以下代理将搜索 Zendesk 中的“我该如何登录？”问题，并打印响应。

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

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

## Toolkit 参数

| 参数             | 类型    | 默认值 | 描述                  |
| -------------- | ----- | --- | ------------------- |
| `username`     | `str` | -   | 用于身份验证或标识目的的用户名。    |
| `password`     | `str` | -   | 与用户名关联的用于身份验证的密码。   |
| `company_name` | `str` | -   | 与用户或正在访问的数据相关的公司名称。 |

## Toolkit 函数

| 函数               | 描述                                 |
| ---------------- | ---------------------------------- |
| `search_zendesk` | 此函数在 Zendesk 帮助中心中搜索与给定搜索字符串匹配的文章。 |

## 开发者资源

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