X (Twitter) Tìm kiếm
Công cụ
x_search cho phép tác nhân tìm kiếm trực tiếp các bài đăng, hồ sơ và chủ đề X (Twitter). Nó được hỗ trợ bởi công cụ
x_search tích hợp của xAI trên API phản hồi tại
https://API.x.ai/v1/responses — Grok tự chạy phía máy chủ tìm kiếm và trả về kết quả tổng hợp kèm theo trích dẫn cho các bài đăng gốc.
**Sử dụng tùy chọn này thay vì `web_search
** khi bạn đặc biệt muốn thảo luận, phản ứng hoặc tuyên bố hiện tại về X. Đối với các trang web chung, hãy tiếp tục sử dụng
web_search /
`web_extract
.
Xác thực``x_search
` đăng ký khi hoặc đường dẫn thông tin xác thực xAI khả dụng:
| Thông tin xác thực | Nguồn | Thiết lập | |----------||--------|-------| | SuperGrok / X Premium+ OAuth (ưu tiên) | Đăng nhập trình duyệt tại `accounts.x.ai
, được làm mới tự động | `Hermes auth add xai-OAuth
- xem xAI Grok OAuth (SuperGrok / X Premium+) | | ** `XAI_API_KEY
** | Khóa API xAI trả phí | Đặt trong
~/.Hermes/.env ` |
Cả hai đều đạt cùng một điểm cuối với cùng tải trọng - điểm khác biệt duy nhất là mã thông báo mang. Khi cả hai đều được định cấu hình, SuperGrok OAuth sẽ thắng vì vậy x_search chạy theo hạn mức đăng ký của bạn thay vì chi tiêu API phải trả phí.
check_fn
của công cụ này chạy trình phân giải thông tin xác thực xAI mỗi khi danh sách công cụ của mô hình được xây dựng lại. Trả về True
` có nghĩa là vật mang có thể tìm nạp VÀ không trống VÀ (nếu nó đã hết hạn) được làm mới thành công. Mã thông báo bị thu hồi khi làm mới không thành công sẽ ẩn công cụ khỏi lược đồ; đơn giản là mô hình không thể nhìn thấy nó.
Kích hoạt công cụ
Tự động bật khi có thông tin đăng nhập xAI (mã thông báo OAuth hoặc `XAI_API_KEY
). Tắt rõ ràng thông qua
Hermes tools → Tìm kiếm → x_search nếu bạn không muốn điều này.
Hermes tools
# → 🐦 X (Twitter) Search (press space to toggle on)
`
``Bộ chọn cung cấp hai lựa chọn thông tin xác thực:
1. **xAI Grok OAuth (Đăng ký SuperGrok)** — mở trình duyệt tới
`accounts.x.ai
` nếu bạn chưa đăng nhập
2. **Khóa API xAI** — lời nhắc dành cho
`XAI_API_KEY
``Hoặc là sự lựa chọn thỏa mãn các cổng. Bạn có thể chọn bất kỳ thông tin xác thực nào bạn đã có; công cụ này hoạt động giống hệt nhau với cả hai. Nếu cả hai đều được định cấu hình thì OAuth sẽ được ưu tiên tại thời điểm gọi.
## Cấu hình
``` yaml
# ~/.Hermes/config.yaml
x_search:
# xAI model used for the Responses call.
# grok-4.20-reasoning is the recommended default; any Grok model
# with x_search tool access works.
model: grok-4.20-reasoning
# Request timeout in seconds. x_search can take 60–120s for
# complex queries — the default is generous. Minimum: 30.
timeout_seconds: 180
# Number of automatic retries on 5xx / ReadTimeout / ConnectionError.
# Each retry backs off (1.5x attempt seconds, capped at 5s).
retries: 2
`
## Thông số công cụ
Tác nhân gọi
`x_search
` với các đối số sau:
| Tham số | Loại | Mô tả |
|----------|------|-------------|
|
`query
` | chuỗi (bắt buộc) | Những gì cần tra cứu trên X. |
|
`allowed_x_handles
` | mảng chuỗi | Danh sách thẻ điều khiển tùy chọn bao gồm **độc quyền** (tối đa 10).
@
` dẫn đầu bị loại bỏ. |
|
`excluded_x_handles
` | mảng chuỗi | Danh sách các thẻ điều khiển tùy chọn cần loại trừ (tối đa 10). Loại trừ lẫn nhau với
`allowed_x_handles
. |
|
`from_date
` | chuỗi | Ngày bắt đầu
`YYYY-MM-DD
` tùy chọn. |
|
`to_date
` | chuỗi | Ngày kết thúc
`YYYY-MM-DD
` tùy chọn. |
|
`enable_image_understanding
` | boolean | Yêu cầu xAI phân tích hình ảnh đính kèm với bài đăng phù hợp. |
|
`enable_video_understanding
` | boolean | Yêu cầu xAI phân tích các video đính kèm với bài đăng phù hợp. |
Công cụ trả về JSON với:
-
`answer
` — phản hồi văn bản tổng hợp từ Grok
-
`citations
- các trích dẫn được trả về bởi trường cấp cao nhất của API phản hồi
-
`inline_citations
` — Các chú thích
`url_citation
` được trích xuất từ nội dung thư (mỗi chú thích có
`url
,
`title
,
`start_index
,
`end_index
)
-
`degraded
` —
`true
` khi bất kỳ bộ lọc thu hẹp nào (
`allowed_x_handles
,
`excluded_x_handles
,
`from_date
,
`to_date
) được đặt VÀ cả hai kênh trích dẫn đều trống. Trong trường hợp đó,
`answer
` được tổng hợp từ kiến thức riêng của mô hình chứ không phải chỉ số X, vì vậy hãy coi nó là không có nguồn gốc. Mặt khác là
`false
` (bao gồm cả trường hợp "không đặt bộ lọc" - một câu trả lời không có nguồn gốc rộng rãi chỉ là một câu trả lời chứ không phải là một bộ lọc bị thiếu)
-
`degraded_reason
` — đặt tên chuỗi ngắn mà bộ lọc đang hoạt động hoặc
`null
` khi
`degraded
` là
`false
-
`credential_source
` —
"xai-OAuth"
` nếu OAuth được giải quyết,
"xai"
` nếu khóa API được giải quyết
-
`model
,
`query
,
`provider
,
`tool
,
`success
### Xác thực ngày``from_date
` /
`to_date
` được xác thực phía máy khách trước lệnh gọi HTTP:- Cả hai, nếu được cung cấp, phải phân tích thành
`YYYY-MM-DD
.
- Khi cả hai được thiết lập,
`from_date
` phải ở trên hoặc trước
`to_date
.
-
`from_date
` không được muộn hơn UTC hôm nay — không bài đăng nào có thể tồn tại trong cửa sổ chưa bắt đầu, vì vậy cuộc gọi sẽ được đảm bảo trả về 0 trích dẫn.
- Cho phép
`to_date
` trong tương lai (người gọi có thể yêu cầu hợp pháp "từ hôm qua đến ngày mai" để nhận các bài đăng khi họ đến).
Lỗi xác thực xuất hiện dưới dạng kết quả của công cụ
\{"error": "..."}
` có cấu trúc, không bao giờ dưới dạng lệnh gọi HTTP tới xAI.
## Ví dụ
Trao đổi với đại lý:`> Mọi người trên X nói gì về tính năng hình ảnh mới của Grok? Tập trung vào phản hồi từ @xai.
Đại lý sẽ:
1. Gọi
`x_search
` bằng
`query="reactions to new Grok image features"
,
`allowed_x_handles=["xai"]
2. Lấy lại câu trả lời tổng hợp kèm theo danh sách trích dẫn liên kết tới các bài viết cụ thể
3. Trả lời kèm theo câu trả lời và tài liệu tham khảo
## Khắc phục sự cố
### "Không có thông tin xác thực xAI"
Công cụ này sẽ hiển thị điều này khi cả hai đường dẫn xác thực đều không thành công. Đặt
`XAI_API_KEY
` trong
~/.Hermes/.env
` hoặc chạy
`Hermes auth add xai-OAuth
` và hoàn tất đăng nhập trình duyệt. Sau đó khởi động lại phiên của bạn để tác nhân đọc lại sổ đăng ký công cụ.
### "
`x_search
` không được kích hoạt cho kiểu máy này"``x_search.model
` được định cấu hình không có quyền truy cập vào công cụ
`x_search
` phía máy chủ. Chuyển sang
`grok-4.20-reasoning
` (mặc định) hoặc mẫu Grok khác hỗ trợ nó. Kiểm tra [xAI documentation](https://docs.x.ai/) để biết danh sách hiện tại.
### Công cụ không xuất hiện trong lược đồ
Hai nguyên nhân có thể:
1. **Bộ công cụ chưa được bật.** Chạy
`Hermes tools
` và xác nhận
🐦 X (Twitter) Search
` đã được chọn.
2. **Không có thông tin xác thực xAI.** check_fn trả về Sai, do đó lược đồ vẫn bị ẩn. Chạy
`Hermes auth status
` để xác nhận trạng thái đăng nhập xai-OAuth và kiểm tra xem
`XAI_API_KEY
` đã được đặt chưa (nếu bạn đang sử dụng đường dẫn khóa API).
###
`degraded: true
- câu trả lời không có trích dẫn
Khi bạn sử dụng
`allowed_x_handles
,
`excluded_x_handles
` hoặc một phạm vi ngày và phản hồi trả về
`degraded: true
, chỉ mục X của xAI không trả về bài đăng trùng khớp nào nhưng Grok vẫn tạo ra câu trả lời tổng hợp từ dữ liệu đào tạo của chính nó. Câu trả lời không có nguồn gốc - đừng coi nó là kết quả X thực sự.
Nguyên nhân đáng để kiểm tra:
- **Lỗi đánh máy ở phần tay cầm.** Loại bỏ
@
, kiểm tra kỹ chính tả và xác nhận tài khoản tồn tại.
- **Phạm vi ngày quá hẹp** hoặc trượt qua các bài đăng của ngày hôm nay; mở rộng và thử lại.
- **khoảng cách chỉ số xAI.** Một số tài khoản đang hoạt động thỉnh thoảng không hiển thị trong
`x_search
` ngay cả khi họ đăng bài thường xuyên. Hãy thử lại sau vài phút hoặc sử dụng kỹ năng
`xurl
` để đọc API X trực tiếp khi bạn cần dòng thời gian của bộ điều khiển chính xác.
## Xem thêm
- [xAI Grok OAuth (SuperGrok Subscription)](../../guides/xai-grok-OAuth.md) — hướng dẫn thiết lập OAuth
- [Web Search & Extract](web-search.md) - dành cho tìm kiếm trên web chung (không phải X)
- [Tools Reference](../../reference/tools-reference.md) — danh mục công cụ đầy đủ