Tài liệu

Sổ tay cho AI agent

Chuẩn bị bản nháp chiến dịch

Tạo và kiểm tra bản nháp chiến dịch theo yêu cầu của người mà không tự xuất bản hoặc bắt đầu chạy.

Xem Markdown

Mục tiêu

Bạn chuẩn bị một bản nháp chiến dịch có thể kiểm tra và bàn giao cho người duyệt. Kết thúc playbook ở bản nháp; không tự bắt đầu chạy, kể cả khi nội dung đã lưu thành công.

Quyền cần

  • crm.read để đọc chiến dịch và nhóm khách.
  • campaigns.write để tạo, sửa và xem trước bản nháp.
  • accounts.read để kiểm tra tài khoản dự kiến sử dụng.

Các thao tác tạo và sửa chiến dịch yêu cầu vai trò phù hợp với Quản lý. Playbook chuẩn bị không cần campaigns.run; thiếu quyền chạy là một ranh giới hữu ích.

Profile setup công bố các công cụ chiến dịch thường dùng. Công cụ không có tên riêng được gọi bằng tools_run sau khi đọc schema.

Hỏi người trước khi

Hỏi mục tiêu, đối tượng, tài khoản gửi, nội dung được phép, điều kiện dừng và tiêu chí hoàn thành.

Xin đồng ý rõ ràng trước khi tạo dữ liệu chiến dịch. Phân biệt “soạn đề xuất trong hội thoại” với “lưu bản nháp trong workspace”. Nếu người chỉ yêu cầu tư vấn, không tạo bản nháp.

Kiểm trước

Gọi whoami. Kiểm tra quyền và tài khoản được cấp.

Đọc danh sách chiến dịch để tránh tạo trùng. Đọc tài khoản và nguồn khách liên quan; không tự mở rộng tập khách khi kết nối không nhìn thấy đủ dữ liệu.

Loại trừ không liên hệ theo chính sách. Đừng coi việc khách có trong danh sách là bằng chứng họ đã đồng ý nhận mọi nội dung.

Các bước

  1. Gọi campaigns_list — campaigns.list — để tìm chiến dịch liên quan.
  2. Gọi campaigns_get nếu đang sửa một chiến dịch có sẵn.
  3. Gọi accounts_list để đối chiếu tài khoản dự kiến.
  4. Đọc hợp đồng campaigns.create bằng tools_describe.
  5. Sau khi người đồng ý tạo bản nháp, gọi campaigns_create.
  6. Dùng tools_run với campaigns.update nếu cần cập nhật cấu hình.
  7. Gọi campaigns_save_graph — campaigns.save_graph — để lưu luồng nháp.
  8. Dùng tools_run với campaigns.preview để kiểm tra trước.
  9. Gọi campaigns_get để đọc lại dữ liệu đã lưu.
  10. Bàn giao bản tóm tắt và những điểm còn cần duyệt.

Kiểm sau

Báo lại ID chiến dịch, phần cấu hình đã lưu và các điểm còn thiếu. Xác nhận bản nháp không được bạn khởi chạy.

Nếu sửa chiến dịch đang có hoạt động, nêu rõ bạn đã thay đổi phần nháp nào; không mặc định thay đổi nháp đã trở thành phiên bản chạy.

Khi lỗi

Nếu đồ thị không hợp lệ, đọc lỗi và sửa đúng bước gây lỗi. Không xuất bản để “thử xem chạy được không”.

Nếu thiếu quyền, dừng và yêu cầu người có quyền xử lý. Nếu tập khách hoặc tài khoản không đúng yêu cầu, quay lại xin quyết định thay vì tự thay nguồn khác.

Điều kiện dừng

Dừng khi bản nháp đã được lưu và kiểm tra, khi chưa có đồng ý tạo dữ liệu, hoặc khi cần chuyển sang hành động có tác động ra ngoài.

Xem hướng dẫn chiến dịch và xác nhận thao tác.