---
title: X
description: 与 X 互动
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="x"
  color="#000000"
/>

{/* MANUAL-CONTENT-START:intro */}
[X](https://x.com/)（前身为 Twitter）是一个流行的社交媒体平台，能够实现实时通信、内容分享以及与全球受众的互动。

Sim 中的 X 集成利用 OAuth 认证与 X API 安全连接，使您的代理能够以编程方式与该平台互动。此 OAuth 实现确保在维护用户隐私和安全的同时，安全访问 X 的功能。

通过 X 集成，您的代理可以：

- **发布内容**：直接从您的工作流中创建新推文、回复现有对话或分享媒体
- **监控对话**：跟踪提及、关键词或特定账户，了解相关讨论
- **与受众互动**：自动回复提及、私信或特定触发器
- **分析趋势**：从热门话题、标签或用户参与模式中收集洞察
- **研究信息**：搜索特定内容、用户资料或对话，为代理决策提供信息

在 Sim 中，X 集成支持复杂的社交媒体自动化场景。您的代理可以监控品牌提及并作出适当回应，根据特定触发器安排和发布内容，进行市场研究的社交聆听，或创建跨越对话式 AI 和社交媒体互动的体验。通过 OAuth 将 Sim 与 X 连接，您可以构建智能代理，在保持一致和响应迅速的社交媒体存在的同时，遵守平台政策和 API 使用的最佳实践。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 X 集成到工作流程中。可以发布新推文、获取推文详情、搜索推文以及获取用户资料。需要 OAuth。

## 工具

### `x_write`

在 X（Twitter）上发布新推文、回复推文或创建投票

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `text` | string | 是 | 推文的文本内容 |
| `replyTo` | string | 否 | 要回复的推文 ID |
| `mediaIds` | array | 否 | 要附加到推文的媒体 ID 数组 |
| `poll` | object | 否 | 推文的投票配置 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `tweet` | object | 新创建的推文数据 |

### `x_read`

读取推文详情，包括回复和对话上下文

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tweetId` | string | 是 | 要读取的推文 ID |
| `includeReplies` | boolean | 否 | 是否包含推文的回复 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `tweet` | object | 主推文数据 |

### `x_search`

使用关键词、标签或高级查询搜索推文

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | string | 是 | 搜索查询（支持 X 搜索操作符） |
| `maxResults` | number | 否 | 返回的最大结果数（默认：10，最大：100） |
| `startTime` | string | 否 | 搜索的开始时间（ISO 8601 格式） |
| `endTime` | string | 否 | 搜索的结束时间（ISO 8601 格式） |
| `sortOrder` | string | 否 | 结果的排序顺序（按时间或相关性） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `tweets` | 数组 | 符合搜索查询的推文数组 |

### `x_user`

获取用户资料信息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `username` | 字符串 | 是 | 要查找的用户名（不含 @ 符号） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `user` | 对象 | X 用户资料信息 |
