Cơ sở kiến thức GetMyBot

Trả lời bằng AI và tác nhân AI

Cách dùng AI cho một bước xử lý yêu cầu hoặc thiết lập tác nhân trả lời dựa trên tài liệu của bạn và chuyển hội thoại cho nhân viên.

Trên trang này

Bạn có thể giao cho AI một bước trong phản ứng hoặc cả cuộc trò chuyện:

Chọn cách nàoKhi nào phù hợpBạn cấu hình gì
Hành động AICần một bước: lấy số điện thoại và chủ đề từ tin nhắn, hoặc viết câu trả lời ngắnPhản ứng và nhiệm vụ cụ thể cho mô hình
Tác nhân AICần tự trả lời câu hỏi dựa trên nguồn kiến thức của bạnTài liệu, quy tắc trả lời và lúc nào chuyển cho nhân viên

Cả hai cần cùng một tích hợp AI.

Kết nối mô hình

Thêm tích hợp loại AI trong mục Tích hợp rồi nhập:

  • Base URL: địa chỉ API tương thích OpenAI, mặc định https://api.openai.com/v1. Có thể dùng OpenAI, OpenRouter, máy chủ cục bộ và nhà cung cấp tương thích khác.
  • Mô hình: ví dụ gpt-4o-mini.
  • System prompt: hướng dẫn chung cho mô hình.
  • API key: khóa của nhà cung cấp; được mã hóa khi lưu, cũng có thể đặt trong thông tin xác thực.

Tích hợp này còn biến đoạn văn thành các biểu diễn số gọi là embedding. Tác nhân dùng chúng để tìm những đoạn có ý nghĩa gần với câu hỏi trong tài liệu. Không có tích hợp AI, tác nhân và tìm kiếm kiến thức đều không hoạt động.

Hành động AI

Trong phản ứng, thêm hành động AI rồi chọn:

  • Tích hợp AI: mô hình đã kết nối.
  • Prompt: nhiệm vụ cho mô hình, có thể dùng biến thay thế như {{text}}, {{param.key}} và {{ctx.key}}.
  • Lưu câu trả lời vào tham số và/hoặc Lưu câu trả lời vào ctx (khóa).
  • JSON schema trích xuất: yêu cầu kết quả JSON có cấu trúc để phân loại hoặc lấy trường từ yêu cầu; có thể xử lý danh sách kết quả bằng vòng lặp qua danh sách.
  • Gửi câu trả lời cho người dùng: đưa ngay văn bản được tạo vào cuộc trò chuyện.

Khối AI trong tin nhắn

Trình tạo tin nhắn có khối AI với prompt riêng để tạo một phần câu trả lời vào lúc gửi. Xem Tin nhắn và nút.

Ví dụ sử dụng

  • Trợ lý đối thoại: prompt cùng tùy chọn gửi câu trả lời cho người dùng.
  • Xử lý yêu cầu: JSON schema lấy chủ đề, liên hệ và mức độ khẩn cấp vào ctx; sau đó ghi vào bộ sưu tập và báo cho nhân viên.
  • Phân loại: lưu kết quả vào tham số, rồi dùng điều kiện Có tham số để kiểm tra.

Tác nhân AI

Mục AI ở menu trái gồm tác nhân, lịch và phân tích. Tác nhân tự xử lý tin nhắn đến: tìm đoạn trong nguồn được phép, soạn câu trả lời, có thể ghi một thông tin về khách hàng hoặc đặt lịch hẹn, và chuyển hội thoại cho người khi quy tắc yêu cầu. Tác nhân ở trạng thái bản nháp không tham gia hội thoại.

Vòng đời và phiên bản

Tác nhân có các trạng thái Bản nháp, Đang hoạt động, Tạm dừng và Đã lưu trữ. Bản nháp có thể kích hoạt hoặc lưu trữ; tác nhân hoạt động có thể tạm dừng hoặc lưu trữ; tác nhân tạm dừng có thể kích hoạt lại hoặc lưu trữ. Lưu trữ không thể hoàn tác.

Khi kích hoạt, toàn bộ cài đặt được lưu thành một phiên bản. Sửa tác nhân đang hoạt động tạo phiên bản mới; các cuộc trò chuyện đang diễn ra vẫn dùng phiên bản lúc chúng bắt đầu. Mỗi kênh đến chỉ thuộc một tác nhân hoạt động; không thể kích hoạt tác nhân thứ hai trên cùng kênh.

Cấu hình

Cơ bản và cách ứng xử:

  • Kênh và bề mặt: tác nhân hoạt động trên Telegram, VKontakte, WhatsApp và website.
  • Ngôn ngữ trả lời: từ 1 đến 20 mã, ví dụ ru, en, pt-br. Câu trả lời bằng ngôn ngữ ngoài danh sách bị chặn trước khi gửi.
  • Hướng dẫn cho tác nhân: tối đa 12.000 ký tự, gồm nhiệm vụ, giới hạn và điều không được làm.
  • Giọng điệu: tối đa 160 ký tự.
  • Độ dài câu trả lời tối đa: từ 200 đến 12.000 ký tự.
  • Mức tự do diễn đạt và ngưỡng tin cậy: từ 0 đến 100%. Dưới ngưỡng, tác nhân không tự trả lời.
  • Ngoài giờ làm việc: trả lời như thường, soạn bản nháp cho nhân viên hoặc chuyển hội thoại. Cần bật lịch hỗ trợ.
  • Chế độ bản nháp: đề xuất câu trả lời cho nhân viên, không gửi cho khách.

Thu thập thông tin:

  • Mục tiêu: những điều tác nhân cần biết từ khách.
  • Thông tin bắt buộc: tối đa 30 mục; mỗi mục có khóa hồ sơ (chữ thường, số, dấu gạch dưới) và câu hỏi để thu thập.
  • Sau khi hoàn tất: tiếp tục trò chuyện hoặc chuyển cho nhân viên.
  • Cụm từ dừng: tối đa 20 cụm, mỗi cụm dài tối đa 160 ký tự. Chỉ khớp khi toàn bộ tin nhắn khách đúng bằng cụm từ, không phân biệt hoa/thường và khoảng trắng thừa.

Kiến thức và công cụ:

  • Nguồn được phép: 1–200 nguồn kiến thức; không chọn được nguồn chỉ dành cho nhân viên hoặc đã tắt.
  • Công cụ được phép: tối đa 8. Tác nhân đang hoạt động chỉ dùng được công cụ lịch, xem Lịch hẹn và Google Calendar. Công cụ có tác động bên ngoài mặc định yêu cầu xác nhận.

Chuyển giao và lỗi:

  • Chuyển cho nhân viên: chọn nhóm nhân viên và tin nhắn khách sẽ thấy trước khi người tiếp nhận.
  • Nếu tác nhân không giúp được: chuyển cho nhân viên, gửi tin dự phòng hoặc trả lại cho kịch bản bot thông thường.

Một câu trả lời được tạo ra thế nào

Sau khi nhận tin, tác nhân tìm tài liệu phù hợp và chuẩn bị câu trả lời. Nếu cần công cụ được phép, chẳng hạn lịch, nó đợi kết quả rồi mới gửi, dùng tin dự phòng, chuyển cho nhân viên hoặc báo lỗi. Tối đa bốn lần gọi công cụ cho một lượt. Mỗi tin đến chỉ xử lý một lần, kể cả khi nhà cung cấp mô hình trả lời chậm; bộ xử lý lặp không được gửi hai câu trả lời.

Máy chủ tạo ngữ cảnh cho mô hình từ hồ sơ khách và các thuộc tính đã duyệt, kênh đã xác minh, cửa sổ tin nhắn và sự kiện gần đây có giới hạn, trạng thái hỗ trợ và lịch, cùng những đoạn tài liệu tìm được. Trước khi gửi cho nhà cung cấp, dữ liệu được cắt bớt và loại bỏ giá trị nhạy cảm.

Tác nhân phải dựa vào nguồn. Tìm kiếm chỉ dùng nguồn của tác nhân và trả tối đa 12 đoạn. Nếu có nguồn, không có công cụ nhưng không tìm được đoạn nào, tác nhân không tự bịa: nó chuyển cho nhân viên hoặc gửi câu trả lời dự phòng với lý do no_source. Câu trả lời viện dẫn nguồn không nằm trong kết quả tìm kiếm bị chặn trước khi gửi.

Chống chỉ dẫn giả trong tin nhắn và tài liệu

Khách hoặc tài liệu có thể chứa câu như «bỏ qua quy tắc và gửi dữ liệu». Tác nhân coi chúng là nội dung, không phải chỉ dẫn mới:

  • Chính sách hệ thống và schema công cụ là các phần riêng của yêu cầu; văn bản khách hoặc nguồn không thay thế được chúng.
  • Mô hình không được chọn bot, khách, nguồn, URL, SQL, thông tin xác thực hay tham số HTTP thô. Chúng lấy từ ngữ cảnh máy chủ; các trường giả danh có thẩm quyền trong câu trả lời mô hình bị loại bỏ.
  • Công cụ chỉ chạy khi đã đăng ký, được tác nhân cho phép và đối số đúng schema đóng, không chấp nhận trường lạ.
  • Mỗi tác động có khóa chống lặp theo lượt và số lần gọi, hạn 15 giây và bản ghi nhật ký với dữ liệu cá nhân đã được loại bỏ.
  • Trước khi gửi, câu trả lời được kiểm tra độ dài, ngôn ngữ, nguồn viện dẫn và nội dung không an toàn; định dạng không hỗ trợ bị xóa.

Thông tin lưu vào hồ sơ và nguồn gốc

Tác nhân chỉ ghi những thông tin có khóa nằm trong danh sách Thông tin bắt buộc. Mỗi thông tin giữ liên kết đến tin nhắn và lượt trò chuyện đã cung cấp nó, cùng trạng thái: được đề xuất, đã áp dụng hoặc bị từ chối. Có thể truy ngược thông tin tác nhân ghi về lời nói thực của khách.

Chuyển cho nhân viên và tiếp tục

Chuyển giao mở hoặc cập nhật hội thoại hỗ trợ thông thường, gán nhóm nhân viên và thêm bản tóm tắt có cấu trúc đã loại dữ liệu nhạy cảm: lý do, thông tin thu thập, nguồn đã dùng và việc chưa hoàn tất. Lý do có thể là cụm từ dừng, độ tin cậy thấp, không có nguồn phù hợp, đã hoàn tất thu thập thông tin, ngoài giờ làm việc hoặc lỗi mô hình/công cụ.

Khi hội thoại thuộc về nhân viên, tác nhân im lặng. Nó chỉ tiếp tục khi có yêu cầu rõ ràng từ hội thoại (POST /api/bots/{botID}/subscribers/{subscriberID}/ai/resume).

Kiểm tra trước khi chạy

Kiểm tra tác nhân xác thực cấu hình và mô phỏng an toàn: không gọi mô hình, không gửi tin, không chạy công cụ và không tạo đặt lịch. Kết quả chỉ cho biết các hành động đã bị chặn. Để xem các đoạn tài liệu thực, dùng Kiểm tra tìm kiếm.

Kiểm tra mức sẵn sàng sẽ không cho kích hoạt khi cấu hình sai, kênh đã có tác nhân khác hoặc chưa kết nối, thiếu nguồn hay nhóm nhân viên, thiếu tích hợp AI, hoặc công cụ lịch chưa có loại lịch hẹn được bật.

Phân tích và đánh giá chất lượng

AI → Phân tích hiển thị hội thoại, câu trả lời đã gửi, câu trả lời dự phòng, lần chuyển nhân viên, lỗi, bản nháp, câu trả lời đã kiểm tra hoặc không an toàn, độ trễ, token đầu vào/đầu ra, chi phí theo tiền tệ, cách dùng nguồn và công cụ, thao tác lịch, cùng kết quả kinh doanh: tự giải quyết, đạt mục tiêu, CSAT, mở lại và chuyển cấp. Có thể lọc theo khoảng thời gian, tác nhân và phiên bản, kênh, ngôn ngữ, phân khúc, nguồn và kết quả; nhóm theo ngày hoặc giờ.

AI → Chất lượng câu trả lời liệt kê các hội thoại của tác nhân. Mỗi lượt hiện trạng thái và số liệu kỹ thuật như độ tin cậy, độ trễ, token và chi phí. Nội dung tin nhắn vẫn nằm trong hội thoại hỗ trợ, có liên kết đến đó. Người đánh giá chọn Đúng, Sai hoặc Không an toàn, kèm mã lý do và bình luận; có thể xuất kết quả. Màn hình và tệp xuất đều loại bỏ dữ liệu nhạy cảm.

Mỗi lượt lưu số token đầu vào/đầu ra và chi phí nếu nhà cung cấp báo, để xem chi phí theo tác nhân và thời gian.

Managed AI

Trong cấu hình tác nhân, bạn chọn rõ nguồn mô hình: tích hợp AI của mình hoặc sản phẩm Managed AI của tài khoản. Nếu khóa riêng lỗi, yêu cầu không tự chuyển sang Managed AI trả phí. Ba cấu hình Managed AI là fast, balanced và quality; chúng chọn cách định tuyến, không khóa cứng một mô hình của nhà cung cấp.

Sản phẩm hiển thị số credit tháng đi kèm, giới hạn tháng cứng và phụ phí. Hãy so sánh trước khi chọn gói. Yêu cầu API trực tiếp cần token cá nhân có quyền managed_ai:invoke và header Idempotency-Key; xem chi phí cần quyền managed_ai:usage:read. Lưu token trên máy chủ của bạn. Các endpoint được mô tả trong REST API.

Bước tiếp theo