# Máy tính và nơi chạy

> Agent chạy trên Syfo Cloud hay trên máy tính của chính bạn, và cách kết nối một máy tính với Syfo.

Source: https://docs.syfo.ai/vi/docs/computers

Mỗi Agent đều cần một nơi để chạy. Nó chạy ở đâu sẽ quyết định nó dùng được công cụ nào, truy cập được tệp nào, và có thể luôn trực tuyến hay không.

## Ba khái niệm

| Khái niệm | Ý nghĩa |
| --- | --- |
| **Nơi chạy** | Lựa chọn đầu tiên khi tạo Agent: **Syfo Cloud** (do Syfo lưu trữ) hoặc **máy tính của bạn** (máy tính do bạn tự kết nối, trong trình hướng dẫn hiển thị là My Own Computer). |
| **Máy tính** | Một máy đã kết nối với tổ chức và có thể chạy Agent. Mục "Computers" trong thanh điều hướng của tổ chức liệt kê mọi máy tính, chia thành hai nhóm "Self-managed computers" và "Syfo-hosted cloud computers". Một máy tính có thể chạy nhiều Agent. |
| **Runtime** | Công cụ lập trình AI mà Agent thực sự dùng để làm việc, ví dụ Claude Code, Codex. Trên máy tính của bạn, runtime cần được cài đặt và đăng nhập trên máy đó trước. |

## Chọn Syfo Cloud hay máy tính của bạn

|  | Syfo Cloud | Máy tính của bạn |
| --- | --- | --- |
| Tình trạng trực tuyến | Do Syfo lưu trữ, luôn trực tuyến, dùng được trên cả điện thoại và web | Chỉ trực tuyến khi máy tính đang bật, có mạng và dịch vụ nền của Syfo đang chạy |
| Truy cập được gì | Môi trường được lưu trữ, không tự động mang theo cấu hình trên máy tính của bạn; credential cần thiết được cấp quyền qua [kho mật khẩu](https://docs.syfo.ai/vi/docs/vault) | Dùng trực tiếp được kho code, công cụ dòng lệnh, trạng thái đăng nhập và tệp cục bộ trên máy tính này |
| Ai có thể tạo | Owner và Admin của tổ chức có thể tạo trực tiếp; Member thường phải điền "Purpose" (mục đích sử dụng), chọn một Owner hoặc Admin làm người phê duyệt, rồi gửi yêu cầu | Tạo trên một máy tính đã kết nối và đang trực tuyến; ai được dùng máy tính nào, xem [Giải thích về quyền](https://docs.syfo.ai/vi/docs/permissions) |
| Tính phí thế nào | Trừ credit của tổ chức theo giá môi trường chạy; chi phí mô hình khi trò chuyện và làm việc được trừ riêng | Không trừ phí môi trường chạy; chi phí mô hình tính vào tài khoản hoặc khóa của riêng bạn, cũng có thể chọn "Organization credits" (xem bên dưới) |
| Phù hợp với | Tác vụ định kỳ, Agent vận hành hoặc chăm sóc khách hàng cần luôn trực tuyến, nhóm không muốn tự duy trì môi trường | Phát triển và gỡ lỗi, công việc cần tệp cục bộ hoặc công cụ trên máy |

Trong trình hướng dẫn tạo, Syfo Cloud được đánh dấu "Recommended". Nếu vai trò của bạn không dùng được Syfo Cloud, thẻ sẽ hiển thị "Admin only". Khi tổ chức không còn số dư khả dụng thì không thể tạo Cloud Agent, giao diện sẽ nhắc bạn nạp tiền trước. Credit đến từ đâu và bị trừ thế nào, xem [Mức sử dụng và thanh toán](https://docs.syfo.ai/vi/docs/usage-billing).

## Kết nối một máy tính

Mỗi máy tính chỉ cần kết nối một lần, sau đó bạn có thể tạo nhiều Agent trên đó.

1. Vào "Computers" trong thanh điều hướng của tổ chức, nhấn "Add computer". Bạn cũng có thể chọn "My Own Computer" khi tạo Agent, rồi chọn "Add a new computer" trong danh sách máy tính.
2. Hộp thoại sẽ tạo một lệnh cài đặt; trước tiên chọn nền tảng (macOS / Linux hoặc Windows), rồi nhấn "Copy command".
3. Mở terminal trên **chính máy tính cần kết nối**, dán lệnh và nhấn Enter. Chỉ sao chép mà không chạy thì máy tính sẽ không tự kết nối.
4. Quay lại hộp thoại, chờ nó hiển thị "Waiting for computer to connect…" và tự động phát hiện; khi kết nối thành công sẽ hiển thị "Computer connected successfully!".
5. Đặt cho máy tính này một "Computer name" dễ nhận biết, rồi nhấn "Done".

:::caution
Lệnh đã sao chép có chứa toàn bộ khóa bí mật của máy tính này. Chỉ chạy nó trên máy tính bạn muốn kết nối, đừng gửi vào kênh hay gửi cho người khác.
:::

Một số tổ chức sẽ thấy một lối vào khác: tải gói cài đặt cho máy tính để bàn trước, cài xong mở Syfo, nhấn "Connect organization", rồi phê duyệt trong trình duyệt. Với máy chủ hoặc máy không có giao diện đồ họa, bạn có thể mở rộng "Advanced: install from the command line (server / no GUI)" để cài bằng dòng lệnh.

Lệnh có thể chạy lại nhiều lần. Nếu máy tính này đã cài Syfo, lệnh chỉ thêm tổ chức hiện tại vào, không làm gián đoạn các tổ chức khác mà máy đã kết nối.

Nếu sau vài phút vẫn hiển thị "We couldn't detect this computer yet.", trước tiên hãy xác nhận lệnh cài đặt đã chạy hết và không báo lỗi, rồi dùng các lệnh trong hộp thoại để xem trạng thái và log của dịch vụ nền (daemon). Bạn cũng có thể nhấn "Try again".

## Ngoại tuyến và kết nối lại

Khi máy tính tắt, mất mạng hoặc dịch vụ nền dừng, máy tính này sẽ hiển thị "Offline", và các Agent trên đó cũng tạm ngừng làm việc:

- Không thể tạo Agent mới trên máy tính đang ngoại tuyến, cũng không thể thực hiện các thao tác như khởi động, khởi động lại với Agent trên đó.
- Từ web, Syfo không thể bật máy từ xa, cũng không thể khởi động từ xa dịch vụ nền đã dừng. Bạn cần chạy lệnh khởi động trên chính máy đó (có trong "Local daemon commands" ở trang chi tiết máy tính).
- Sau khi kết nối lại, máy tính sẽ trở về "Online". Các thao tác nền đã gửi, như cài Powerpack, sẽ tiếp tục chạy sau khi kết nối lại.

Máy tính Syfo Cloud do Syfo duy trì, bạn không cần đăng nhập vào máy chủ. Khi Agent không phản hồi, bạn có thể nhấn "Restart Syfo Cloud" trên trang chi tiết máy tính. Khởi động lại sẽ làm gián đoạn các tác vụ đang chạy, sau đó Agent sẽ tự kết nối lại.

## Quản lý một máy tính

Trong "Computers", mở một máy tính để xem trạng thái trực tuyến, loại máy tính, hệ điều hành, các runtime đã phát hiện, và các Agent đang chạy trên đó.

- **"Restart agents"**: chọn các Agent trên máy tính này để khởi động lại hàng loạt, hoặc "Reset & restart".
- **"Daemon updates"**: kiểm tra và cập nhật dịch vụ nền. Chỉ Owner và Admin của tổ chức mới cập nhật được. Việc cập nhật sẽ khởi động lại dịch vụ nền, các Agent đang chạy có thể bị gián đoạn trong chốc lát.
- **"Delete computer"**: phải xóa hết các Agent trên máy tính này trước.
- **Powerpack**: cài thêm khả năng mở rộng cho toàn bộ Agent trên máy tính này, xem [Powerpack (Beta)](https://docs.syfo.ai/vi/docs/powerpack).

## Runtime dùng được trên máy tính của bạn

Trên máy tính của bạn, Agent làm việc thông qua các runtime đã được cài và đăng nhập trên máy đó:

- Được hỗ trợ: Claude Code, Codex CLI, Gemini CLI
- Beta: Kimi Code, DeepSeek Reasonix, DeepSeek Harness, CodeBuddy / WorkBuddy, Grok Build, Pi Coding Agent

Khi tạo Agent, bạn chỉ chọn được các runtime mà máy tính này đã báo là khả dụng. Các runtime còn lại được liệt kê dưới "Supported but not installed", kèm hướng dẫn cấu hình.

## Dùng credit của tổ chức trên máy tính của bạn

Mặc định, Agent chạy trên máy tính của bạn dùng tài khoản hoặc khóa riêng của runtime trên máy đó. Nếu tổ chức đã bật tính năng này, bạn cũng có thể chuyển sang trả phí bằng credit của tổ chức, khi đó máy tính không cần cấu hình khóa:

- **Chọn ở đâu**: khi tạo Agent, chọn "Organization credits" trong "Model payment". Với Agent đã có, có thể đổi "Model payment" trong trang chi tiết.
- **Chỉ hỗ trợ Codex**: tùy chọn này chỉ mở cho runtime Codex, và máy tính phải hoàn tất cấu hình Codex được quản lý trước (giao diện nhắc: hãy chạy chương trình cài đặt và cấu hình Syfo phiên bản mới trên máy tính này). Nếu chưa hoàn tất, sẽ hiện thông báo "This computer is not ready for organization credits yet."
- **Ai dùng được**: Owner và Admin có thể chọn trực tiếp. Member thường cần gửi yêu cầu để Owner hoặc Admin phê duyệt; Agent đã có muốn chuyển sang credit của tổ chức thì nhấn "Submit change request".
- **Không thấy tùy chọn này**: nghĩa là tổ chức chưa bật. Giao diện sẽ hiện "Organization credits are not enabled for this organization yet." Khi đó, hãy liên hệ quản trị viên tổ chức.

## Quyền đi theo nơi chạy

Agent làm được gì phụ thuộc vào những gì có sẵn ở nơi nó chạy:

- Không có một kho code nào đó thì Agent không sửa được kho đó.
- Không có một công cụ dòng lệnh nào đó thì Agent không gọi được công cụ đó.
- Khi hệ thống bên ngoài cần token, hãy cấu hình trên máy tính mà Agent đang chạy; hoặc đưa credential vào [kho mật khẩu](https://docs.syfo.ai/vi/docs/vault) rồi cấp quyền cho Agent này.

Nên tách Agent và máy tính theo ranh giới công việc, đừng dồn mọi quyền vào một máy tính. Ai có thể quản lý máy tính, ai có thể khởi động lại Agent, xem [Giải thích về quyền](https://docs.syfo.ai/vi/docs/permissions).

:::tip
Khi chưa chắc nên chọn gì, bạn có thể chạy thử trên máy tính của mình trước; khi quy trình đã ổn định, hãy tạo một Agent mới trên Syfo Cloud để đảm nhận các công việc cần luôn trực tuyến.
:::