---
title: AI Agent
description: ให้ลูกค้าจัดการ Linux VM ของตนเองโดยอธิบายงานด้วยภาษาธรรมชาติ — วิธีที่ Agent เชื่อมต่อผ่าน SSH สิ่งที่รันได้เอง และสิ่งที่คุณต้องเตรียมไว้
url: https://nexcmp.com/th/docs/ai/ai-agent/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI Agent {#ai-agent}

> **ตำแหน่งในแอดมิน:** System › Settings › AI provider (`/settings/ai`) — สวิตช์เปิดปิดโมดูลและผู้ให้บริการ; System › Admin › License & updates (`/license`) — สวิตช์เปิดปิดโมดูล **ตำแหน่งในพอร์ทัล:** AI Agent (`/ai/agent`) และหน้า `/chat/agent` หรือโหมด **Agent** ภายในแชท

## What it does {#what-it-does}

AI Agent จะเชื่อมต่อกับ Linux VM ของลูกค้าเองผ่าน SSH และดำเนินงานตามที่อธิบายด้วยภาษาธรรมชาติ เช่น "check system health", "install Docker", "find recent errors", "free up disk space" โดยจะแสดงทุกคำสั่งที่เสนอพร้อมผลลัพธ์ คำสั่งที่เป็นการอ่านอย่างเดียวสามารถรันได้โดยอัตโนมัติ แต่คำสั่งใดๆ ที่เปลี่ยนแปลงเซิร์ฟเวอร์จะต้องรอให้ลูกค้ากดปุ่ม **Run** ก่อน

## ข้อกำหนด {#requirements}

| Item | Requirement |
|---|---|
| โมดูล AI และผู้ให้บริการ | เปิดใช้งานโมดูล **AI** และมี [AI provider](https://nexcmp.com/th/docs/ai/ai-providers/) ที่ใช้งานได้ นอกจากนี้ Agent ยังต้องการโมเดลที่รองรับการเรียกใช้ Tool ด้วย |
| `openssh-client` บนเซิร์ฟเวอร์พาเนล | Agent รันคำสั่งด้วยโปรแกรม `ssh` (`/usr/bin/ssh`) ของพาเนลเอง ตัวติดตั้งจะติดตั้ง `openssh-client` ให้ ตรวจสอบได้ด้วย `ssh -V` หากไม่มี Agent จะรายงานว่า "ssh client is not installed on the panel server" |
| ไม่ต้องใช้เกตเวย์ SSH แยกต่างหาก | ในการติดตั้งค่าเริ่มต้น ระบบจะใช้ SSH ในตัวและ**ไม่**จำเป็นต้องใช้ `ssh-proxy` web terminal ยกเว้นเมื่อเปิดใช้งานฟีเจอร์ *web SSH* เสริม (`feature_ssh_web`) และติดตั้งบริการ `ssh-proxy` แล้ว Agent จึงจะผ่าน `ssh-proxy` แทน |
| Network | เซิร์ฟเวอร์พาเนลต้องสามารถเข้าถึง IP ของ VM บนพอร์ต SSH (ค่าเริ่มต้นคือ 22) ได้ ตรวจสอบไฟร์และเวิร์ลและกลุ่มความปลอดภัยระหว่างพาเนลกับเน็ตเวิร์กของแขก |
| VM | เป็นของลูกค้า, **กำลังทำงานอยู่**, ไม่ถูกล็อก, เป็น **Linux** (ปฏิเสธ VM ระบบ Windows) และมี IP address ที่เป็นสาธารณะหรือสามารถติดต่อได้ |
| ข้อมูลรับรอง SSH | ชื่อผู้ใช้และรหัสผ่านสำหรับเข้าสู่ระบบ VM ที่ NexCMP จัดเก็บไว้ (บันทึกตอนสร้าง VM หรือตอนรีเซ็ต(รหัสผ่าน โดยเข้ารหัสแล้ว) หรือคีย์ปฏิบัติการของพาเนลหากมีการติดตั้งไว้ หากไม่มีทั้งสองอย่าง Agent จะแจ้งว่าไม่สามารถเข้าสู่ระบบได้ |

## เตรียมโครงสร้างพื้นฐาน {#prepare-the-infrastructure}

1. ตรวจสอบ SSH client บนเซิร์ฟเวอร์พาเนล:

   ```bash
   ssh -V
   sudo apt-get install -y openssh-client   # only if missing
   ```

2. ตรวจสอบว่าเซิร์ฟเวอร์พาเนลสามารถเปิด SSH ไปยัง guest VM ได้:

   ```bash
   nc -vz 198.51.100.10 22
   ```

   แทนที่ที่อยู่ด้วย IP ของ VM ทดสอบ หากขั้นตอนนี้ล้มเหลว ให้แก้ไขการกำหนดเส้นทางหรือไฟร์วอลล์ก่อน
3. ตรวจสอบให้แน่ใจว่า guest อนุญาตให้เข้าสู่ระบบด้วยรหัสผ่านสำหรับผู้ใช้ที่ NexCMP จัดเก็บไว้ (ภาพอิมเมจระบบคลาวด์บางภาพปิดใช้งานไว้) หรือติดตั้งคีย์ปฏิบัติการของพาเนลบน guest แล้ว

## เชื่อมต่อใน NexCMP {#connect-in-nexcmp}

1. ตั้งค่า [AI provider](https://nexcmp.com/th/docs/ai/ai-providers/) ให้เสร็จสิ้น: เปิดใช้งานโมดูล บันทึกผู้ให้บริการแล้ว และสถานะ **Test connection** เป็นสีเขียว
2. ไม่ต้องกำหนดค่าอื่นใดฝั่งแอดมิน สวิตช์โมดูลจะทำให้รายการ **AI Agent** ปรากฏในพอร์ทัลลูกค้า
3. ในฐานะลูกค้า: เปิด **AI Agent** เลือกเซิร์ฟเวอร์ที่กำลังทำงานอยู่ และคลิก **Choose server** หน้าเว็บจะทดสอบ SSH ด้วยคำสั่งตายตัวที่ไม่เป็นอันตรายก่อน (ไม่มีการเรียก AI) และแสดงสถานะ *SSH connected* หรือสาเหตุที่ล้มเหลว
4. พิมพ์งานที่ต้องการหรือเลือกรายการด่วน (*Check system health*, *Install Docker*, *Install Nginx*, *Find recent errors*, *Security check*, *Free up disk space*)



## วิธีการรันคำสั่ง {#how-it-runs-commands}

- **แหล่งที่มา:** เซิร์ฟเวอร์พาเนลพร้อมระบบ `ssh` client รันทีละหนึ่งคำสั่งแบบ non-interactive ปลายทางจะเป็น IP ของ VM **จากฐานข้อมูล** เสมอ ไม่ใช่จากคำขอ โดยจะเข้าถึงได้เฉพาะ VM ที่กำลังทำงานอยู่และไม่ถูกล็อกซึ่งเป็นของผู้ใช้เท่านั้น
- **การยืนยันตัวตน:** รหัสผ่านที่จัดเก็บไว้จะถูกส่งผ่านตัวช่วย `SSH_ASKPASS` แบบครั้งเดียวในสภาพแวดล้อมกระบวนการ โดยจะไม่ถูกเขียนลงดิสก์หรือใส่ไว้ในบรรทัดคำสั่ง คีย์โฮสต์จะไม่ถูกพิน (VM จะถูกติดตั้งใหม่พร้อมคีย์ใหม่) ผลลัพธ์ต่อหนึ่งคำสั่งจำกัดไว้ที่ 200 KB และแต่ละคำสั่งจะมีเวลาจำกัด (60 วินาที)
- **ลูปของ Agent:** AI จะเสนอคำสั่งและอ่านผลลัพธ์ โดยหนึ่งเทิร์นจะสิ้นสุดหลังจากผ่านไปสูงสุด **10 ขั้นตอน**
- **โหมด:**

  | โหมด | พฤติกรรม |
  |---|---|
  | **Confirm** | ทุกคำสั่งจะต้องรอการกด **Run** |
  | **Auto** | เฉพาะคำสั่งที่ผ่านรายการอนุญาตแบบอ่านอย่างเดียวที่เข้มงวดเท่านั้นที่จะรันได้เอง (เช่น `df -h`, `ps`, `journalctl`) ส่วนคำสั่งอื่น ๆ และคำสั่งที่ตัววิเคราะห์ไม่สามารถระบุได้อย่างแน่ชัด (ตัวแปร, การแทนที่คำสั่ง, การเปลี่ยนเส้นทางไปยังไฟล์) จะต้องรอการกด **Run** |

- **ป้ายกำกับความเสี่ยง:** คำสั่งที่เขียนทับหรือลบไฟล์, เขียนลงดิสก์, เปลี่ยนแปลงบัญชีหรือ SSH keys, ส่งข้อมูลไปยังเซิร์ฟเวอร์ภายนอก, เปิดการเชื่อมต่อเครือข่ายดิบ, รันโค้ดที่ถูกแปลงให้อ่านยาก, ดาวน์โหลดและรันสคริปต์, ปิดหรือรีสตาร์ทเครื่อง หรือเข้าถึงเซิร์ฟเวอร์อื่น จะแสดงสถานะ **Needs confirmation** เสมอ แม้ว่าจะอยู่ในโหมด Auto ก็ตาม
- **ผลลัพธ์ที่ไม่น่าเชื่อถือ:** ผลลัพธ์ของคำสั่งจะแสดงให้โมเดลเห็นว่าเป็นข้อมูลที่ไม่น่าเชื่อถือ และคำสั่งภายในนั้นจะไม่ถูกทำตาม

## ตรวจสอบ {#verify}

1. เลือก VM ทดสอบที่กำลังทำงานอยู่ หน้าเว็บจะแสดงสถานะ *SSH connected*
2. พิมพ์ว่า "Check CPU, RAM and disk" ในโหมด Auto คำสั่งแบบอ่านอย่างเดียวจะทำงานและคำตอบจะสรุปผลให้
3. พิมพ์ว่า "Install Nginx" คำสั่งติดตั้งจะปรากฏขึ้นพร้อมกับปุ่ม **Run** และ **Skip** จะไม่มีการรันใด ๆ จนกว่าคุณจะกด **Run**
4. ตัวนับที่ด้านบนจะแสดงจำนวนการเรียกใช้งาน AI ที่ใช้ไปในวันนี้ (เช่น `3/300`)

## ขีดจำกัดและหมายเหตุ {#limits-notes}

- **ขีดจำกัดรายวัน:** 300 การเรียกใช้งาน AI ต่อลูกค้าหนึ่งรายต่อวัน (UTC) โดยจะรีเซ็ตในเวลา 00:00 UTC เมื่อใช้ครบโควตา Agent จะตอบว่า "Daily AI quota reached"
- **การทำงานพร้อมกัน:** สูงสุด 2 การรัน Agent ต่อลูกค้าหนึ่งรายในเวลาเดียวกัน โดยหนึ่งเซสชันจะรันทีละหนึ่งเทิร์น
- **เซสชัน:** สูงสุด 100 ข้อความต่อหนึ่งเซสชัน และ 4,000อักขระต่อข้อความ เซสชันหนึ่งจะเป็นของ VM หนึ่งเครื่อง หาก VM ถูกลบหรือโอนย้าย เซสชันเก่าจะกลายเป็นแบบอ่านอย่างเดียว
- **VM ที่ถูกล็อก, หยุดทำงาน หรือ Windows:** VM จะแสดงเป็น *Locked*, *Stopped*, *Windows* หรือ *No address* และจะไม่สามารถเลือกได้
- **การสวมสิทธิ์:** ผู้ดูแลระบบที่สวมสิทธิ์เป็นลูกค้าจะไม่สามารถใช้ฟีเจอร์ข้อมูลประจำตัวของ Agent ได้ (ดูที่ [Log in as a customer](https://nexcmp.com/th/docs/customers/login-as/))
- **ความรับผิดชอบ:** Agent อาจเกิดข้อผิดพลาดได้ พอร์ทัลจะแจ้งให้ลูกค้าตรวจสอบคำสั่งก่อนรัน โปรดระบุไว้ในข้อกำหนดการใช้งานของคุณว่าลูกค้าต้องรับผิดชอบต่อคำสั่งที่ตนเองอนุมัติ
- การปิดโมดูล AI จะลบรายการ Agent ออกและเส้นทางจะตอบกลับเป็น 404 `module_disabled`.

## การแก้ Problme {#troubleshooting}

| อาการ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| "ไม่ได้ติดตั้ง ssh client บนเซิร์ฟเวอร์พาเนล (apt install openssh-client)" | ไม่มีไบนารี `ssh` | `sudo apt-get install -y openssh-client`. |
| "Agent ไม่สามารถเข้าสู่ระบบได้" / `ssh: no saved credentials for this VM` | ไม่มีรหัสผ่านที่จัดเก็บไว้และไม่มีคีย์การดำเนินงาน | รีเซ็ตรหัสผ่าน VM ในพอร์ทัลเพื่อให้บันทึกใหม่อีกครั้ง หรือติดตั้งคีย์การดำเนินงาน |
| "เซิร์ฟเวอร์ไม่ตอบสนองภายในเวลาที่กำหนด" | ไฟร์วอลล์, SSH ไม่ได้เปิดฟังคำขอ (not listening), VM กำลังยุ่ง | ทดสอบ `nc -vz <ip> 22` จากเซิร์ฟเวอร์พาเนล และเริ่ม `sshd` ใน VM |
| "ไม่สามารถเชื่อมต่อ SSH บนเซิร์ฟเวอร์นี้ได้" | การกำหนดเส้นทางหรือ Security Group | อนุญาตให้เซิร์ฟเวอร์ของระบบจัดการสามารถเชื่อมต่อกับ VM ผ่านพอร์ต 22 ได้ |
| "VM ไม่ได้ทำงานอยู่" / "ไม่อนุญาต" | VM ถูกหยุดการทำงาน ล็อก ถูกลบ หรือไม่ใช่ของลูกค้า | เริ่มการทำงานของ VM ปลดล็อก หรือเลือก VM อื่น |
| "ไม่พร้อมใช้งาน: N (หยุดทำงาน, ล็อกอยู่ หรือ Windows)" | สาเหตุตามที่ระบุไว้ด้านบน | VM จะต้องใช้ระบบปฏิบัติการ Linux และกำลังทำงานอยู่ |
| "เกตเวย์ SSH ไม่พร้อมใช้งานชั่วคราว" | เปิดใช้งานฟีเจอร์ Web SSH อยู่ แต่ `ssh-proxy` ไม่ทำงาน | เริ่มการทำงานของ `ssh-proxy` หรือปิดใช้งานฟีเจอร์ Web SSH เพื่อใช้ SSH ในตัว |
| "AI ตอบสนองช้าเกินไป (เกิน 90 วินาที)" | ผู้ให้บริการทำงานช้า | ใช้โมเดลที่เร็วขึ้นหรือลด **Reasoning effort** ลง |
| "โควตา AI ประจำวันหมดแล้ว" | ใช้งานครบ 300 ครั้งแล้ว | รอจนกว่าจะถึงเวลา 00:00 UTC |
| "เซสชันนี้ยังคงทำงานอยู่" | กำลังดำเนินการอีกรอบการสนทนาอยู่ | รอหรือกด **Stop** |