Cơ sở kiến thức GetMyBot

Lịch hẹn và Google Calendar

Cho tác nhân AI đặt lịch tư vấn: kết nối Google Calendar, đặt giờ rảnh và cho phép tạo, dời hoặc hủy lịch.

Trên trang này

Tác nhân AI có thể tìm giờ trống và đặt lịch với khách trên Google Calendar, chẳng hạn một buổi tư vấn 30 phút vào ngày làm việc. Nếu được phép, tác nhân cũng có thể dời hoặc hủy lịch.

Vào AI → Lịch, kết nối tài khoản, tạo loại cuộc hẹn và kiểm tra giờ trống. Sau đó cho phép các công cụ lịch cần thiết trong cấu hình tác nhân. Một khoảng trống có thể đặt lịch được gọi là slot.

Hiện chỉ hỗ trợ Google Calendar. Loại cuộc hẹn, lịch đặt và công cụ tác nhân dùng cùng giao diện nền tảng; chưa kết nối được nhà cung cấp lịch khác.

Kết nối tài khoản

Bấm Kết nối Google Calendar và chấp thuận trong cửa sổ Google. Quyền được yêu cầu gồm danh sách lịch, sự kiện và thời gian bận. Nếu chưa hoàn tất trong năm phút, hãy bắt đầu lại.

Kết nối dùng tham số state một lần gắn với bot và tài khoản, PKCE và địa chỉ quay về cố định. state có hiệu lực năm phút.

Refresh token được mã hóa khi lưu và không hiển thị lại. Thẻ kết nối chỉ hiện nhãn tài khoản và một trong bốn trạng thái: Đã kết nối, Quyền hết hạn, Đã ngắt, Lỗi. Nếu quyền hết hạn, hãy kết nối lại.

Nút Ngắt lịch bị khóa nếu tác nhân đang hoạt động còn bật công cụ lịch; giao diện liệt kê những tác nhân đó. Hãy tắt công cụ hoặc tạm dừng tác nhân trước.

Loại cuộc hẹn

Loại cuộc hẹn quyết định những giờ tác nhân có thể đề xuất. Cấu hình gồm:

  • Tên: hiện trong báo cáo và sự kiện khách nhận.
  • Lịch trong tài khoản đã kết nối. ID lịch được mã hóa và không hiển thị lại; khi sửa loại cuộc hẹn, cần chọn lịch lần nữa.
  • Thời lượng: 5–480 phút.
  • Múi giờ: tên IANA như Europe/Berlin; dùng để hiểu giờ rảnh bên dưới.
  • Giờ rảnh: 1–28 khoảng hằng tuần, mốc dạng HH:MM theo ngày. Các khoảng không được chồng nhau; nếu giờ kết thúc trước giờ bắt đầu, khoảng đi qua nửa đêm.
  • Thời gian báo trước tối thiểu: 0–1.440 phút.
  • Đặt trước tối đa: 1–366 ngày.
  • Khoảng trống trước/sau cuộc hẹn: mỗi bên 0–1.440 phút.
  • Bật loại cuộc hẹn: chỉ loại đang bật mới được đề xuất và đặt.

Hiển thị slot trống truy vấn lịch kết nối cho tuần tới, không dùng dữ liệu mô phỏng.

Slot được chọn thế nào

Giờ trống được tính từ giờ hằng tuần của loại cuộc hẹn, khoảng bận của Google Calendar, khoảng đệm và các lịch đặt hiện có của kết nối. Các mốc cách nhau 15 phút; mặc định trả 10 slot, tối đa 20.

Giờ hiện theo múi giờ khách và lưu dưới dạng UTC. Đổi giờ mùa hè có thể đổi giờ địa phương được đề xuất, không đổi thời điểm UTC đã lưu.

Quá trình đặt lịch được kiểm tra cẩn thận:

  1. Kiểm tra lại slot ngay trước khi ghi.
  2. Lưu lịch chờ với khóa chống tạo trùng, nên yêu cầu lặp không tạo hai cuộc hẹn.
  3. Tạo sự kiện trên Google Calendar, có thể kèm liên kết họp video.
  4. Nếu Google trả chậm hoặc lỗi tạm thời, tìm lịch theo khóa chống trùng trước khi thử tiếp; hết giờ chờ không rõ kết quả sẽ không tạo bản sao.
  5. Xác nhận lịch. ID sự kiện phía Google và liên kết họp được mã hóa khi lưu.

Dời và hủy dùng cùng cơ chế. Nếu người khác vừa lấy slot đó, thao tác báo lỗi thay vì tạo hai lịch cùng giờ. Trạng thái lịch: Đang chờ, Đã xác nhận, Đã dời, Đã hủy, Lỗi.

Cấp công cụ cho tác nhân

Trong trình sửa tác nhân, ở Công cụ được phép, bật công cụ cần dùng:

  • Hiển thị slot trống
  • Đặt cuộc hẹn
  • Dời cuộc hẹn
  • Hủy cuộc hẹn

Mỗi công cụ lịch bật cần ít nhất một loại cuộc hẹn còn hiệu lực và đang bật; nếu không, kiểm tra mức sẵn sàng sẽ ngăn kích hoạt tác nhân. Tác nhân đang hoạt động hiện chỉ dùng được công cụ lịch.

Mô hình không tự chọn lịch, khách hoặc yêu cầu tùy ý. Nó chỉ đề xuất lời gọi có đối số đúng schema đóng; bot, người đăng ký và loại cuộc hẹn được phép đến từ ngữ cảnh máy chủ. Mỗi lời gọi có hạn 15 giây và khóa chống trùng theo lượt cùng số lần gọi. Nhật ký loại bỏ liên kết họp và liên hệ khỏi đối số, kết quả.

Báo cáo

AI → Phân tích hiển thị thao tác lịch và kết quả đặt lịch cạnh các số liệu khác của tác nhân. AI → Lịch hiển thị từng cuộc hẹn.

Nếu gặp vấn đề

  • Đã bật công cụ lịch nhưng không có loại cuộc hẹn đang bật: tạo hoặc bật loại trước khi kích hoạt tác nhân.
  • Không tải được danh sách lịch: có thể cần kết nối tài khoản lại; tạm thời có thể nhập ID kết nối thủ công.
  • Không có slot trong tuần tới: kiểm tra giờ hằng tuần, thời gian báo trước, khoảng đệm và lịch bận.
  • Không xóa được loại cuộc hẹn: công cụ lịch của tác nhân đang hoạt động còn dùng nó.

Tài liệu liên quan