Zum Hauptinhalt springen
connic

Notion

Von connic
Automatischer Sync

Halte Notion-Seiten und -Datenbanken für Agenten synchron

Notion verbindenSprich mit Sales
Publisher
Von connic
Synchronisiert
Seiten, Datenbanken, Unterseiten
Einrichtung
Retrieval → Sources
Dokumentation
Retrieval-Docs

So funktioniert die Notion Source

Die meisten Teams dokumentieren in Notion, wie ihr Unternehmen arbeitet: Produktspezifikationen, Support-Runbooks, Onboarding-Leitfäden und Entscheidungsprotokolle. Die Notion-Quelle überträgt diese Inhalte automatisch in das connic-Retrieval, damit Agenten ihre Antworten auf dieselben Seiten stützen, die das jeweilige Team pflegt.

Eine interne Notion-Integration bestimmt die einzubeziehenden Seiten und Datenbanken; ein Zeitplan steuert die Synchronisierung. connic lädt die Inhalte, teilt sie in Chunks, erstellt Embeddings für die semantische Suche und legt sie unter dem konfigurierten Namespace ab. Ändert sich eine Seite in Notion, aktualisiert die nächste Synchronisierung ihre Chunks. Auch das Verhalten bei gelöschten Seiten ist konfigurierbar.

Das wird synchronisiert

Seiten
Vollständige Seiteninhalte einschließlich verschachtelter Blöcke werden vor dem Chunking in bereinigten Text umgewandelt.
Datenbanken
Jede Zeile wird zu einem eigenen Retrieval-Eintrag, wobei die Datenbankeigenschaften erhalten bleiben.
Unterseiten
Untergeordnete Seiten werden automatisch mit ihren übergeordneten Seiten übernommen, wenn die Synchronisierung von Unterseiten aktiviert ist.
NotionActiveWorkspace app
Configuration
Content scope
What to syncEverything shared with the integration
Include subpagesYes
Include databasesYes
Sync behavior
Target namespacesources.notion
Sync intervalDaily
When content is deleted at the sourceRemove it from the retrieval
Recent syncsSync now
  • Completed13 Oct, 09:00
    4 new · 11 updated · 1 removed
  • CompletedManual12 Oct, 21:00
    0 new · 2 updated · 0 removed
  • Completed12 Oct, 09:00
    0 new · 6 updated · 0 removed

Notion Source einrichten

Füge die Source unter Retrieval → Sources im Environment hinzu, in dem deine Agenten laufen. Jedes Environment hat eigene Sources.

  1. Erstelle unter notion.so/my-integrations eine interne Integration und wähle den zu synchronisierenden Workspace aus.

  2. Lass "Read content" aktiviert und kopiere das Integration Secret. Es beginnt mit ntn_. Die Synchronisierung benötigt nur Lesezugriff.

  3. Füge das Secret unten in das Feld Integration Secret ein.

  4. Öffne in Notion jede Seite oder Datenbank, rufe das Dreipunkt-Menü auf, wähle Connections und füge die Integration hinzu. Unterseiten werden automatisch übernommen.

  5. Füge für bestimmte Seiten unten ihre Links ein. Die ID ist der 32-stellige Code am Ende der URL.

Konfiguration im Detail

Alle Einstellungen zum Verbinden von Notion mit einem Projekt.

Verbindung

Integration Secret*
Das Secret gehört zur internen Notion-Integration. Die Integration sieht nur Seiten, die ausdrücklich mit ihr geteilt wurden.

Inhaltsumfang

Zu synchronisierende Inhalte
Synchronisiere alles, was die Integration sehen kann, oder beschränke die Synchronisierung auf bestimmte Seiten und Datenbanken.
Seiten und Datenbanken*
Links zu Notion-Seiten oder -Datenbanken, jeweils einer pro Zeile.
Unterseiten einbeziehen
Synchronisiere auch untergeordnete Seiten, die unter den ausgewählten Seiten verschachtelt sind.
Datenbanken einbeziehen
Synchronisiere Datenbankzeilen als einzelne Retrieval-Einträge.

Synchronisierungsverhalten

Wo synchronisierte Inhalte abgelegt werden und wie häufig sie aktualisiert werden.

Ziel-Namespace
Der Retrieval-Namespace legt fest, unter welchem Namen die synchronisierten Einträge abgelegt werden. Verwende Punkte für Verschachtelungen, z. B. sources.notion.
Synchronisierungsintervall
Wie häufig die Quelle auf Änderungen geprüft wird. Bei jedem Lauf werden nur geänderte Inhalte erneut verarbeitet.
Wenn Inhalte an der Quelle gelöscht werden
In Notion entfernte oder nicht mehr freigegebene Seiten können bei der nächsten Synchronisierung aus dem Retrieval entfernt oder in der zuletzt synchronisierten Version beibehalten werden.

Aus einem Agenten durchsuchen

Agenten durchsuchen synchronisierte Inhalte mit dem Tool retrieval_query. Ein kleines Tool, das den Namespace festlegt, beschränkt einen Agenten auf diese Source.

tools/knowledge.py
from connic.tools import retrieval_query


async def search_notion(question: str) -> dict:
    return await retrieval_query(
        question, namespace="sources.notion"
    )
agents/support-agent.yaml
version: "1.0"

name: support-agent
type: llm
model: connic/gemini-3.7-flash
system_prompt: |
  Answer only from what search_notion returns.
tools:
  - knowledge.search_notion

Notion Retrieval Source FAQ

Die Quelle synchronisiert die mit der Notion-Integration geteilten Seiten und Datenbanken. Seiteninhalte werden in bereinigten Text umgewandelt, Datenbankzeilen werden zu einzelnen Retrieval-Einträgen und untergeordnete Seiten unter ausgewählten Seiten können automatisch übernommen werden.

Nein. Interne Notion-Integrationen sehen nur Seiten, die ausdrücklich mit ihnen geteilt wurden. connic kann keine Seite lesen, die nicht mit der Integration geteilt wurde.

Der Zeitplan lässt sich auf alle 15 Minuten, stündlich, alle 6 Stunden, täglich oder wöchentlich festlegen. Bei jedem Lauf werden nur Seiten erneut verarbeitet, die sich seit der letzten Synchronisierung geändert haben.

Das Verhalten ist konfigurierbar. Standardmäßig werden die zugehörigen Einträge bei der nächsten Synchronisierung aus dem Retrieval entfernt; alternativ bleibt die zuletzt synchronisierte Version als Archiv erhalten.

Weitere Retrieval Sources

Zum Marketplace