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.

uv pip install -U requests openai

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.

cookbook/91_tools/zendesk_tools.py

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