Files
documente/docs
Luca Sacchi Ricciardi 568489cae4
Some checks failed
CI / test (3.10) (push) Has been cancelled
CI / test (3.11) (push) Has been cancelled
CI / test (3.12) (push) Has been cancelled
CI / lint (push) Has been cancelled
docs: comprehensive documentation for NotebookLM-RAG integration
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.
2026-04-06 18:01:50 +02:00
..

Documentation

Benvenuto nella documentazione di NotebookLM Agent API.

Indice

Panoramica

NotebookLM Agent API fornisce:

  1. REST API per gestire notebook, fonti, chat e generazione contenuti
  2. Webhook System per notifiche event-driven
  3. AI Skill per integrazione con agenti AI

Endpoint Principali

Notebook Management

  • POST /api/v1/notebooks - Creare notebook
  • GET /api/v1/notebooks - Listare notebook
  • GET /api/v1/notebooks/{id} - Ottenere notebook
  • DELETE /api/v1/notebooks/{id} - Eliminare notebook

Source Management

  • POST /api/v1/notebooks/{id}/sources - Aggiungere fonte
  • GET /api/v1/notebooks/{id}/sources - Listare fonti
  • POST /api/v1/notebooks/{id}/sources/research - Ricerca web

Content Generation

  • POST /api/v1/notebooks/{id}/generate/audio - Generare podcast
  • POST /api/v1/notebooks/{id}/generate/video - Generare video
  • POST /api/v1/notebooks/{id}/generate/quiz - Generare quiz
  • POST /api/v1/notebooks/{id}/generate/flashcards - Generare flashcard

Webhooks

  • POST /api/v1/webhooks - Registrare webhook
  • GET /api/v1/webhooks - Listare webhook
  • POST /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