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.
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
- Gọi
campaigns_list—campaigns.list— để tìm chiến dịch liên quan. - Gọi
campaigns_getnếu đang sửa một chiến dịch có sẵn. - Gọi
accounts_listđể đối chiếu tài khoản dự kiến. - Đọc hợp đồng
campaigns.createbằngtools_describe. - Sau khi người đồng ý tạo bản nháp, gọi
campaigns_create. - Dùng
tools_runvớicampaigns.updatenếu cần cập nhật cấu hình. - Gọi
campaigns_save_graph—campaigns.save_graph— để lưu luồng nháp. - Dùng
tools_runvớicampaigns.previewđể kiểm tra trước. - Gọi
campaigns_getđể đọc lại dữ liệu đã lưu. - 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.