> ## 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.

# Twilio

**TwilioTools** 支持 Agent 与 [Twilio](https://www.twilio.com/docs) 服务进行交互，例如发送 SMS、检索通话详情和列出消息。

## 先决条件

以下示例需要 `twilio` 库和相应的 Twilio 凭证，可以从[此处](https://www.twilio.com/console)获取。

```shell theme={null}
pip install twilio
```

设置以下环境变量：

```shell theme={null}
export TWILIO_ACCOUNT_SID=***
export TWILIO_AUTH_TOKEN=***
```

## 示例

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

```python theme={null}
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_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](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/twilio.py)
* 查看 [Cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/tools/twilio_tools.py)