Công cụ ngoài và phản hồi

Tổng quan hướng dẫn

Đối tượng: Quản trị viên hệ thống kết nối trợ lý với các dịch vụ khác và xem mọi người đánh giá câu trả lời ra sao.
Thời gian đọc: khoảng 15 phút.
Kết quả: Một dịch vụ được phê duyệt và một máy chủ công cụ được thiết lập cho nó, các danh mục phản hồi đã có, và bạn mở được các đánh giá rồi lần ngược một câu trả lời kém tới lần gọi của nó.

Một máy chủ công cụ ngoài cho trợ lý thêm các hành động từ một dịch vụ khác. Không có gì được gửi tới một máy chủ cho đến khi địa chỉ của nó được phê duyệt, nên thứ tự an toàn luôn là: phê duyệt dịch vụ, rồi mới kết nối máy chủ. Phản hồi là nửa còn lại của kiểm soát chất lượng: mọi người đánh giá câu trả lời, và bạn đọc các đánh giá đó.

Trước khi bắt đầu

Bạn cần

Lý do

Quyền truy cập Thiết lập (quản trị viên hệ thống)

Phê duyệt một dịch vụ, kết nối một máy chủ, đọc các đánh giá và định nghĩa danh mục phản hồi là việc của quản trị viên hệ thống. Quản trị viên AI thấy Máy chủ và Dịch vụ đã phê duyệt nhưng không đổi được.

Địa chỉ của dịch vụ

Bạn phê duyệt đúng các địa chỉ mà dịch vụ dùng, không hơn.

Phê duyệt một dịch vụ

Mặc định không có gì được phê duyệt, nên chưa trợ lý nào liên hệ với máy chủ công cụ ngoài nào.

  1. Vào AI ‣ Cấu hình ‣ Máy chủ Công cụ Ngoài ‣ Dịch vụ đã phê duyệt và bấm Mới.

  2. Gõ tên Dịch vụ và một Mã, rồi đặt mẫu địa chỉ vào Mẫu URL đã phê duyệt. Mẫu chính là sự phê duyệt: kết nối có URL khớp với nó thì được liên hệ, còn lại thì không. Một mẫu lỏng lẻo sẽ phê duyệt mọi điểm đến trên internet và trong mạng nội bộ của bạn, nên hãy viết mẫu càng chính xác càng tốt.

  3. Điền URL gợi ý, Xác thực và Tài liệu để giúp người kết nối dịch vụ, rồi bấm Lưu.

    Một dịch vụ đã phê duyệt với mẫu URL đã phê duyệt, mã và URL gợi ý

Kết nối một máy chủ

  1. Vào AI ‣ Cấu hình ‣ Máy chủ Công cụ Ngoài ‣ Máy chủ và bấm Mới.

  2. Gõ Tên và chọn Dịch vụ đã phê duyệt bao trùm địa chỉ. URL và Mã định danh được điền sẵn từ dịch vụ đã phê duyệt, và bạn sửa được. Giữ Giao thức truyền tải như đề xuất trừ khi dịch vụ ghi rõ cách khác.

  3. Trong mục Thông tin xác thực, đặt Xác thực theo điều dịch vụ mong đợi: Không xác thực, Bearer Token (Authorization: Bearer), Header khóa API (X-API-Key), Header khác, HTTP Basic (user:password), hoặc một trong hai chế độ OAuth 2.1. Gõ thông tin xác thực một lần vào ô Thông tin xác thực. Đã cấu hình thông tin xác thực chỉ cho biết đã có một thông tin được lưu.

  4. Bấm Lưu, rồi bấm Kiểm tra kết nối. Thanh trạng thái đi từ Chưa từng liên hệ tới Đang liên hệ và Đã kết nối. Khi địa chỉ chưa được phê duyệt nào bao trùm, nút Phê duyệt URL này xuất hiện trên máy chủ và phê duyệt đúng địa chỉ đó.

    Một máy chủ công cụ ngoài với điểm đến, thiết lập thông tin xác thực và thanh trạng thái hiện Chưa từng liên hệ

Ghi chú

Biểu mẫu máy chủ còn có thời gian chờ, các giới hạn và mục CHỈ QUẢN TRỊ VIÊN HỆ THỐNG cho mạng riêng và cách xử lý xác nhận. Hãy để nguyên mặc định trừ khi bạn có lý do rõ ràng để đổi.

Định nghĩa danh mục phản hồi

Mọi người đánh giá một câu trả lời bằng các nút hài lòng, không hài lòng hoặc gắn cờ dưới nó, khi trợ lý bật Thu thập phản hồi của người dùng. Danh mục gom nhóm các lý do.

  1. Vào AI ‣ Cấu hình ‣ Danh mục phản hồi và bấm Mới. Gõ Tên như Câu trả lời sai hoặc Giọng điệu chưa phù hợp rồi lưu.

    Danh sách danh mục phản hồi với cờ hiệu lực
  2. Bỏ đánh dấu Hiệu lực để ẩn một danh mục khỏi danh sách chọn. Phản hồi đã có vẫn giữ nó.

Tìm các câu trả lời bị đánh giá kém

  1. Vào AI ‣ Báo cáo ‣ Phản hồi. Mỗi dòng là một đánh giá, với Ngày, Người dùng, Trace ID, Đánh giá và Nhận xét.

    Danh sách các đánh giá với ngày, người dùng, trace ID, đánh giá và nhận xét
  2. Dùng các bộ lọc Hài lòng, Không hài lòng và Bị gắn cờ, hoặc gom theo Đánh giá, Người dùng hay Danh mục.

  3. Sao chép Trace ID để tìm lần gọi đằng sau đánh giá: trong AI ‣ Báo cáo ‣ Tổng hợp, chuyển sang dạng danh sách và hiện cột Trace ID bằng nút cột tuỳ chọn, rồi mở lần gọi đó (xem Giới hạn chi phí, mức sử dụng và kiểm toán).

Điểm kiểm tra thành công

  • Dịch vụ đã phê duyệt được lưu, và máy chủ của nó hiện Chưa từng liên hệ, rồi Đã kết nối khi dịch vụ phản hồi.

  • Các danh mục phản hồi của bạn được liệt kê và đang hiệu lực.

  • Danh sách Phản hồi hiện các đánh giá, và bạn đối chiếu được một Trace ID với một lần gọi.

Các vấn đề thường gặp

Vấn đề

Cách xử lý

Một máy chủ ở lại Chưa từng liên hệ.

Kiểm tra địa chỉ đã được phê duyệt chưa, rồi bấm Kiểm tra kết nối. Dùng Phê duyệt URL này trên máy chủ nếu thiếu phê duyệt.

Bạn không thấy Phản hồi, Danh mục phản hồi hoặc Nguồn tri thức.

Các menu này chỉ dành cho quản trị viên hệ thống.

Bạn không lưu được một máy chủ hay một phê duyệt.

Chỉ quản trị viên hệ thống làm được. Quản trị viên AI đọc được các danh sách này.

Không ai đánh giá được các câu trả lời.

Mở trợ lý trong AI ‣ Trợ lý AI và đánh dấu Thu thập phản hồi của người dùng.

Các bước tiếp theo