NotebookLM Step by Step

Đây là lane chuyên biệt cho NotebookLM, không phải file onboarding chung. Nếu bạn chỉ cần dùng repo docs hoặc đóng góp nội dung bình thường, bắt đầu từ QUICK_GUIDES.md hoặc START_HERE.md trước.

Mục tiêu: cho team một entrypoint gọn để setup, chạy, và review artifact từ NotebookLM mà không phải đi tìm nhiều file.

Khi nào dùng

• Dùng NotebookLM khi notebook đã có source sẵn và bạn cần tạo artifact như report, slide-deck, infographic, video.
• Không dùng NotebookLM để thay thế lane kb:ingest.
• Nếu cần mirror Google Docs/Sheets vào repo, dùng docs/Shared/Operations/Knowledge/NB_Ops_Knowledge_Ingestion_Workflow.md.

Đọc theo thứ tự

1. File này để nắm flow nhanh.
2. COMMANDS.md nếu cần full command surface.
3. docs/Shared/Operations/Knowledge/NB_Ops_NotebookLM_Integration_Workflow.md nếu cần debug setup.
4. docs/Shared/Operations/Knowledge/NB_Ops_NotebookLM_Artifact_Runbook.md nếu cần recipe chi tiết theo artifact.

Setup một lần

1. Cài CLI đúng version:

pip install "notebooklm-py[browser]==0.3.3"
playwright install chromium

2. Tạo local config:

npm run kb:nb:init

3. Login:

npm run kb:nb:login

4. Điền NOTEBOOK_ID vào config/notebooklm/jobs.local.json.
5. Preflight:

npm run kb:nb:doctor
npm run kb:nb:batch:dry

Daily loop

1. Kiểm tra profile và config:

npm run kb:nb:doctor

2. Xem notebook đang có:

npm run kb:nb:list

3. Chạy artifact cần dùng:

node scripts/notebooklm-batch.mjs --config config/notebooklm/jobs.local.json --only generate-slide-deck,download-slide-deck

4. Review output trong docs/tmp/notebooklm/.
5. Chỉ promote nội dung đã được review sang docs canonical.

Command tối thiểu

npm run kb:nb:init
npm run kb:nb:doctor
npm run kb:nb:login
npm run kb:nb:list
npm run kb:nb:batch:dry
npm run kb:nb:batch

Artifact nhanh

node scripts/notebooklm-batch.mjs --config config/notebooklm/jobs.local.json --only generate-study-guide,download-study-guide
node scripts/notebooklm-batch.mjs --config config/notebooklm/jobs.local.json --only generate-slide-deck,download-slide-deck
node scripts/notebooklm-batch.mjs --config config/notebooklm/jobs.local.json --only generate-infographic,download-infographic
node scripts/notebooklm-batch.mjs --config config/notebooklm/jobs.local.json --only generate-video,download-video

File ownership

• Sửa tay:
  • config/notebooklm/jobs.local.json
• Không commit:
  • config/notebooklm/*.local.json
  • .cache/notebooklm/**
  • artifact trong docs/tmp/notebooklm/ nếu chỉ để review tạm
• Review output:
  • docs/tmp/notebooklm/

Hard gates

• kb:nb:doctor phải pass trước khi chạy batch thật.
• Ưu tiên --only để rerun step lỗi thay vì rerun toàn bộ.
• Artifact AI không phải source of truth.
• Nếu command thay đổi, cập nhật COMMANDS.md, file này, và runbook liên quan trong cùng một thay đổi.

Nếu bị kẹt

• Setup/auth: docs/Shared/Operations/Knowledge/NB_Ops_NotebookLM_Integration_Workflow.md
• Artifact recipe và troubleshooting: docs/Shared/Operations/Knowledge/NB_Ops_NotebookLM_Artifact_Runbook.md
• Ingest và mirror nguồn: docs/Shared/Operations/Knowledge/NB_Ops_Knowledge_Ingestion_Workflow.md
• AI guardrails: .agent/rules/rule-knowledge-ops-notebooklm.md