--- title: "Chuẩn bị bản nháp chiến dịch" locale: vi url: https://tlg.builera.app/docs/agent-playbooks/prepare-campaign verified: 2026-10-24 app_version: "2.0" --- # 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 1. Gọi `campaigns_list` — [`campaigns.list`](https://tlg.builera.app/docs/reference/rest/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`](https://tlg.builera.app/docs/reference/rest/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`](https://tlg.builera.app/docs/reference/rest/campaigns.update) nếu cần cập nhật cấu hình. 7. Gọi `campaigns_save_graph` — [`campaigns.save_graph`](https://tlg.builera.app/docs/reference/rest/campaigns.save_graph) — để lưu luồng nháp. 8. Dùng `tools_run` với [`campaigns.preview`](https://tlg.builera.app/docs/reference/rest/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. > [!IMPORTANT] > Điểm dừng — hỏi người > > Không gọi `campaigns_publish`, `campaigns_start` hoặc thao tác gửi thử chỉ vì bản xem trước hợp lệ. Xin người duyệt rõ nội dung, đối tượng và tài khoản trước khi chuyển sang xuất bản hoặc chạy. ## 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](https://tlg.builera.app/docs/guides/campaigns) và [xác nhận thao tác](https://tlg.builera.app/docs/concepts/confirmations).