> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/vi/quan-tri-he-thong/node-diagnostics.md).

# Hướng dẫn chẩn đoán Node

Tài liệu tham khảo toàn diện cho các công cụ chẩn đoán node VergeOS, bao gồm lệnh IPMI, kiểm tra SMART, chẩn đoán mạng, cấu hình fabric và khắc phục sự cố phần cứng.

## Tổng quan

Công cụ Chẩn đoán nút cung cấp khả năng khắc phục sự cố toàn diện ở cấp phần cứng và hệ thống cho từng nút VergeOS. Các lệnh chẩn đoán này cho phép quản trị viên hệ thống phân tích phần cứng chi tiết, giám sát hiệu năng hệ thống và khắc phục sự cố riêng của từng nút trực tiếp từ giao diện VergeOS.

{% hint style="info" %}
**Nội dung bạn sẽ tìm hiểu**

* Cách truy cập và sử dụng các công cụ chẩn đoán nút
* Tìm hiểu từng lệnh chẩn đoán và thành phần phần cứng mà lệnh đó tập trung kiểm tra
* Các phương pháp hay nhất để khắc phục sự cố ở cấp nút
* Khi nào nên sử dụng từng lệnh chẩn đoán cho các sự cố phần cứng
  {% endhint %}

## Điều kiện tiên quyết

* Có quyền truy cập giao diện VergeOS với đặc quyền quản lý nút
* Có hiểu biết cơ bản về các thành phần phần cứng máy chủ
* Có kiến thức về các khái niệm mạng và lưu trữ

{% hint style="info" %}
**Quyền truy cập nút**

Các công cụ chẩn đoán nút cung cấp quyền truy cập chuyên sâu ở cấp phần cứng và chỉ nên được sử dụng bởi các quản trị viên hệ thống có kinh nghiệm.
{% endhint %}

## Truy cập công cụ chẩn đoán nút

1. **Đi đến công cụ chẩn đoán nút:**
   * Chọn **Cơ sở hạ tầng** > **Nút** từ menu trên cùng.
   * Chọn **nút mong muốn** từ danh sách
   * Nhấp vào **Chẩn đoán** trong menu bên trái
2. **Sử dụng các lệnh chẩn đoán:**
   * Chọn lệnh mong muốn từ mục **Truy vấn** trong menu thả xuống
   * Cấu hình các tham số có sẵn ở phía bên phải
   * Nhấp vào **Gửi →** để thực thi lệnh

{% hint style="success" %}
**Hiển thị lệnh**

Bật **"Hiển thị lệnh"** để xem chính xác lệnh đang được thực thi, hữu ích khi thực thi qua SSH hoặc tự động hóa bằng tập lệnh.
{% endhint %}

## Tài liệu tham khảo về các lệnh chẩn đoán

### Quét ARP

**Mục đích:** Phát hiện các thiết bị đang hoạt động trên các giao diện mạng của nút bằng gói ARP.

**Khi nào nên sử dụng:**

* Xác minh kết nối mạng từ góc nhìn của nút
* Xác định các thiết bị trên các phân đoạn mạng cục bộ của nút
* Khắc phục sự cố cấu hình mạng của nút

**Tham số:**

* **Giao diện:** Giao diện mạng dùng để quét

**Cú pháp CLI:**

```bash
nmap -sn [NETWORK_RANGE]
```

***

### Bảng ARP

**Mục đích:** Hiển thị bộ nhớ đệm ARP của nút, gồm các ánh xạ địa chỉ IP sang địa chỉ MAC.

**Khi nào nên sử dụng:**

* Khắc phục sự cố kết nối mạng của nút
* Xác minh việc phát hiện các thiết bị lân cận trên mạng
* Kiểm tra xung đột ARP ảnh hưởng đến nút

**Cú pháp CLI:**

```bash
arp -a
```

***

### Địa chỉ cầu nối

**Mục đích:** Hiển thị bảng địa chỉ MAC của các cầu nối mạng trên nút.

**Khi nào nên sử dụng:**

* Khắc phục sự cố cấu hình cầu nối mạng
* Xác minh khả năng học địa chỉ MAC trên các bộ chuyển mạch ảo
* Phân tích cấu trúc liên kết mạng

**Cú pháp CLI:**

```bash
brctl showmacs [BRIDGE_NAME]
```

***

### Xóa bộ nhớ lưu trữ liên tục

**Mục đích:** Xóa bộ nhớ đệm lưu trữ liên tục và dữ liệu tạm thời trên nút.

**Khi nào nên sử dụng:**

* Khắc phục các vấn đề về hiệu suất liên quan đến lưu trữ
* Xóa dữ liệu bộ nhớ đệm bị hỏng
* Chuẩn bị cấu hình lại bộ nhớ lưu trữ

{% hint style="danger" %}
**Cảnh báo về ảnh hưởng đến dữ liệu**

Lệnh này có thể ảnh hưởng đến hiệu suất hệ thống và chỉ nên được sử dụng theo hướng dẫn của bộ phận hỗ trợ.
{% endhint %}

**Cú pháp CLI:**

```bash
sync && echo 3 > /proc/sys/vm/drop_caches
```

***

### Bảng DMI

**Mục đích:** Hiển thị thông tin Giao diện Quản lý Máy tính để bàn (DMI), bao gồm chi tiết phần cứng.

**Khi nào nên sử dụng:**

* Kiểm kê và nhận dạng phần cứng
* Xác minh thông số kỹ thuật hệ thống
* Khắc phục sự cố tương thích phần cứng

**Cú pháp CLI:**

```bash
dmidecode
```

***

### Tra cứu DNS

**Mục đích:** Kiểm tra khả năng phân giải DNS từ góc độ của nút.

**Khi nào nên sử dụng:**

* Khắc phục sự cố cấu hình DNS của nút
* Xác minh kết nối ra bên ngoài từ nút
* Kiểm tra dịch vụ phân giải tên

**Tham số:**

* **Tên máy chủ:** Tên máy chủ đích cần phân giải
* **Máy chủ DNS:** Máy chủ DNS cụ thể cần truy vấn

**Cú pháp CLI:**

```bash
nslookup [HOSTNAME]
dig [HOSTNAME]
```

***

### Công cụ Ethernet

**Mục đích:** Cung cấp thông tin và cấu hình chi tiết về giao diện Ethernet.

**Khi nào nên sử dụng:**

* Chẩn đoán sự cố giao diện mạng
* Kiểm tra tốc độ liên kết và chế độ song công
* Khắc phục sự cố kết nối mạng vật lý

**Tham số:**

* **Giao diện:** Giao diện mạng cần kiểm tra

**Cú pháp CLI:**

```bash
ethtool [INTERFACE]
```

***

### Cấu hình fabric

**Mục đích:** Hiển thị cấu hình mạng fabric VergeOS của nút.

**Khi nào nên sử dụng:**

* Khắc phục sự cố giao tiếp giữa các nút
* Xác minh thiết lập mạng fabric
* Chẩn đoán sự cố kết nối cụm

**Cú pháp CLI:**

```bash
verge fabric show
```

***

### IP

**Mục đích:** Truy cập các lệnh IP nâng cao để chẩn đoán giao diện và định tuyến.

**Khi nào nên sử dụng:**

* Phân tích chi tiết giao diện mạng
* Kiểm tra bảng định tuyến
* Khắc phục sự cố mạng nâng cao

**Tham số:**

* **Lệnh:** Các tùy chọn lệnh IP (route, addr, link, v.v.)

**Cú pháp CLI:**

```bash
ip [COMMAND] [OPTIONS]
```

***

### Thông tin IPMI BMC

**Mục đích:** Hiển thị thông tin về Bộ điều khiển quản lý bo mạch chủ.

**Khi nào nên sử dụng:**

* Khắc phục sự cố quản lý phần cứng
* Xác minh cấu hình IPMI
* Chẩn đoán quản lý từ xa

**Cú pháp CLI:**

```bash
ipmitool bmc info
```

***

### Trạng thái khung máy IPMI

**Mục đích:** Hiển thị trạng thái khung máy vật lý và thông tin nguồn.

**Khi nào nên sử dụng:**

* Khắc phục sự cố quản lý nguồn
* Xác minh trạng thái phần cứng
* Chẩn đoán hệ thống vật lý

**Cú pháp CLI:**

```bash
ipmitool chassis status
```

***

### Thông tin FRU IPMI

**Mục đích:** Hiển thị thông tin về các bộ phận có thể thay thế tại hiện trường từ IPMI.

**Khi nào nên sử dụng:**

* Quản lý danh mục phần cứng
* Nhận dạng linh kiện
* Thông tin bảo hành và hỗ trợ

**Cú pháp CLI:**

```bash
ipmitool fru print
```

***

### Thông tin LAN IPMI

**Mục đích:** Hiển thị thông tin chi tiết về cấu hình mạng IPMI.

**Khi nào nên sử dụng:**

* Khắc phục sự cố mạng IPMI
* Sự cố kết nối quản lý từ xa
* Xác minh cấu hình mạng BMC

**Cú pháp CLI:**

```bash
ipmitool lan print
```

***

### Đặt lại IPMI MC

**Mục đích:** Đặt lại Bộ điều khiển quản lý (BMC).

**Khi nào nên sử dụng:**

* Khắc phục sự cố giao tiếp IPMI
* Khắc phục sự cố BMC
* Khôi phục giao diện quản lý

{% hint style="warning" %}
**Ảnh hưởng đến hoạt động quản lý**

Thao tác này sẽ tạm thời làm gián đoạn chức năng IPMI/BMC trong quá trình đặt lại.
{% endhint %}

**Cú pháp CLI:**

```bash
ipmitool mc reset cold
```

***

### Kho lưu trữ dữ liệu cảm biến IPMI

**Mục đích:** Hiển thị thông tin toàn diện về kho lưu trữ dữ liệu cảm biến.

**Khi nào nên sử dụng:**

* Giám sát phần cứng chi tiết
* Xác minh cấu hình cảm biến
* Chẩn đoán và phân tích phần cứng

**Cú pháp CLI:**

```bash
ipmitool sdr list
```

***

### Cảm biến IPMI

**Mục đích:** Hiển thị số liệu hiện tại của cảm biến (nhiệt độ, điện áp, quạt, v.v.).

**Khi nào nên sử dụng:**

* Giám sát tình trạng phần cứng
* Chẩn đoán nhiệt độ và nguồn điện
* Khắc phục sự cố môi trường

**Cú pháp CLI:**

```bash
ipmitool sensor list
```

***

### Nhật ký sự kiện hệ thống IPMI

**Mục đích:** Hiển thị nhật ký sự kiện hệ thống từ IPMI.

**Khi nào nên sử dụng:**

* Phân tích lỗi phần cứng
* Khắc phục sự cố sự kiện hệ thống
* Điều tra các sự cố phần cứng trong quá khứ

**Cú pháp CLI:**

```bash
ipmitool sel list
```

***

### Điều khiển đèn LED (ổ đĩa)

**Mục đích:** Điều khiển đèn LED trên các ổ lưu trữ để nhận diện ổ đĩa về mặt vật lý.

**Khi nào nên sử dụng:**

* Nhận diện ổ đĩa vật lý
* Quy trình thay thế ổ đĩa
* Các tác vụ bảo trì phần cứng

**Tham số:**

* **Ổ đĩa:** Mã định danh ổ đĩa mục tiêu
* **Thao tác:** Bật/tắt/nhấp nháy đèn LED

**Cú pháp CLI:**

```bash
ledctl locate=[DRIVE_PATH]
```

***

### Nhật ký

**Mục đích:** Hiển thị nhật ký hệ thống và các mục nhật ký của nút.

**Khi nào nên sử dụng:**

* Khắc phục sự cố hệ thống
* Phân tích lỗi
* Điều tra sự cố về hiệu năng

**Cú pháp CLI:**

```bash
journalctl -n 100
dmesg
```

***

### Liên kết mạng

**Mục đích:** Hiển thị cấu hình và trạng thái liên kết mạng.

**Khi nào nên sử dụng:**

* Khắc phục sự cố dự phòng mạng
* Chẩn đoán giao diện liên kết
* Xác minh tổng hợp liên kết

**Cú pháp CLI:**

```bash
cat /proc/net/bonding/[BOND_NAME]
```

***

### Tốc độ OpenSSL

**Mục đích:** Kiểm tra hiệu năng mã hóa của CPU trên nút.

**Khi nào nên sử dụng:**

* Đánh giá hiệu năng
* Kiểm tra khả năng mã hóa
* Xác minh khả năng tăng tốc phần cứng

**Cú pháp CLI:**

```bash
openssl speed
```

***

### Ping

**Mục đích:** Kiểm tra kết nối mạng từ nút.

**Khi nào nên sử dụng:**

* Kiểm tra kết nối cơ bản
* Xác minh đường truyền mạng
* Đo độ trễ

**Tham số:**

* **Đích:** Địa chỉ IP hoặc tên máy chủ đích
* **Số lượng:** Số gói ping

**Cú pháp CLI:**

```bash
ping -c [COUNT] [DESTINATION]
```

***

### Truy vấn RAS

**Mục đích:** Truy vấn thông tin về độ tin cậy, tính sẵn sàng và khả năng bảo trì.

**Khi nào nên sử dụng:**

* Đánh giá độ tin cậy của phần cứng
* Trạng thái sửa lỗi
* Chẩn đoán bộ nhớ và bộ xử lý

**Cú pháp CLI:**

```bash
ras-mc-ctl --summary
```

***

### Kiểm tra chẩn đoán S.M.A.R.T.

**Mục đích:** Khởi chạy các bài kiểm tra chẩn đoán SMART trên ổ lưu trữ.

**Khi nào nên sử dụng:**

* Kiểm tra tình trạng ổ đĩa chủ động
* Khắc phục sự cố lưu trữ
* Bảo trì phòng ngừa

**Tham số:**

* **Ổ đĩa:** Ổ đĩa mục tiêu cần kiểm tra
* **Loại kiểm tra:** Kiểm tra ngắn, dài hoặc truyền tải

**Cú pháp CLI:**

```bash
smartctl -t [TEST_TYPE] [DRIVE_PATH]
```

{% hint style="info" %}
**Thời lượng kiểm tra**

Các bài kiểm tra SMART có thể mất nhiều thời gian để hoàn tất, đặc biệt là bài kiểm tra dài.
{% endhint %}

***

### Thông tin S.M.A.R.T.

**Mục đích:** Hiển thị các thuộc tính SMART và thông tin tình trạng của ổ đĩa.

**Khi nào nên sử dụng:**

* Đánh giá tình trạng ổ đĩa
* Phân tích dự đoán lỗi
* Giám sát hiệu năng lưu trữ

**Tham số:**

* **Ổ đĩa:** Mã định danh ổ đĩa mục tiêu

**Cú pháp CLI:**

```bash
smartctl -a [DRIVE_PATH]
```

***

### Hiển thị thiết bị khối

**Mục đích:** Liệt kê tất cả thiết bị khối mà nút có thể nhận diện.

**Khi nào nên sử dụng:**

* Danh mục thiết bị lưu trữ
* Khắc phục sự cố nhận diện ổ đĩa
* Xác minh cấu hình lưu trữ

**Cú pháp CLI:**

```bash
lsblk
fdisk -l
```

***

### Kiểm tra kết nối TCP

**Mục đích:** Kiểm tra khả năng kết nối TCP đến các máy chủ và cổng từ xa.

**Khi nào nên sử dụng:**

* Xác minh kết nối dịch vụ
* Kiểm tra quy tắc tường lửa
* Khắc phục sự cố mạng

**Tham số:**

* **Máy chủ:** Tên máy chủ hoặc địa chỉ IP đích
* **Cổng:** Số cổng TCP

**Cú pháp CLI:**

```bash
telnet [HOST] [PORT]
nc -zv [HOST] [PORT]
```

***

### TCP Dump

**Mục đích:** Thu thập các gói mạng để phân tích lưu lượng chi tiết.

**Khi nào nên sử dụng:**

* Khắc phục sự cố mạng
* Phân tích bảo mật
* Gỡ lỗi giao thức

**Tham số:**

* **Số lượng gói:** Số gói cần thu thập (từ 100 đến 1000, mặc định là 100)
* **Thời gian chờ tính bằng giây:** Thời lượng thu thập (từ 1 đến 30, mặc định là 15)
* **Loại giao diện:** ***Vật lý***, ***VXLAN***, ***Cầu nối***, hoặc ***thiết bị TAP***
* **Tên:** Giao diện dùng để thu thập, được lọc theo **Loại giao diện**.
* **Mức độ chi tiết của đầu ra:** ***Không***, ***Thấp***, ***Trung bình***, hoặc ***Cao***
* **Hiển thị tiêu đề ở lớp liên kết (VLAN, MAC):** Thêm `-e` vào lệnh để mỗi gói hiển thị địa chỉ MAC và thẻ VLAN 802.1Q
* **Biểu thức:** Biểu thức lọc gói (ví dụ: `vlan 210` hoặc `not vlan 1`), được thêm vào lệnh đúng như đã nhập

{% hint style="info" %}
**Danh sách tên giao diện**

Danh sách **Vật lý** hiển thị các NIC vật lý của nút. **Cầu nối** và **thiết bị TAP** chỉ liệt kê các cầu nối và thiết bị TAP của những mạng và máy ảo đang chạy trên nút đã chọn, vì vậy hãy chạy lệnh ghi lại trên nút nơi mạng hoặc máy ảo đang chạy.
{% endhint %}

{% hint style="info" %}
**Xem thẻ VLAN**

Theo mặc định, bản ghi không hiển thị các tiêu đề ở cấp liên kết, vì vậy các khung có gắn thẻ VLAN sẽ xuất hiện như lưu lượng IP thông thường, không có VLAN ID. Chọn **Hiển thị tiêu đề cấp liên kết (VLAN, MAC)** để xem các thẻ, ví dụ: `ethertype 802.1Q (0x8100) ... vlan 210, p 0`.
{% endhint %}

**Cú pháp CLI:**

Bật **Hiển thị lệnh** để xem chính xác lệnh được sử dụng. Lệnh mặc định là:

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100
```

Khi **Hiển thị tiêu đề cấp liên kết (VLAN, MAC)** được chọn và có nhập **Biểu thức** :

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100 -e [EXPRESSION]
```

{% hint style="warning" %}
**Ảnh hưởng đến hiệu năng**

Việc ghi lại gói tin có thể ảnh hưởng đến hiệu năng của nút. Hãy thận trọng khi sử dụng trong môi trường sản xuất.
{% endhint %}

***

### Mức sử dụng CPU cao nhất

**Mục đích:** Hiển thị các tiến trình tiêu thụ nhiều tài nguyên CPU nhất.

**Khi nào nên sử dụng:**

* Khắc phục sự cố về hiệu năng
* Phân tích mức sử dụng tài nguyên
* Giám sát tiến trình

**Cú pháp CLI:**

```bash
top -o %CPU
```

***

### Mức sử dụng mạng cao nhất

**Mục đích:** Hiển thị các tiến trình có mức sử dụng mạng cao nhất.

**Khi nào nên sử dụng:**

* Phân tích hiệu năng mạng
* Khắc phục sự cố về mức sử dụng băng thông
* Xác định tiến trình sử dụng nhiều mạng

**Cú pháp CLI:**

```bash
iftop
nethogs
```

***

### Truy vết tuyến đường

**Mục đích:** Truy vết đường đi của mạng từ nút đến đích.

**Khi nào nên sử dụng:**

* Khắc phục sự cố định tuyến mạng
* Phân tích đường đi
* Chẩn đoán sự cố kết nối

**Tham số:**

* **Đích:** Địa chỉ IP hoặc tên máy chủ đích

**Cú pháp CLI:**

```bash
traceroute [DESTINATION]
mtr [DESTINATION]
```

***

### Địa chỉ IP của tôi là gì?

**Mục đích:** Hiển thị địa chỉ IP bên ngoài của nút.

**Khi nào nên sử dụng:**

* Xác minh kết nối bên ngoài
* Khắc phục sự cố cấu hình NAT
* Xác thực cấu hình mạng

**Cú pháp CLI:**

```bash
curl ifconfig.me
```

## Các phương pháp tốt nhất

### Quy trình chẩn đoán phần cứng

1. **Tổng quan hệ thống:** Bắt đầu với Bảng DMI và trạng thái khung máy IPMI
2. **Kiểm tra tình trạng:** Xem lại cảm biến IPMI và nhật ký sự kiện hệ thống
3. **Phân tích lưu trữ:** Sử dụng thông tin và các bài kiểm tra S.M.A.R.T.
4. **Xác minh mạng:** Kiểm tra liên kết mạng và trạng thái giao diện
5. **Đánh giá hiệu năng:** Theo dõi mức sử dụng CPU và mạng

### Bảo trì phòng ngừa

* **Kiểm tra tình trạng định kỳ:** Theo dõi cảm biến IPMI và dữ liệu SMART
* **Xem lại nhật ký:** Thường xuyên kiểm tra nhật ký sự kiện hệ thống
* **Theo dõi hiệu năng:** Theo dõi xu hướng sử dụng CPU và mạng
* **Tình trạng ổ đĩa:** Lên lịch chạy các bài kiểm tra chẩn đoán SMART định kỳ

### Các lưu ý về an toàn

* **Đánh giá tác động:** Cân nhắc ảnh hưởng của các lệnh chẩn đoán đến hệ thống đang vận hành
* **Phối hợp hỗ trợ:** Liên hệ bộ phận hỗ trợ VergeOS để xử lý các sự cố phần cứng phức tạp
* **Tài liệu:** Lưu hồ sơ kết quả chẩn đoán để phân tích xu hướng
* **Kiểm soát thay đổi:** Tuân thủ quy trình quản lý thay đổi khi sửa đổi phần cứng

## Khắc phục sự cố thường gặp trên nút

### Sự cố phần cứng

1. Kiểm tra **cảm biến IPMI** để phát hiện các vấn đề về nhiệt độ, điện áp và quạt
2. Xem lại **nhật ký sự kiện hệ thống IPMI** để phát hiện lỗi phần cứng
3. Sử dụng **thông tin S.M.A.R.T.** để đánh giá tình trạng ổ đĩa

### Sự cố mạng

1. Xác minh **liên kết mạng** trạng thái và cấu hình
2. Sử dụng **Công cụ Ethernet** để kiểm tra cài đặt giao diện
3. Kiểm tra kết nối bằng **Ping** và **Định tuyến theo dấu vết**

### Sự cố hiệu năng

1. Theo dõi **Mức sử dụng CPU cao nhất** để phát hiện tình trạng thiếu tài nguyên
2. Kiểm tra **Mức sử dụng mạng cao nhất** để đánh giá mức sử dụng băng thông
3. Xem lại **Nhật ký** để tìm lỗi liên quan đến hiệu năng

### Sự cố lưu trữ

1. Sử dụng **Hiển thị thiết bị khối** để xác minh ổ đĩa được nhận diện
2. Chạy **Kiểm tra chẩn đoán S.M.A.R.T.** để kiểm tra ổ đĩa toàn diện
3. Kiểm tra **Truy vấn RAS** để xem thông tin về lỗi bộ nhớ và lưu trữ

## Các bước tiếp theo

Sau khi nắm vững cách chẩn đoán nút, hãy cân nhắc tìm hiểu thêm về:

* Giám sát và cảnh báo phần cứng nâng cao
* Tạo tập lệnh chẩn đoán tự động
* Tích hợp với các hệ thống giám sát bên ngoài
* Lên lịch bảo trì phòng ngừa

Đối với các sự cố phần cứng phức tạp hoặc kết quả chẩn đoán bất thường, hãy liên hệ với [Bộ phận hỗ trợ VergeOS](https://docs.verge.io/overview/vi/support-and-services.md) và cung cấp kết quả chẩn đoán chi tiết cùng thông tin hệ thống.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/vi/quan-tri-he-thong/node-diagnostics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
