Tools & MCP
Kết nối assistant với data, API, external services và devices.
Tools giúp assistant/agent làm nhiều việc hơn ngoài việc trả lời bằng context có sẵn. Tùy use case, bạn có thể dùng Built-in Tools, thêm Custom API Tool, kết nối MCP Server, hoặc để device cung cấp tool trong voice session.
Nên Dùng Loại Nào?
| Nhu cầu | Nên dùng |
|---|---|
| Assistant tìm trong documents, dùng memory, web search hoặc image generation | Built-in Tools |
| Gọi một HTTP API đơn giản của bạn | Custom API Tools |
| Kết nối một MCP server đã có sẵn qua URL | MCP Server |
| Dùng MCP server chạy trên máy tính hoặc mạng nội bộ, không có URL công khai | MCP Endpoint |
| Điều khiển capability do ESP32 device cung cấp | Device Tools |
Assistant Gọi Tool Như Thế Nào?
Khi user hỏi một việc cần external data hoặc action, assistant sẽ tự quyết định có gọi tool hay không. Kết quả từ tool thường được đưa lại cho LLM để synthesize thành câu trả lời tự nhiên.
Một số tool trả kết quả trực tiếp cho user. Ví dụ, Image Generation trả ảnh ngay trong chat; Music tool trong voice có thể trả audio file để phát.
Chọn Nơi Dùng Từng Tool
Mỗi tool có thể được giới hạn nơi dùng: ứng dụng, widget trên website, Developer API, voice và các ứng dụng nhắn tin. Ví dụ, bạn có thể giữ tool thay đổi dữ liệu (như tool tạo đơn hàng) khỏi widget công khai, hoặc chỉ dùng tool dành cho voice trong voice.
- Mở Admin Panel và chọn assistant.
- Tìm tool: trang Công cụ cho Built-in và Custom API Tool; trang MCP cho MCP Server (mở danh sách tool của server) và MCP Endpoint.
- Bấm vào cột Khả dụng trên, chọn những nơi tool được dùng rồi bấm Lưu.
Một số tool chỉ hoạt động ở một số nơi. Ví dụ, Music chỉ chạy trong voice, nên không thể chọn nơi khác. Tắt tool sẽ ngừng tool đó ở mọi nơi.
Tự viết MCP server? Tool có thể khai báo nơi nó hoạt động bằng cách liệt kê app, widget, api, voice hoặc messaging trong _meta.assistant_platform.surfaces. Assistant chỉ dùng tool ở những nơi đó, và Admin Panel khóa các lựa chọn còn lại.
Quyền Truy Cập Theo Gói
MCP có sẵn trên mọi gói, kể cả gói Free. Việc bạn có thấy và dùng được MCP hay không còn tùy vào vai trò của bạn trong assistant. Xem Gói & giá để biết chi tiết từng gói.
Nếu bạn không thấy MCP trong Admin UI, hãy kiểm tra vai trò và quyền của tài khoản trong assistant đó.