# Playbook cho Agent AI

Source: https://wiki.tudongsale.com/agent-ai/playbook

Cập nhật: 2026-10-04

> Playbook là chuỗi lệnh cho một việc hay gặp, ví dụ kiểm tra tài khoản trước khi tìm khách hay xem khách tiềm năng mới. Agent AI lấy được cùng nội dung qua MCP `prompts/list` và `prompts/get`.

Trang này sinh từ mã nguồn, không sửa tay.

## Kiểm tra trước khi tìm khách {#check_before_finding_customers data-h2-exempt}

Xem tài khoản đã sẵn sàng chưa và các chủ đề đang tìm khách chạy thế nào. Tên playbook: `check_before_finding_customers`.

1. Gọi [`get_readiness`](/agent-ai/tham-chieu-tool#get_readiness): Xem máy nào đang nhận việc, còn lượt đăng không, hạn mức gói còn bao nhiêu.
2. Gọi [`list_topics`](/agent-ai/tham-chieu-tool#list_topics): Xem các chủ đề và số khách 7 ngày qua.
3. Gọi [`get_harvest_live`](/agent-ai/tham-chieu-tool#get_harvest_live): Xem chủ đề nào đang thu thập và lượt kế tiếp.

## Bắt đầu tìm khách cho một nhu cầu mới {#start_finding_customers data-h2-exempt}

Tạo chủ đề, gắn nhóm Facebook làm nguồn rồi cho máy bắt đầu thu thập. Tên playbook: `start_finding_customers`.

1. Gọi [`create_topic`](/agent-ai/tham-chieu-tool#create_topic): Tạo chủ đề với tên, mô tả nhóm phù hợp và tiêu chí lọc bài `scoringCriteria`.
2. Gọi [`attach_sources`](/agent-ai/tham-chieu-tool#attach_sources): Gắn các nhóm Facebook (mỗi dòng một UID hoặc link nhóm).
3. Gọi [`start_harvest`](/agent-ai/tham-chieu-tool#start_harvest): Bật lịch thu thập tự động. Nhận PLAN_LIMIT thì không thử chu kỳ khác, chuyển sang harvest_now.
4. Gọi [`harvest_now`](/agent-ai/tham-chieu-tool#harvest_now): Chạy ngay một lượt thu thập khi gói không có lịch tự động.
5. Gọi [`get_harvest_live`](/agent-ai/tham-chieu-tool#get_harvest_live): Theo dõi lượt thu thập đang chạy.

Bật tự bình luận hoặc tự nhắn tin cho chủ đề: chỉ người dùng tự bật trong ứng dụng.

## Xem khách tiềm năng mới {#review_new_leads data-h2-exempt}

Tìm khách tiềm năng mới và việc đang chờ người dùng. Tên playbook: `review_new_leads`.

1. Gọi [`get_attention`](/agent-ai/tham-chieu-tool#get_attention): Xem hội thoại chờ trả lời và lịch liên hệ lại quá hạn.
2. Gọi [`list_leads`](/agent-ai/tham-chieu-tool#list_leads): Lấy khách tiềm năng mới, lọc `status: new` hoặc theo `since`.
3. Gọi [`get_lead`](/agent-ai/tham-chieu-tool#get_lead): Mở một khách để xem liên hệ và nội dung nguồn.
4. Gọi [`update_lead`](/agent-ai/tham-chieu-tool#update_lead): Cập nhật trạng thái CRM, liên hệ hoặc nhãn theo yêu cầu của người dùng.
5. Gọi [`add_lead_note`](/agent-ai/tham-chieu-tool#add_lead_note): Ghi lại ghi chú hoặc cuộc gọi với khách.

## Theo dõi bình luận một bài {#follow_post_comments data-h2-exempt}

Xem các bài đang được theo dõi để đọc bình luận mới. Tên playbook: `follow_post_comments`.

1. Gọi [`list_topics`](/agent-ai/tham-chieu-tool#list_topics): Chọn chủ đề chứa bài cần theo dõi.
2. Gọi [`track_post_link`](/agent-ai/tham-chieu-tool#track_post_link): Thêm link bài cần theo dõi bình luận.
3. Gọi [`list_tracked_posts`](/agent-ai/tham-chieu-tool#list_tracked_posts): Xem bài nào đang theo dõi và lần đọc bình luận gần nhất.

## Xem AI đang khớp bài thế nào {#review_ai_matching data-h2-exempt}

Đối chiếu bài AI cho là khớp với tiêu chí của chủ đề. Tên playbook: `review_ai_matching`.

1. Gọi [`list_matches`](/agent-ai/tham-chieu-tool#list_matches): Lấy bài khớp gần đây kèm điểm và lý do.
2. Gọi [`get_topic`](/agent-ai/tham-chieu-tool#get_topic): Đối chiếu với mô tả và số liệu của chủ đề.
3. Gọi [`give_match_feedback`](/agent-ai/tham-chieu-tool#give_match_feedback): Đánh dấu kết quả AI lọc bài đúng hay sai để AI học lại.
4. Gọi [`update_topic`](/agent-ai/tham-chieu-tool#update_topic): Chỉnh tiêu chí lọc bài khi AI khớp sai nhiều.

## Xem chiến dịch chờ duyệt {#review_campaign_drafts data-h2-exempt}

Tìm bản nháp chiến dịch và tiến độ các chiến dịch đang chạy. Tên playbook: `review_campaign_drafts`.

1. Gọi [`get_readiness`](/agent-ai/tham-chieu-tool#get_readiness): Xem tài khoản nào chạy được chiến dịch.
2. Gọi [`list_campaigns`](/agent-ai/tham-chieu-tool#list_campaigns): Lấy chiến dịch, lọc `state: DRAFT` để thấy bản nháp.
3. Gọi [`get_campaign`](/agent-ai/tham-chieu-tool#get_campaign): Xem từng mục tiêu của một chiến dịch.

Chỉ người dùng mới bấm Bắt đầu một chiến dịch — Agent AI không tự chạy chiến dịch.