Tổng quan tích hợp
Phần này dành cho bộ phận IT, những người kết nối Genie với các công cụ khác của công ty: ứng dụng nội bộ qua API, mạng nội bộ (intranet) qua tiện ích website và trợ lý AI qua MCP. Nhà cung cấp Genie vận hành Genie cho bạn, nên bạn không cần cài máy chủ hay cấu hình gì trên máy: bạn thiết lập mọi thứ trong Cài đặt của Genie và trong công cụ cần kết nối.
Chọn cách kết nối
| Bạn muốn | Dùng | Ai thiết lập | Trang |
|---|---|---|---|
| Gọi Genie từ ứng dụng hoặc script của mình | API, kèm khóa API | Chủ sở hữu workspace tạo khóa | API và khóa API |
| Đặt khung trò chuyện Genie lên một trang intranet | Tiện ích website | Quản trị viên workspace | Tiện ích website |
| Cho Claude, Cursor hay trợ lý AI khác tìm trong kho tri thức của bạn | Genie làm máy chủ MCP | Quản trị viên workspace | MCP |
| Cho agent của Genie dùng công cụ của hệ thống khác | Dịch vụ MCP | Quản trị viên workspace | MCP |
Microsoft Teams và Zalo do quản trị viên workspace thiết lập; xem Teams, Zalo và tiện ích website.
Tìm cài đặt tích hợp
- Trong Genie, mở Cài đặt.
- Trong nhóm Phát hành & tích hợp, chọn API, Tiện ích website hoặc Máy chủ MCP.
Các trang này dành cho Quản trị viên và Chủ sở hữu của workspace; thành viên khác không thấy nhóm này. Chỉ Chủ sở hữu thấy trang API.
Địa chỉ Genie của bạn
Các ví dụ trong phần này dùng công ty mẫu Contoso: Genie chạy tại https://genie.contoso.test, intranet tại https://intranet.contoso.test. Hãy thay bằng địa chỉ của bạn. Địa chỉ Genie là địa chỉ mà người dùng của bạn mở trên trình duyệt.
- API nằm dưới
/api/v1, ví dụhttps://genie.contoso.test/api/v1. - Endpoint MCP nằm dưới
/mcp/, ví dụhttps://genie.contoso.test/mcp/<endpoint ID>. - Script của tiện ích là
https://genie.contoso.test/genie-widget.js.
Công cụ đã kết nối thấy được gì
Khóa API, khách truy cập tiện ích website và client MCP không đại diện cho một người cụ thể. Genie coi họ là khách của workspace:
- Họ chỉ thấy tài liệu không bị giới hạn. Genie không bao giờ tìm, trích hay dẫn nguồn từ tài liệu có phân quyền tài liệu cho họ.
- Họ chỉ dùng được các kho tri thức bạn cho phép: kho tri thức gắn với khóa, agent gắn với tiện ích, hoặc phạm vi của endpoint MCP.
- Họ không truy vấn được Cơ sở dữ liệu hay Power BI, và Genie không chạy mã cho họ.
Lưu ý
- Khóa API, khóa kênh của tiện ích và token MCP đều cho phép truy cập tài liệu của công ty. Hãy bảo quản chúng như mật khẩu, cấp riêng cho từng ứng dụng và xóa ngay khi không dùng nữa.
- Câu hỏi gửi qua API, tiện ích website và MCP được tính vào hạn mức hằng tháng của workspace, nếu workspace có đặt hạn mức.
- Hội thoại bắt đầu qua khóa API chỉ ứng dụng đó xem được trong Genie, quản trị viên workspace cũng không xem được. Hội thoại qua tiện ích website thì Quản trị viên và Chủ sở hữu của workspace đọc được (xem Ai đọc được hội thoại trên các kênh).
- Nếu công ty chỉ cho phép một số mạng, khóa API và endpoint MCP bị giới hạn theo danh sách đó khi quản trị viên hệ thống đã đánh dấu API key và MCP endpoint ở danh sách của nền tảng; riêng khóa API còn bị giới hạn khi workspace bật Áp dụng cả cho API key dùng trong workspace này (xem Mạng và chống virus). Hãy gọi Genie từ mạng được phép.
- Tài liệu tham chiếu đầy đủ về API và các endpoint không có trong bộ tài liệu này. Hãy liên hệ nhà cung cấp Genie để nhận.