---
title: "Kết nối trợ lý AI bên ngoài"
locale: vi
url: https://tlg.builera.app/docs/integrations/ai-connections
verified: 2026-10-24
app_version: "2.0"
---

# Kết nối trợ lý AI bên ngoài

Cấp quyền có giới hạn cho trợ lý bên ngoài qua MCP hoặc REST v2 và theo dõi các lệnh của kết nối.


Bạn nối trợ lý AI bên ngoài với Telegram-Auto và giới hạn những gì trợ lý được làm. Telegram-Auto không có AI nội bộ; mọi lệnh của trợ lý đi qua cùng cổng an toàn như thao tác trên web.

## Ai làm được

Chủ hoặc Quản lý tạo và quản lý kết nối. Quyền thật của kết nối là giao của vai trò, nhóm việc và tài khoản được cấp; kết nối không mạnh hơn người tạo.

## Cần chuẩn bị

- Một trợ lý hỗ trợ MCP, hoặc chương trình gọi REST.
- Danh sách tài khoản và công việc trợ lý được phép xử lý.
- Nơi giữ bí mật nếu bạn dùng khoá API.

Nên tách kết nối đọc báo cáo khỏi kết nối có quyền gửi tin.

## Bắt đầu ở đâu

Mở **Cài đặt → Kết nối AI**.

![Màn hình quản lý kết nối trợ lý bên ngoài](https://tlg.builera.app/docs-media/vi/settings-ai.webp "Kết nối AI")

## Các bước

1. Chọn **Tạo kết nối**.
2. Nhập **Tên** để nhận biết trợ lý.
3. Chọn **Cách nối** phù hợp với chương trình của bạn.
4. Chọn **Vai trò** không cao hơn quyền của bạn.
5. Chọn **Bộ tool MCP** phù hợp.
6. Chọn **Nhóm việc được làm** theo nguyên tắc đủ dùng.
7. Chọn **Tài khoản Telegram** mà trợ lý được truy cập.
8. Đặt **Ngôn ngữ cho AI**. Tuỳ chọn này đổi ngôn ngữ mô tả, lỗi và lý do; không đổi mã thao tác, mã sự kiện hay dữ liệu.
9. Kiểm tra **Việc nguy hiểm**. Nên giữ chính sách **Hỏi lại**.
10. Chọn **Tạo**.

![Biểu mẫu chọn quyền và tài khoản cho kết nối AI](https://tlg.builera.app/docs-media/vi/ai-connection-create.webp "Phạm vi kết nối")

Nếu dùng khoá API, chép khoá `tga_…` ngay khi xuất hiện. Khoá chỉ hiện một lần. Không dán khoá vào hội thoại, ảnh hoặc nhật ký.

### Nối bằng OAuth

Trong trình khách MCP, thêm địa chỉ:

```text
https://tlg.builera.app/mcp
```

Đăng nhập Telegram-Auto, xem màn hình đồng ý và chọn kết nối phù hợp. Không đồng ý nếu workspace hoặc phạm vi quyền không đúng.

### Nối bằng khoá API

REST v2 dùng địa chỉ gốc:

```text
https://tlg.builera.app/api/public/v2
```

MCP bằng khoá dùng:

```text
https://tlg.builera.app/api/public/mcp
```

Cả hai dùng header:

```text
Authorization: Bearer $TELEGRAM_AUTO_API_KEY
```

### Hiểu bộ công cụ

Các profile là `realtime`, `setup`, `prospecting`, `reports`, `admin`, `full`. Mỗi profile công bố tối đa **35 công cụ**, gồm công cụ hỗ trợ và khám phá.

Không thấy công cụ có tên riêng không có nghĩa là thao tác bị cấm. Trợ lý dùng `tools_search`, đọc hợp đồng bằng `tools_describe`, rồi gọi `tools_run`. Các kiểm tra quyền vẫn giữ nguyên.

## Kết quả

Kết nối có danh tính riêng, phạm vi tài khoản riêng và lịch sử lệnh riêng. Khi xử lý khách, trợ lý cần giữ hội thoại bằng `conversations.claim`, không giành khoá của người khác và nhả khoá khi xong.

## Kiểm tra

Mở **Thao tác gần đây** để xem lệnh, trạng thái và lỗi. Cho trợ lý gọi `whoami` trước khi làm việc.

Dùng **Sửa** khi cần thu hẹp quyền. **Dừng ngay** từ chối lệnh mới, huỷ việc đang chờ hoặc đang giữ của kết nối và giải phóng hội thoại. Tin đã gửi không được thu hồi.

> [!WARNING]
> Xoá kết nối làm trợ lý mất quyền ngay và huỷ việc đang chờ. Tin đã gửi không được thu hồi.

Chỉ chọn **Xoá** sau khi kiểm tra đúng kết nối.

## Khi có lỗi

Kiểm tra trạng thái kết nối, vai trò, scope, tài khoản và hạn dùng. Với `confirmation_required`, trợ lý phải hỏi người; không được tự quyết định xác nhận.

## Làm bằng API hoặc MCP

- [Xem kết nối](https://tlg.builera.app/docs/reference/rest/connections.list).
- [Sửa kết nối](https://tlg.builera.app/docs/reference/rest/connections.update).
- [Dừng kết nối](https://tlg.builera.app/docs/reference/rest/connections.stop).
- MCP: dùng `tools_run` với mã tương ứng sau khi đọc `tools_describe`.

Xem thêm [gửi an toàn](https://tlg.builera.app/docs/agent-playbooks/send-safely) và [xác nhận thao tác](https://tlg.builera.app/docs/concepts/confirmations).