Zum Hauptinhalt springen
connic

Superhuman Docs (Coda)

Von connic
Automatischer Sync

Halte Superhuman Docs und Tabellen für Agenten synchron

Superhuman Docs (Coda) verbindenSprich mit Sales
Publisher
Von connic
Synchronisiert
Seiten, Tabellen, Doc-Struktur
Einrichtung
Retrieval → Sources
Dokumentation
Retrieval-Docs

So funktioniert die Superhuman Docs (Coda) Source

Superhuman Docs, ehemals Coda, vereint Fließtext und strukturierte Tabellen. Die Quelle synchronisiert sowohl das Runbook als auch die Eskalationsmatrix mit dem connic-Retrieval.

Die Verbindung verwendet ein Superhuman Docs API Token und synchronisiert die ausgewählten Docs. Seiten werden in Text umgewandelt und Tabellenzeilen werden zu einzelnen Einträgen, wobei ihre Spaltenwerte erhalten bleiben. Dadurch kann ein Agent eine einzelne Zeile genauso präzise abrufen wie einen Absatz. Die Inhalte werden nach dem festgelegten Zeitplan aktualisiert.

Das wird synchronisiert

Seiten
Doc-Seiten und Unterseiten werden vor dem Chunking in bereinigten Text umgewandelt.
Tabellen
Jede Zeile wird zu einem eigenen Retrieval-Eintrag, wobei die Spaltenwerte erhalten bleiben.
Doc-Struktur
Die Seitenhierarchie bleibt in den Metadaten des Eintrags erhalten, damit das Retrieval später eingegrenzt werden kann.
Superhuman Docs (Coda)ActiveDocs
Configuration
Content scope
Include hidden pagesNo
Include tablesYes
Sync behavior
Target namespacesources.coda
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

Superhuman Docs (Coda) Source einrichten

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

  1. Öffne docs.superhuman.com/account und erstelle in den API Settings ein API Token.

  2. Kopiere das Token und füge es unten in das Feld API Token ein.

  3. Das Token kann nur Docs lesen, auf die der zugehörige Superhuman Docs Account bereits zugreifen kann. Optional lässt es sich auf Lesezugriff für die zu synchronisierenden Docs beschränken.

  4. Füge die Links der zu synchronisierenden Docs jeweils in eine eigene Zeile ein, z. B. https://docs.superhuman.com/d/Team-Handbook_d....

  5. Lass die Liste der Docs leer, um jedes Doc zu synchronisieren, das das Token lesen kann.

Konfiguration im Detail

Alle Einstellungen zum Verbinden von Superhuman Docs (Coda) mit einem Projekt.

Verbindung

API Token*
Die Synchronisierung verwendet ein Superhuman Docs API Token und liest nur Docs, auf die dieses Token zugreifen kann.

Inhaltsumfang

Dokumente
Links oder IDs aus Superhuman Docs, jeweils einer pro Zeile. Bestehende coda.io Links funktionieren ebenfalls. Lass das Feld leer, um jedes Doc zu synchronisieren, das das Token lesen kann.
Ausgeblendete Seiten einbeziehen
Synchronisiere auch Seiten, die in der Navigation des Docs ausgeblendet sind.
Tabellen einbeziehen
Synchronisiere Tabellenzeilen 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.coda.
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 Superhuman Docs gelöschte Seiten oder Zeilen 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_coda(question: str) -> dict:
    return await retrieval_query(
        question, namespace="sources.coda"
    )
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_coda returns.
tools:
  - knowledge.search_coda

Superhuman Docs (Coda) Retrieval Source FAQ

Die Quelle synchronisiert die Seiten und Tabellen der ausgewählten Docs. Seiten werden in Text umgewandelt und jede Tabellenzeile wird zu einem eigenen Retrieval-Eintrag, wobei die Spaltenwerte erhalten bleiben.

Ja. Zeilen werden als separate Einträge gespeichert. Eine semantische Abfrage nach einem Eskalationskontakt oder einer Preisregel kann dadurch genau die passende Zeile liefern.

Die Synchronisierung lässt sich in der Konfiguration auf bestimmte Doc-Links oder IDs begrenzen. Bleibt die Liste leer, wird jedes Doc synchron gehalten, das das API Token lesen kann.

Ja. Superhuman Docs akzeptiert weiterhin bestehende Coda API Tokens und coda.io Links. Bestehende Verbindungen müssen daher nicht neu erstellt werden.

Ja. Eine Quelle schreibt in genau einen Ziel-Namespace. Lege daher pro Doc eine eigene Quelle mit dem Link des Docs und einem eigenen Namespace an, z. B. handbook.sales und handbook.support. Eine Abfrage auf handbook durchsucht dann beide. Jeder Eintrag speichert außerdem die Doc-ID als doc_id in seinen Metadaten, sodass sich eine Quelle mit mehreren Docs weiterhin pro Doc filtern lässt.

Weitere Retrieval Sources

Zum Marketplace