Twilio

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 [phone]", markdown=True)

Toolkit 参数

名称	类型	默认	描述
account_sid	Optional[str]	None	Twilio 账户 SID，用于身份验证。
auth_token	Optional[str]	None	Twilio Auth Token，用于身份验证。
api_key	Optional[str]	None	Twilio API Key，用于替代身份验证。
api_secret	Optional[str]	None	Twilio API Secret，用于替代身份验证。
region	Optional[str]	None	可选的 Twilio 区域 (例如：au1)。
edge	Optional[str]	None	可选的 Twilio 边缘位置 (例如：sydney)。
debug	bool	False	启用调试日志记录以进行故障排除。

Toolkit 函数

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

开发者资源

• 查看 Tools
• 查看 Cookbook