Update documentation to reflect new integration features: README.md: - Add 'Integrazione NotebookLM + RAG' section after Overview - Update DocuMente component section with new endpoints - Add notebooklm_sync.py and notebooklm_indexer.py to architecture - Add integration API examples - Add link to docs/integration.md SKILL.md: - Add RAG Integration to Capabilities table - Update Autonomy Rules with new endpoints - Add RAG Integration section to Quick Reference - Add Sprint 2 changelog with integration features - Update Skill Version to 1.2.0 docs/integration.md (NEW): - Complete integration guide with architecture diagram - API reference for all sync and query endpoints - Usage examples and workflows - Best practices and troubleshooting - Performance considerations and limitations - Roadmap for future features All documentation now accurately reflects the unified NotebookLM + RAG agent capabilities.
Documentation
Benvenuto nella documentazione di NotebookLM Agent API.
Indice
- API Reference - Documentazione completa delle API (TODO)
- Examples - Esempi di utilizzo (TODO)
Panoramica
NotebookLM Agent API fornisce:
- REST API per gestire notebook, fonti, chat e generazione contenuti
- Webhook System per notifiche event-driven
- AI Skill per integrazione con agenti AI
Endpoint Principali
Notebook Management
POST /api/v1/notebooks- Creare notebookGET /api/v1/notebooks- Listare notebookGET /api/v1/notebooks/{id}- Ottenere notebookDELETE /api/v1/notebooks/{id}- Eliminare notebook
Source Management
POST /api/v1/notebooks/{id}/sources- Aggiungere fonteGET /api/v1/notebooks/{id}/sources- Listare fontiPOST /api/v1/notebooks/{id}/sources/research- Ricerca web
Content Generation
POST /api/v1/notebooks/{id}/generate/audio- Generare podcastPOST /api/v1/notebooks/{id}/generate/video- Generare videoPOST /api/v1/notebooks/{id}/generate/quiz- Generare quizPOST /api/v1/notebooks/{id}/generate/flashcards- Generare flashcard
Webhooks
POST /api/v1/webhooks- Registrare webhookGET /api/v1/webhooks- Listare webhookPOST /api/v1/webhooks/{id}/test- Testare webhook
Autenticazione
Tutte le richieste API richiedono header X-API-Key:
curl http://localhost:8000/api/v1/notebooks \
-H "X-API-Key: your-api-key"
Webhook Security
I webhook includono firma HMAC-SHA256 nell'header X-Webhook-Signature:
import hmac
import hashlib
signature = hmac.new(
secret.encode(),
payload.encode(),
hashlib.sha256
).hexdigest()
Risorse
- README - Panoramica progetto
- PRD - Requisiti prodotto
- SKILL.md - Skill per agenti AI
- CONTRIBUTING - Come contribuire