Agent và trợ lý mặc định
Agent là trợ lý bạn dựng cho một việc cụ thể, chẳng hạn trả lời câu hỏi nhân sự từ kho tri thức Nhân sự hay tra số liệu bán hàng trong Contoso ERP. Bạn quyết định agent biết những gì, được dùng công cụ nào, trả lời ra sao và ai được dùng. Genie, trợ lý mặc định, là điểm tiếp nhận chung cho mọi agent: mọi người gõ câu hỏi vào một ô chat duy nhất, và Genie tự chọn đúng tài liệu, số liệu hoặc agent cho từng câu. Người đóng góp tạo được agent và quản lý agent do mình tạo; Quản trị viên và Chủ sở hữu quản lý mọi agent, trợ lý mặc định và định tuyến.
Agent và Genie phối hợp thế nào
- Genie là trợ lý mặc định của mọi cuộc trò chuyện mới, trừ khi bạn chọn khác. Với từng câu hỏi, Genie quyết định tra cứu ở đâu trong phạm vi các nguồn người hỏi được dùng, và một dòng ghi chú ngắn dưới câu trả lời cho biết Genie đã tra ở đâu.
- Agent là trợ lý chuyên trách. Người dùng có thể chọn một agent trong ô chat, gọi agent bằng
@cho một tin nhắn, hoặc để Genie tự chuyển câu hỏi cho agent. - Agent luôn làm việc theo quyền của người hỏi. Agent chỉ tìm thấy tài liệu người đó có quyền đọc và những dòng dữ liệu mà bộ lọc dòng của họ cho phép.
Các ví dụ Contoso trong bài này dùng ba agent:
| Agent | Dùng gì | Ai được dùng |
|---|---|---|
| Trợ lý nhân sự | Kho tri thức Nhân sự | Mọi thành viên workspace |
| Trợ lý kinh doanh | Kho tri thức Kinh doanh và cơ sở dữ liệu Contoso ERP | Mọi thành viên workspace |
| Phân tích số liệu | Cơ sở dữ liệu Contoso ERP và một sandbox có kỹ năng để lập bảng, vẽ biểu đồ | Chỉ những người được chọn, ví dụ Lê Minh và Võ Nam |
Tạo agent
Bạn cần vai trò Người đóng góp trở lên, và workspace phải có sẵn ít nhất một mô hình trò chuyện; quản trị viên hệ thống là người thêm mô hình cho mọi workspace (xem Mô hình và bảo vệ dữ liệu). Ở ví dụ này, Hoàng Thu, trưởng phòng nhân sự, tạo Trợ lý nhân sự.
- Trên thanh bên, mở Agent rồi bấm Tạo agent. Trình chỉnh sửa agent mở ra ở mục Thông tin cơ bản.
- Ở Chế độ chạy, chọn Suy luận nâng cao (suy luận nhiều bước, dùng công cụ) hoặc Trả lời nhanh (hỏi đáp từ kho tri thức, có trích dẫn). Xem Viết hướng dẫn cho agent.
- Nhập Tên ("Trợ lý nhân sự") và Mô tả ("Trả lời câu hỏi về nghỉ phép, phụ cấp, công tác phí và sổ tay nhân viên"). Genie đọc phần mô tả khi quyết định chuyển câu hỏi nào cho agent này, nên hãy viết cụ thể.
- Mở Prompt và viết Prompt hệ thống: agent là ai và trả lời thế nào.
- Mở Cấu hình mô hình và chọn Mô hình.
- Mở Kho tri thức, chọn Kho tri thức đã chọn rồi chọn Nhân sự.
- Thiết lập thêm những gì bạn cần (xem các phần bên dưới), rồi bấm Tạo agent.
- Trình chỉnh sửa vẫn mở và có thêm hai mục Chia sẻ và Định tuyến Genie. Điều chỉnh nếu cần, rồi bấm Lưu và đóng.
website-docs/public/screenshots/vi/agent-editor.pngTên, prompt hệ thống và mô hình là bắt buộc. Genie tự tạo ảnh đại diện của agent từ tên, bạn không cần tải ảnh lên.
Các mục trong trình chỉnh sửa
Các mục được xếp thành nhóm ở bên trái. Công cụ, Dịch vụ MCP, Cơ sở dữ liệu, Agent khác và Kỹ năng chỉ có ở agent Suy luận nâng cao; Chia sẻ và Định tuyến Genie chỉ hiện sau khi tạo agent.
| Nhóm | Mục | Tác dụng với người dùng |
|---|---|---|
| Cơ bản | Thông tin cơ bản | Chế độ chạy, loại agent, tên, mô tả, bộ nhớ dài hạn, hồ sơ người hỏi; sau khi tạo còn có ID agent (dùng cho tích hợp API) và Kênh phát hành nơi agent trả lời |
| Prompt | Prompt hệ thống: vai trò, quy tắc và giọng văn của agent | |
| Cấu hình mô hình | Mô hình trò chuyện và cách mô hình tạo câu trả lời | |
| Hội thoại | Cách dùng các tin nhắn trước đó trong cuộc trò chuyện (đa số agent giữ mặc định) | |
| Gợi ý câu hỏi | Câu hỏi mở đầu hiện khi ô chat còn trống, và câu hỏi tiếp nối sau mỗi câu trả lời | |
| Ai được dùng | Ai được trò chuyện với agent (xem Chọn ai được dùng agent) | |
| Tri thức & Truy xuất | Kho tri thức | Agent tìm trong những kho tri thức nào |
| Chiến lược truy xuất | Tinh chỉnh cách tìm trong tài liệu; hãy giữ mặc định trừ khi nhà cung cấp Genie của bạn đề nghị thay đổi | |
| Tìm kiếm web | Agent có được tìm trên internet hay không | |
| Tiện ích mở rộng | Tải lên tệp đính kèm | Người dùng có được đính kèm hình ảnh, âm thanh trong ô chat hay không |
| Công cụ | Các công cụ có sẵn mà agent được gọi | |
| Dịch vụ MCP | Công cụ bên ngoài kết nối qua MCP | |
| Cơ sở dữ liệu | Cơ sở dữ liệu và mô hình Power BI agent được truy vấn | |
| Agent khác | Các agent mà agent này được hỏi ý kiến | |
| Kỹ năng | Kỹ năng chạy trong sandbox, để xử lý tệp, lập bảng và biểu đồ | |
| Xuất bản & tích hợp | Chia sẻ | Chia sẻ agent với workspace khác |
| Định tuyến Genie | Thẻ định tuyến của agent: những gì Genie biết về agent |
Viết hướng dẫn cho agent
Những gì bạn viết ở Thông tin cơ bản và Prompt định hình mọi câu trả lời.
- Chế độ chạy. Trả lời nhanh tìm trong kho tri thức một lần rồi trả lời kèm trích dẫn: nhanh, rẻ, hợp với câu hỏi về quy định và quy trình. Suy luận nâng cao lập kế hoạch, tìm nhiều lần, gọi công cụ, truy vấn cơ sở dữ liệu, chạy kỹ năng và có thể hỏi agent khác: dùng cho mọi việc cần nhiều hơn một lần tra tài liệu.
- Loại agent (chỉ với Suy luận nâng cao). Mỗi mẫu tự điền prompt hệ thống, danh sách công cụ và phạm vi kho tri thức đề xuất: Hỏi đáp RAG, Hỏi đáp Wiki, Kết hợp (Wiki + RAG), Phân tích dữ liệu hoặc Tùy chỉnh. Bạn vẫn sửa được mọi thứ mẫu đã điền.
- Mô tả. Một đến hai câu về những gì agent trả lời được. Genie dùng phần này, cùng với hướng dẫn và kho tri thức, để viết thẻ định tuyến của agent.
- Prompt hệ thống. Hãy viết như khi dặn việc cho một đồng nghiệp mới: việc cần làm, nguồn phải dựa vào, làm gì khi tài liệu không có câu trả lời, và giọng văn. Ví dụ:
Bạn là trợ lý nhân sự của Contoso. Hãy trả lời các câu hỏi về nghỉ phép, phụ cấp,
công tác phí và sổ tay nhân viên, dựa trên kho tri thức Nhân sự.
Nêu rõ quy định và điều khoản bạn dựa vào. Nếu tài liệu không đề cập, hãy nói rõ
và đề nghị người hỏi liên hệ phòng nhân sự qua thu.hoang@contoso.test.
Trả lời bằng ngôn ngữ của câu hỏi.- Bộ nhớ dài hạn. Bật: agent được đọc và bổ sung vào bộ nhớ dài hạn của từng người. Công tắc này không có tác dụng khi bộ nhớ dài hạn đang tắt ở cấp workspace hoặc ở cấp cá nhân (xem Quyền riêng tư và lưu giữ dữ liệu).
- Dùng hồ sơ của người hỏi. Bật: agent biết ai đang hỏi (các Thuộc tính được dùng, như chức danh, phòng ban), nên agent trả lời câu "phụ cấp ăn trưa của tôi" đúng cho người đó. Lọc theo hồ sơ người hỏi với câu hỏi "của tôi" còn thu hẹp kho tri thức về đúng chi nhánh hay nhà máy của người hỏi khi câu hỏi có chữ "của tôi". Genie không bao giờ gửi email, số điện thoại và các thuộc tính không có trong danh sách. Thuộc tính lấy từ Microsoft Entra ID và trang Thành viên (xem Thành viên và đăng nhập).
Cho agent tri thức và công cụ
| Mục → cài đặt | Tác dụng với người dùng |
|---|---|
| Kho tri thức → Kho tri thức | Tất cả kho tri thức, Kho tri thức đã chọn hoặc Không dùng kho tri thức. Agent chỉ tìm thấy tài liệu người hỏi có quyền đọc. |
| Kho tri thức → Chỉ truy xuất khi được nhắc đến | Bật: agent chỉ tìm trong kho tri thức khi người dùng nhắc tới kho đó bằng @. |
| Kho tri thức → Loại tệp được hỗ trợ | Giới hạn loại tệp người dùng được chọn. Để trống nghĩa là cho phép mọi loại. |
| Tìm kiếm web → Tìm kiếm web | Bật: agent được tìm trên internet. Người dùng vẫn tắt được tìm trên web cho từng cuộc trò chuyện, và cài đặt tìm trên web của công ty và của workspace vẫn áp dụng. Dùng Công cụ tìm kiếm và Số kết quả tìm kiếm tối đa để tinh chỉnh. |
| Cấu hình mô hình → Mô hình | Mô hình trò chuyện viết câu trả lời. Chế độ suy nghĩ cho phép mô hình có hỗ trợ suy luận trước khi trả lời (chậm hơn, kỹ hơn). Hiển thị trích dẫn nguồn hiện các chip trích dẫn. Mô hình ReRank sắp xếp lại kết quả tìm kiếm cho chính xác hơn; nên chọn một mô hình khi agent tìm trong kho tri thức. Số vòng lặp tối đa giới hạn số bước của một câu trả lời Suy luận nâng cao. |
| Công cụ → Công cụ được phép | Các công cụ có sẵn, chia theo nhóm: Cơ bản, Truy xuất tri thức (RAG), các nhóm Wiki và Phân tích dữ liệu (tệp CSV, Excel). Công cụ gắn nhãn Ghi sẽ sửa trang wiki; hãy để tắt trừ khi agent có nhiệm vụ duy trì wiki. Công cụ có hiệu lực cho thấy agent thực sự gọi được những gì với cấu hình hiện tại. |
| Cơ sở dữ liệu → Cơ sở dữ liệu agent được truy vấn | Agent được cấp một công cụ truy vấn chỉ đọc cho các kết nối đã chọn, giới hạn trong các bảng và cột đã mô tả cho Genie, kèm bộ lọc dòng của từng người. Chỉ Quản trị viên được thêm cơ sở dữ liệu; ai sửa được agent thì gỡ được. Xem Cơ sở dữ liệu và Power BI. |
| Cơ sở dữ liệu → Mô hình ngữ nghĩa Power BI agent được truy vấn | Tương tự, cho các nguồn dữ liệu Power BI đã bật truy vấn DAX. Truy vấn chạy dưới danh nghĩa ứng dụng của nguồn dữ liệu, nên bảo mật cấp dòng của Power BI không thu hẹp kết quả: chỉ chọn mô hình mà mọi người dùng agent đều có quyền xem. |
| Dịch vụ MCP | Tất cả, Đã chọn hoặc Đã tắt: công cụ bên ngoài từ các dịch vụ MCP của workspace. |
| Kỹ năng → Sandbox và Danh sách kỹ năng | Chọn một sandbox, rồi chọn kỹ năng Tất cả, Đã chọn hoặc Đã tắt. Kỹ năng giúp agent xử lý tệp, tạo tệp Excel hay biểu đồ và chạy mã. Chỉ Quản trị viên cài được kỹ năng. Quản trị viên hệ thống thiết lập các sandbox trong danh sách; với người khác, liên kết tới cài đặt sandbox sẽ nhắc họ nhờ quản trị viên hệ thống. Mã chỉ chạy khi workspace đang bật chạy mã (Cài đặt → Tính năng). Xem Sandbox và kỹ năng. |
| Tải lên tệp đính kèm | Tải lên hình ảnh (cần mô hình thị giác) và Tải lên âm thanh cho phép người dùng đính kèm hình ảnh và bản ghi âm trong ô chat. |
| Gợi ý câu hỏi | Hiển thị câu hỏi mở đầu khi ô chat còn trống (Tuyển chọn, Tri thức hoặc Kết hợp; tự thêm câu hỏi ở Câu hỏi tuyển chọn) và Tạo câu hỏi tiếp nối sau mỗi câu trả lời (tốn thêm lượt gọi mô hình). |
Ở Contoso:
- Trợ lý kinh doanh: Suy luận nâng cao, kho tri thức Kinh doanh, và Contoso ERP ở mục Cơ sở dữ liệu. Lê Minh, một Quản trị viên, là người thêm cơ sở dữ liệu này. Agent trả lời câu "Chi nhánh Đà Nẵng bán được bao nhiêu trong tháng 9?" bằng dữ liệu ERP, còn câu "Chính sách giá cho khách hàng mới là gì?" bằng tài liệu.
- Phân tích số liệu: Suy luận nâng cao, Không dùng kho tri thức, Contoso ERP ở mục Cơ sở dữ liệu, và ở mục Kỹ năng chọn một sandbox có kỹ năng làm tệp Excel và biểu đồ, để agent trả về bảng hoặc tệp biểu đồ.
Cho agent hỏi ý kiến agent khác
Ở mục Agent khác, phần Các agent được hỏi ý kiến, liệt kê những agent mà agent này được nhờ trợ giúp, tối đa 10 agent (của workspace bạn hoặc được chia sẻ với workspace). Ví dụ, Trợ lý kinh doanh có thể hỏi Trợ lý nhân sự về công tác phí cho một chuyến đi bán hàng, rồi trả lời bằng thông tin nhận được kèm nguồn tài liệu nhân sự.
- Mỗi lần hỏi ý kiến đều chạy theo quyền của người hỏi: agent mà người đó không được dùng sẽ không bao giờ được hỏi, và agent được hỏi chỉ đọc nội dung người đó có quyền đọc.
- Agent được hỏi chỉ thấy câu hỏi, không thấy cuộc trò chuyện. Các lần hỏi ý kiến lồng nhau tối đa hai cấp, không bao giờ vòng lại agent đang xử lý chính câu hỏi đó, và mỗi lần chỉ chờ tối đa 3 phút.
- Mặc định danh sách trống, nghĩa là agent không hỏi ý kiến agent nào.
Chọn ai được dùng agent
Mặc định, mọi thành viên workspace đều trò chuyện được với agent. Để thu hẹp, hãy mở agent, vào mục Ai được dùng rồi chọn:
| Tùy chọn | Ai được dùng agent |
|---|---|
| Mọi thành viên workspace | Mọi người (mặc định) |
| Thành viên từ một vai trò trở lên | Thành viên có vai trò từ Vai trò thấp nhất bạn chọn trở lên, ví dụ Người đóng góp |
| Chỉ những người tôi chọn | Những người bạn thêm ở ô Thành viên |
Với Chỉ những người tôi chọn, bạn có thể đặt ngày hết quyền cho từng người ở Ngày hết quyền (không bắt buộc). Họ mất quyền vào cuối ngày đã chọn; lần kiểm tra hằng ngày tiếp theo sẽ xóa họ khỏi danh sách và gửi email cho người đã đặt ngày. Không có ngày hết quyền nghĩa là quyền còn hiệu lực cho đến khi bạn tự gỡ.
Để chỉ Lê Minh và Võ Nam được dùng Phân tích số liệu đến hết năm:
- Mở Agent, bấm vào Phân tích số liệu rồi vào mục Ai được dùng.
- Chọn Chỉ những người tôi chọn và thêm Lê Minh, Võ Nam ở ô Thành viên.
- Ở Ngày hết quyền (không bắt buộc), chọn ngày 31 tháng 12 cạnh tên Võ Nam.
- Bấm Lưu và đóng.
Lưu ý về quyền dùng agent:
- Quản trị viên, Chủ sở hữu và người tạo agent luôn dùng được agent để có thể kiểm thử.
- Người không được dùng agent sẽ không thấy agent trong danh sách agent hay trong danh sách
@, và Genie không bao giờ chuyển câu hỏi của họ cho agent đó. - Quyền dùng agent không mở thêm kho tri thức hay tài liệu nào: agent vẫn chỉ tìm thấy nội dung người hỏi có quyền đọc.
- Ở các không gian chung mà agent được chia sẻ tới, lựa chọn này vẫn có hiệu lực: chỉ những người được chọn, hoặc người có vai trò từ mức đã chọn trở lên trong workspace của họ, mới thấy agent.
Ai được sửa agent
Người tạo agent cùng Quản trị viên và Chủ sở hữu của workspace được sửa, chia sẻ và xóa agent. Những người khác có quyền dùng agent chỉ mở được agent ở chế độ xem. Agent tích hợp sẵn, như Genie và Trả lời nhanh, không có người tạo: chỉ Quản trị viên chỉnh được cài đặt của chúng, còn tên và mô tả thì cố định.
Agent tích hợp sẵn không đi kèm mô hình trò chuyện. Khi Quản trị viên chưa chọn mô hình trong Cấu hình mô hình, agent tích hợp sẵn chọn mô hình theo thứ tự sau: mô hình trò chuyện được đánh dấu Mặc định (do quản trị viên hệ thống chọn, xem Mô hình dùng chung); nếu không có, mô hình mà các agent tích hợp sẵn khác cùng dùng; nếu vẫn không có, mô hình trò chuyện được thêm sớm nhất. Khi chưa có mô hình trò chuyện nào, Genie sẽ trả lời rằng workspace chưa có mô hình trò chuyện; hãy nhờ quản trị viên hệ thống thêm mô hình. Agent do bạn tạo luôn cần mô hình riêng.
Quản lý agent
Trên trang Agent, nút Thao tác khác cạnh mỗi agent liệt kê các thao tác mà vai trò của bạn cho phép:
| Thao tác | Tác dụng | Ai |
|---|---|---|
| Sửa | Mở trình chỉnh sửa | Người tạo, Quản trị viên |
| Sao chép | Tạo một bản sao thuộc về bạn | Người đóng góp trở lên |
| Tắt / Bật | Ẩn agent khỏi ô chat của cả workspace, hoặc hiện lại | Quản trị viên |
| Đặt làm mặc định cho workspace / Bỏ mặc định của workspace | Cuộc trò chuyện mới bắt đầu với agent này thay cho Genie (xem Thiết lập trợ lý mặc định) | Quản trị viên |
| Xóa | Xóa agent sau khi xác nhận | Người tạo, Quản trị viên |
Để đưa agent vào Microsoft Teams, Zalo hoặc tiện ích website, xem Teams, Zalo và tiện ích website. Dòng Kênh phát hành ở mục Thông tin cơ bản cho biết agent đang được phát hành ở đâu.
Chia sẻ agent với workspace khác
Để một workspace khác dùng được agent, hãy chia sẻ agent vào một không gian chung mà cả hai workspace cùng tham gia (xem Tổng quan quản trị). Người tạo agent hoặc Quản trị viên có thể chia sẻ, nếu workspace của bạn được phép chia sẻ vào không gian đó.
- Mở agent và vào mục Chia sẻ.
- Đọc các cảnh báo ở đầu mục: những kho tri thức agent dùng để trả lời, và agent có dùng kỹ năng hay không.
- Bấm Chia sẻ, chọn không gian ở Chọn không gian chung rồi xác nhận.
Không gian đó xuất hiện trong danh sách Đã chia sẻ với, kèm quyền Chỉ đọc. Muốn ngừng chia sẻ, bấm Gỡ chia sẻ ở dòng tương ứng.
Với người ở các workspace khác:
- Họ dùng agent đúng như bạn đã cấu hình, với mô hình và kho tri thức của workspace bạn. Họ hỏi được về các kho tri thức đó kể cả khi không có quyền mở các kho này, nên chỉ chia sẻ agent có tri thức mà họ được phép biết.
- Họ không sửa được agent, không thấy hướng dẫn hay người tạo agent.
- Agent không truy vấn Cơ sở dữ liệu hay Power BI của bạn cho họ, vì bộ lọc dòng gắn với thành viên của workspace bạn.
- Kỹ năng của agent chạy trong sandbox của workspace bạn, với các biến bí mật mà Quản trị viên của bạn đã đặt. Người dùng cố ý vẫn có thể khiến agent để lộ các giá trị này.
- Quản trị viên bên họ có thể Tắt agent được chia sẻ cho workspace của mình.
Agent tích hợp sẵn không chia sẻ được. Agent phải có mô hình trò chuyện (và mô hình ReRank nếu tìm trong kho tri thức) thì mới chia sẻ được.
Kết nối dịch vụ MCP
MCP (Model Context Protocol) là chuẩn chung để trợ lý AI gọi công cụ bên ngoài, như hệ thống theo dõi đơn hàng hay phần mềm quản lý yêu cầu hỗ trợ. Khi bạn thêm một dịch vụ MCP vào workspace, các agent Suy luận nâng cao dùng được công cụ của dịch vụ đó. Chỉ Quản trị viên mới thêm và sửa được dịch vụ MCP. Nếu muốn làm ngược lại, tức cho trợ lý khác dùng Genie như một máy chủ MCP, xem MCP.
Để thêm một dịch vụ, ví dụ dịch vụ theo dõi giao hàng tại https://mcp.contoso.test/delivery:
- Trên thanh bên, mở Công cụ, chọn thẻ Dịch vụ MCP rồi bấm Thêm dịch vụ. Bảng Thêm dịch vụ MCP mở ra ở bước Kết nối.
- Nếu nhà cung cấp dịch vụ đưa cho bạn một đoạn cấu hình, mở Nhập từ mã, dán vào rồi bấm Phân tích & điền. Nếu không, hãy điền biểu mẫu:
- Tên dịch vụ, và bật Bật dịch vụ.
- Kiểu truyền tải: SSE hoặc HTTP Streamable, theo tài liệu của nhà cung cấp. Genie không hỗ trợ dịch vụ chạy dưới dạng lệnh trên máy cục bộ.
- URL dịch vụ.
- Header tùy chỉnh (tùy chọn): các header mà dịch vụ hoặc cổng mạng của công ty yêu cầu.
- Ở Xác thực, chọn Phương thức xác thực (xem bảng bên dưới) và nhập thông tin xác thực.
- Ở Nâng cao, giữ nguyên Thời gian chờ (giây), Số lần thử lại và Độ trễ thử lại (giây), trừ khi dịch vụ phản hồi chậm.
- Bấm Lưu và tiếp tục. Genie kết nối tới dịch vụ rồi chuyển sang bước Công cụ và cách dùng, nơi liệt kê các công cụ của dịch vụ.
- Viết Hướng dẫn sử dụng: dịch vụ dùng để làm gì, khi nào nên dùng và có giới hạn gì. Agent đọc phần này trước khi chọn công cụ. Bấm Tạo bằng AI để soạn sẵn nội dung từ danh sách công cụ; hãy đọc lại trước khi lưu.
- Trong danh sách công cụ, tắt Đã bật ở những công cụ agent không nên dùng, và bật Yêu cầu phê duyệt cho công cụ làm thay đổi dữ liệu hoặc gửi thông tin ra ngoài.
- Bấm Lưu.
| Phương thức xác thực | Khi nào dùng |
|---|---|
| Không có / Header tùy chỉnh | Dịch vụ không cần đăng nhập, hoặc chỉ cần một header cố định đặt ở Header tùy chỉnh (tùy chọn) |
| Khóa API / Token | Dịch vụ dùng một khóa chung cho mọi người. Nhập Tên header (mặc định X-API-Key) và Secret / Token. Mọi người dùng agent đều thao tác bằng khóa này. |
| OAuth 2.0 (ủy quyền ở lần kết nối đầu tiên) | Mỗi người đăng nhập dịch vụ bằng tài khoản riêng. Bấm Ủy quyền để chính bạn đăng nhập, nhờ đó Genie lấy được danh sách công cụ; người khác sẽ được yêu cầu đăng nhập ngay trong ô chat vào lần đầu agent cần tới dịch vụ. |
Sau đó giao dịch vụ cho agent: mở agent, vào mục Dịch vụ MCP và chọn Tất cả (mọi dịch vụ đang bật, kể cả dịch vụ thêm sau này), hoặc Đã chọn rồi chọn dịch vụ ở Chọn dịch vụ MCP. Thời gian chờ xác thực (giây) là thời gian agent chờ người dùng đăng nhập xong (mặc định 600 giây).
Trên trang Dịch vụ MCP, mỗi thẻ dịch vụ hiện hướng dẫn sử dụng, số công cụ và công tắc Bật / Tắt. Dịch vụ gắn nhãn Tích hợp sẵn do nhà cung cấp Genie của bạn cung cấp và không sửa được. Sau khi đổi URL hoặc thông tin xác thực của một dịch vụ, hãy mở Công cụ và cách dùng và bấm Làm mới công cụ trước khi agent dùng lại.
Phê duyệt lệnh gọi công cụ
Khi agent muốn gọi một công cụ đã bật Yêu cầu phê duyệt, ô chat hiện một thẻ phê duyệt, ghi rõ dịch vụ, công cụ và Tham số. Người đang trò chuyện có thể sửa tham số, rồi bấm Phê duyệt & chạy hoặc Từ chối. Nếu không ai quyết định trong khoảng 10 phút, lệnh gọi bị coi là đã từ chối và agent tiếp tục với những gì đang có.
Với dịch vụ OAuth mà người dùng chưa đăng nhập, ô chat hiện thẻ Ủy quyền để mở cửa sổ đăng nhập, và lệnh gọi công cụ tự tiếp tục khi đăng nhập thành công; bấm Bỏ qua để tiếp tục mà không dùng công cụ. Trong Microsoft Teams và Zalo, Genie không mở được cửa sổ đó, nên agent tiếp tục mà không dùng công cụ của dịch vụ này.
Thiết lập trợ lý mặc định
Genie trả lời các cuộc trò chuyện mới: với từng câu hỏi, Genie tự chọn nguồn, từ tài liệu đến Cơ sở dữ liệu, Power BI, web hoặc một agent. Quản trị viên chọn nguồn cho Genie từ dòng của Genie trên trang Agent.
- Trên thanh bên, mở Agent, bấm Thao tác khác (⋯) cạnh Genie rồi chọn Cài đặt trợ lý mặc định. Cài đặt mở ra trong một bảng bên cạnh.
- Ở Trợ lý mặc định cho cuộc trò chuyện mới, giữ Genie (tự động), hoặc chọn Trả lời nhanh nếu chỉ muốn trả lời từ tài liệu, không định tuyến.
- Ở Nguồn Genie được dùng, chọn những nơi Genie được tra cứu (xem bảng).
- Bấm Lưu thay đổi.
website-docs/public/screenshots/vi/default-assistant.png| Cài đặt | Tác dụng với người dùng | Mặc định |
|---|---|---|
| Trợ lý mặc định cho cuộc trò chuyện mới | Cuộc trò chuyện mới bắt đầu với trợ lý nào. Các cuộc trò chuyện đã có giữ nguyên trợ lý của chúng, và ai cũng vẫn chọn được trợ lý khác hoặc gọi agent bằng @. Nếu bạn đã đặt một agent làm mặc định từ trang Agent, agent đó hiện ở đây dưới dạng "Agent khác". | Genie (tự động) |
| Kho tri thức | Luôn là Mọi kho tri thức người hỏi được đọc | |
| Cơ sở dữ liệu | Tất cả nguồn được phép, Đã chọn hoặc Tắt. Genie chỉ truy vấn những cơ sở dữ liệu mà cài đặt Ai được tra cứu qua Genie cho phép người hỏi (xem Cơ sở dữ liệu và Power BI). | Tất cả nguồn được phép |
| Power BI | Tương tự, cho các nguồn Power BI đã bật truy vấn DAX | Tất cả nguồn được phép |
| Tìm trên web | Bật: theo cài đặt tìm trên web của công ty và của workspace, ưu tiên tài liệu. Tắt: Genie không bao giờ tìm trên web. | Bật |
| Trợ lý chuyên trách | Tối đa 10 agent mà Genie cân nhắc trước tiên khi câu hỏi rõ ràng thuộc về một agent. Mỗi agent trả lời với quyền truy cập của chính người hỏi. | Không có |
Bên dưới phần nguồn, bảng cài đặt nhắc rằng giới hạn và cách định tuyến do quản trị viên hệ thống đặt, và có nút Mở rà soát định tuyến (xem Rà soát câu hỏi định tuyến nhầm). Mọi thay đổi trong bảng này đều được ghi vào nhật ký kiểm toán của workspace.
Để đặt một agent khác làm mặc định, mở Agent, bấm Thao tác khác cạnh agent đó và chọn Đặt làm mặc định cho workspace. Thành viên không được dùng agent đó vẫn bắt đầu với Genie. Chọn Bỏ mặc định của workspace để quay về Genie.
Giới hạn và định tuyến
Giới hạn cho mỗi câu trả lời và cách Genie định tuyến được đặt một lần cho cả công ty: quản trị viên hệ thống đặt các giá trị này ở Cài đặt → Trợ lý & hội thoại (xem Quản trị hệ thống) và có thể cho riêng một workspace dùng giá trị khác. Khi bạn lưu cài đặt của Genie trong một workspace, các giá trị này không bao giờ thay đổi. Nếu workspace của bạn cần giá trị khác, hãy liên hệ quản trị viên hệ thống.
| Cài đặt | Tác dụng với người dùng | Mặc định |
|---|---|---|
| Số bước mỗi câu trả lời | Số bước dùng công cụ trong một câu trả lời, từ 2 đến 300 | 100 |
| Thời gian mỗi câu trả lời | Số giây cho một câu trả lời, từ 20 đến 3.600 | 1.800 (30 phút) |
| Số token mỗi câu trả lời | Lượng dùng mô hình cho một câu trả lời, từ 10.000 đến 50.000.000 | 10.000.000 |
| Thời gian mỗi lần tra cứu | Số giây tối đa cho một lần tìm kiếm hay truy vấn trước khi Genie chuyển sang nguồn khác, từ 5 đến 900 | 300 |
| Tra cứu thêm khi tài liệu chưa đủ | Khi câu trả lời nhanh từ tài liệu chưa tốt, Genie tra tiếp ngay trong lượt đó bằng Cơ sở dữ liệu, Power BI, web hoặc một agent | Bật |
| Dùng thẻ định tuyến | Genie đối chiếu câu hỏi với thẻ định tuyến của từng nguồn. Tắt: Genie chỉ định tuyến theo quy tắc và nội dung câu hỏi. | Bật |
Giá trị mặc định khá rộng để đủ cho những việc dài như soạn hợp đồng, tổng hợp nhiều tài liệu hay phân tích cơ sở dữ liệu hàng triệu dòng: câu trả lời đầy đủ quan trọng hơn trả lời nhanh, còn chi phí đã có hạn mức hằng tháng kiểm soát. Khi một câu trả lời chạm giới hạn, Genie dừng lại, trả lời bằng những gì đã tìm được và nói rõ là đã chạm giới hạn. Khi câu trả lời cần chạy mã hoặc hỏi agent khác, Genie tự nới giới hạn cho câu trả lời đó.
Định tuyến: Genie chọn nguồn thế nào
Với mỗi câu hỏi, Genie quyết định bắt đầu từ đâu, trong phạm vi các nguồn người hỏi được dùng:
- Quy tắc. Genie trả lời ngay lời chào và yêu cầu đơn giản. Câu hỏi về số liệu (doanh số, tồn kho, đơn hàng trong một kỳ) được chuyển tới Cơ sở dữ liệu; câu hỏi nối tiếp một câu trả lời từ số liệu thì tiếp tục dùng số liệu. Quy tắc hiểu cả tiếng Việt lẫn tiếng Anh, có dấu hay không dấu.
- Thẻ định tuyến. Genie so câu hỏi với thẻ định tuyến của từng nguồn người hỏi được dùng. Một tên hay mã có trong thẻ, như chi nhánh, mã sản phẩm hay khách hàng, là dấu hiệu rõ cho thấy nên dùng nguồn đó.
- Hiểu câu hỏi. Trong lúc tìm hiểu ý câu hỏi, Genie chọn luôn hướng đi. Khi chưa chắc, Genie tra nhiều nguồn thay vì đoán.
Với người đã đăng nhập, Genie tra cứu nhiều bước: bắt đầu từ các nguồn đã chọn và chuyển sang nguồn khác khi một nguồn không có kết quả. Khách truy cập tiện ích website, người nhắn từ Microsoft Teams hoặc Zalo, và các lệnh gọi API trước hết nhận câu trả lời nhanh từ tài liệu; khi Tra cứu thêm khi tài liệu chưa đủ đang bật, nếu câu trả lời chưa tốt, Genie tra tiếp ngay trong lượt đó. Nhóm này không bao giờ nhận câu trả lời từ Cơ sở dữ liệu hay Power BI.
Khi câu hỏi của một thành viên đã đăng nhập rõ ràng thuộc về một agent, Genie chuyển câu hỏi cho agent đó. Genie có thể hỏi bất kỳ agent nào của workspace mà người hỏi được dùng; các Trợ lý chuyên trách được ưu tiên trước. Agent làm việc theo quyền của người hỏi, chỉ thấy câu hỏi, và gửi câu trả lời về kèm nguồn. Khi đó, dòng ghi chú dưới câu trả lời sẽ có dạng "Đã hỏi Trợ lý nhân sự".
Thẻ định tuyến
Thẻ định tuyến cho Genie biết một nguồn trả lời được những gì. Mỗi kho tri thức, agent, kết nối cơ sở dữ liệu và nguồn Power BI đều có một thẻ. Với agent, mở agent và vào mục Định tuyến Genie; với các nguồn khác, xem Kho tri thức và Cơ sở dữ liệu và Power BI.
| Phần | Nội dung |
|---|---|
| Tóm tắt | Vài câu về phạm vi của nguồn |
| Chủ đề | Tối đa 15 chủ đề ngắn |
| Câu hỏi mẫu | Tối đa 20 câu hỏi nguồn trả lời được |
| Tên riêng nhận biết | Các tên và mã chỉ về nguồn này, như chi nhánh, nhóm sản phẩm hay khách hàng |
| Câu hỏi mẫu của bạn | Câu hỏi do chính bạn xếp vào nguồn này, tối đa 50. Các câu này luôn được tính và không bao giờ bị ghi đè. |
Genie tự viết thẻ trong nền, dựa trên chính nguồn: với agent là tên, mô tả, hướng dẫn, kho tri thức, cơ sở dữ liệu và các agent mà agent đó được hỏi ý kiến. Thẻ được làm mới khi nguồn thay đổi. Trạng thái của thẻ là Đang tạo, Sẵn sàng, Đã cũ (thẻ cũ vẫn dùng được cho đến khi thẻ mới sẵn sàng) hoặc Lỗi (hiện thông báo lỗi và thẻ trước đó vẫn được dùng).
Để câu hỏi tới đúng agent hơn:
- Viết Mô tả của agent thật rõ ràng; thẻ được viết lại từ phần này.
- Ở Câu hỏi mẫu của bạn, gõ một câu hỏi thuộc về agent này, bấm Thêm, rồi bấm Lưu câu hỏi.
- Sau một thay đổi lớn, bấm Tạo lại để dựng lại thẻ ngay.
Chỉ Quản trị viên được tạo lại thẻ và thêm câu hỏi mẫu.
Rà soát câu hỏi định tuyến nhầm
Genie ghi lại cách định tuyến từng câu hỏi. Thẻ Định tuyến của Cài đặt → Phân tích (cũng mở được từ nút Mở rà soát định tuyến trong Cài đặt trợ lý mặc định của Genie) liệt kê những câu có thể đã bị chuyển nhầm nơi.
- Mở Cài đặt → Phân tích rồi chọn thẻ Định tuyến. Cần rà soát hiện các câu mà Genie phải tra cứu thêm (Tài liệu chưa đủ), Dừng ở giới hạn, câu trả lời Bị đánh giá thấp, hoặc người hỏi Đã hỏi lại với một agent ngay sau đó.
- Với từng câu, xem Genie đã đi hướng nào (Trả lời nhanh, Tra cứu thêm hoặc Hỏi agent), đã dùng gì (Đã dùng), và các nguồn Khớp nhất: mà Genie đã cân nhắc.
- Nếu câu hỏi thuộc về nơi khác, chọn đúng nguồn ở ô Thêm vào câu hỏi mẫu của… rồi nhấn Thêm vào câu hỏi mẫu. Câu hỏi được thêm vào câu hỏi mẫu của nguồn đó, với dữ liệu cá nhân như tên hay số điện thoại đã được che, và lần sau các câu tương tự sẽ được gửi tới đó.
- Nếu định tuyến đã đúng, bấm Bỏ qua.
Màn hình chỉ hiện một câu hỏi khi người hỏi đã gửi câu trả lời đó cho quản trị viên kèm đánh giá (xem Quản trị viên thấy được gì). Các mục còn lại hiện là Câu hỏi riêng tư: bạn vẫn thấy cách định tuyến, kết quả, các nguồn và ngày, có thể bỏ qua nhưng không thể thêm vào câu hỏi mẫu. Màn hình không bao giờ cho biết ai đã hỏi hay hỏi lúc mấy giờ. Tất cả câu hỏi hiện mọi câu đã được định tuyến, và Gồm cả câu đã rà soát hiện thêm các câu đã xử lý. Chỉ Quản trị viên và Chủ sở hữu mở được màn hình này.
Gọi agent bằng @ và cho agent phối hợp
Người dùng có thể gọi một agent cho một tin nhắn bằng cách gõ @ và tên agent; tin nhắn tiếp theo quay về trợ lý của cuộc trò chuyện. Bài Agent mô tả trải nghiệm phía người dùng. Với vai trò quản trị, bạn kiểm soát việc này bằng:
- Ai được dùng: danh sách
@của mỗi người chỉ có các agent họ được dùng. - Tắt: agent đã tắt cho workspace thì không gọi được.
- Agent khác: những agent mà một agent được phép tự hỏi ý kiến (xem Cho agent hỏi ý kiến agent khác).
- Trợ lý chuyên trách: những agent mà Genie cân nhắc trước tiên khi chuyển câu hỏi.
Nếu người dùng hỏi lại bằng @ ngay sau một câu trả lời của Genie, câu hỏi đó sẽ hiện trong rà soát định tuyến để bạn chỉ cho Genie nơi đúng.
Lưu ý
- Agent và Genie luôn chạy theo quyền của người hỏi: phân quyền tài liệu, chia sẻ kho tri thức và bộ lọc dòng của cơ sở dữ liệu áp dụng cho mọi câu trả lời, mọi lần hỏi ý kiến và mọi lần chuyển câu hỏi.
- Quyền dùng agent chỉ cấp được cho từng người hoặc theo một vai trò thấp nhất. Bạn không chọn được theo nhóm Entra hay theo thuộc tính thành viên như
department = HR; muốn giới hạn theo phòng ban, hãy liệt kê từng người hoặc giới hạn tài liệu (xem Phân quyền tài liệu). - Ai được dùng agent cũng mở được cài đặt của agent ở chế độ xem, kể cả phần hướng dẫn. Đừng bao giờ ghi mật khẩu hay khóa vào prompt hệ thống.
- Cơ sở dữ liệu và Power BI chỉ trả lời người đăng nhập vào chính Genie, không bao giờ trả lời khách truy cập tiện ích website, người nhắn từ Teams hoặc Zalo, hay lệnh gọi API. Điều này đúng cho cả Genie lẫn agent.
- Kết nối cơ sở dữ liệu mới chỉ trả lời Quản trị viên qua Genie (Quản trị viên ở mục Ai được tra cứu qua Genie), cho đến khi bạn mở rộng phạm vi ở Cơ sở dữ liệu và Power BI. Agent được thêm cơ sở dữ liệu thì vẫn truy vấn được, bất kể cài đặt đó.
- Dịch vụ MCP dùng Khóa API / Token sẽ thao tác bằng cùng một khóa cho mọi người dùng agent. Hãy dùng khóa có quyền hẹp nhất mà dịch vụ cho phép, và bật Yêu cầu phê duyệt cho công cụ ghi dữ liệu hoặc gửi thông tin đi.
- Nếu dịch vụ MCP chạy trong mạng nội bộ của công ty thay vì trên internet, Genie chỉ kết nối được sau khi quản trị viên hệ thống cho phép địa chỉ của dịch vụ (xem Mạng và chống virus).
- Các lần hỏi ý kiến, chuyển câu hỏi và gợi ý câu hỏi tiếp nối cũng dùng mô hình. Lượng dùng này được tính vào Sử dụng & chi phí và hạn mức hằng tháng, gộp chung với câu trả lời mà người hỏi đang chờ (xem Mức sử dụng, phân tích và nhật ký kiểm toán).
- Mọi thao tác tạo, sửa, chia sẻ, xóa agent, thay đổi quyền dùng agent và thay đổi trợ lý mặc định đều được ghi vào nhật ký kiểm toán của workspace.