Custom API

CustomApiTools 使代理能够通过可自定义的身份验证和参数向任何外部 API 发出 HTTP 请求。

先决条件

以下示例需要 requests 库。

pip install requests

示例

以下代理将使用 CustomApiTools 向 Dog CEO API 发出 API 调用。

cookbook/tools/custom_api_tools.py

from agno.agent import Agent
from agno.tools.api import CustomApiTools

agent = Agent(
    tools=[CustomApiTools(base_url="https://dog.ceo/api")],
    markdown=True,
)

agent.print_response(
    '向以下两个不同端点发出 API 调用：/breeds/image/random 和 /breeds/list/all，分别获取随机的狗图片和狗品种列表。两个调用均使用 GET 方法。'
)

Toolkit 参数

参数	类型	默认值	描述
base_url	str	None	API 调用的基 URL
username	str	None	基本身份验证的用户名
password	str	None	基本身份验证的密码
api_key	str	None	Bearer token 身份验证的 API 密钥
headers	Dict[str, str]	{}	请求中包含的默认标头
verify_ssl	bool	True	是否验证 SSL 证书
timeout	int	30	请求超时（秒）
make_request	bool	True	是否注册 make_request 函数

Toolkit 函数

函数	描述
make_request	向 API 发出 HTTP 请求。接受 method (GET, POST, 等)、endpoint 以及可选的 params、data、headers 和 json_data 参数。

开发者资源

• 查看 Tools
• 查看 Cookbook