TwilioTools 支持 Agent 与 Twilio 服务进行交互,例如发送 SMS、检索通话详情和列出消息。

先决条件

以下示例需要 twilio 库和相应的 Twilio 凭证,可以从此处获取。

pip install twilio

设置以下环境变量:

export TWILIO_ACCOUNT_SID=***
export TWILIO_AUTH_TOKEN=***

示例

以下 Agent 将使用 Twilio 发送 SMS 消息:

from agno.agent import Agent
from agno.tools.twilio import TwilioTools

agent = Agent(
    instructions=[
        "Use your tools to send SMS using Twilio.",
    ],
    tools=[TwilioTools(debug=True)],
    show_tool_calls=True,
)

agent.print_response("Send an SMS to +1234567890", markdown=True)

Toolkit 参数

名称类型默认描述
account_sidOptional[str]NoneTwilio 账户 SID,用于身份验证。
auth_tokenOptional[str]NoneTwilio Auth Token,用于身份验证。
api_keyOptional[str]NoneTwilio API Key,用于替代身份验证。
api_secretOptional[str]NoneTwilio API Secret,用于替代身份验证。
regionOptional[str]None可选的 Twilio 区域 (例如:au1)。
edgeOptional[str]None可选的 Twilio 边缘位置 (例如:sydney)。
debugboolFalse启用调试日志记录以进行故障排除。

Toolkit 函数

函数描述
send_sms向接收者发送 SMS。需要接收者电话号码、发送者号码 (Twilio) 和消息正文。成功时返回消息 SID 或失败时返回错误消息。
get_call_details使用电话的 SID 检索通话详情。需要通话 SID,并返回包含通话详情的字典 (例如:状态、时长)。
list_messages列出最近的 SMS 消息。需要返回的消息数量的限制 (默认为 20)。返回消息详情列表 (例如:SID、发送者、接收者、正文、状态)。

开发者资源