Source Influence

curl -X POST https://api.querying.ai/v1/source-influence \
  -H "Authorization: Bearer $QUERYING_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "answer": "…the AI answer, as raw markdown…",
    "prompt": "best password manager for a small team",
    "engine": "CHATGPT",
    "brand": "1Password",
    "competitors": ["Bitwarden"],
    "citations": [
      { "url": "https://example.com/best-password-managers", "body": "…the page markdown…" },
      { "url": "https://another.example.com/pricing" }
    ]
  }'

​

Einen bereits ausgeführten Task analysieren

curl -X POST https://api.querying.ai/v1/source-influence \
  -H "Authorization: Bearer $QUERYING_API_KEY" -H "Content-Type: application/json" \
  -d '{ "taskId": "7c1f…", "brand": "1Password", "competitors": ["Bitwarden"] }'

​

Payload

​

Ergebnis

{
  "answer": "Teams plan starts at $19.95 per month for up to 10 users. The Business plan adds audit logs.",
  "sources": [
    {
      "id": "s1",
      "url": "https://example.com/pricing",
      "paragraphs": [
        { "id": "p1", "text": "Teams: $19.95 / month, up to 10 users." },
        { "id": "p2", "text": "Business adds audit logs and SSO." }
      ]
    },
    {
      "id": "s2",
      "url": "https://review.example.com/note",
      "paragraphs": [],
      "error": "…"
    }
  ],
  "links": [
    { "id": "l1", "paragraphId": "p1", "answerRanges": [{ "start": 0, "end": 57 }], "explanation": "States the same price and seat cap." },
    { "id": "l2", "paragraphId": "p2", "answerRanges": [{ "start": 58, "end": 92 }], "explanation": "Names the audit-log add-on." }
  ],
  "insights": [
    { "summary": "The pricing page covers both statements; the review page could not be read.", "linkIds": ["l1", "l2"] }
  ]
}

​

answer

​

sources[]: ein Eintrag pro gesendeter Quelle

• id: undurchsichtige Kennung, eindeutig im Ergebnis.
• url: die von Ihnen angegebene Quell-URL.
• paragraphs[]: die im Ergebnis enthaltenen Absätze dieser Seite. Jeder hat eine id (im gesamten Ergebnis eindeutig) und den text des Absatzes. Ein Absatz kann auch ohne Verknüpfung enthalten sein.
• error: nur vorhanden, wenn die Seite nicht gelesen werden konnte. paragraphs ist dann leer, und der String nennt kurz den Grund für diese Quelle.

​

links[]: eine Beziehung pro Absatz

• paragraphId: der Absatz, um den es in dieser Verknüpfung geht. Er zeigt immer auf einen Absatz, der in sources[] existiert.
• answerRanges[]: die Teile der Antwort, denen dieser Absatz entspricht, als start/end-Paare in denselben UTF-16-Offsets. Eine Verknüpfung kann mehrere Bereiche haben; derselbe Antworttext wiederholt sich nicht zwischen ihnen. Jeder Bereich ist eine vollständige Antworteinheit (Satz, Listenpunkt oder Tabellenzelle).
• explanation: ein kurzer Satz, der die Entsprechung beschreibt, also was der Absatz über diesen Teil der Antwort aussagt.

​

insights[]

​

Das Ergebnis richtig lesen

• Keine Verknüpfung ist kein Urteil. Ein Absatz ohne Verknüpfung hat schlicht keinem Antwortbereich entsprochen, und ein Antwortteil ohne Bereich bedeutet, dass kein Absatz mit ihm verknüpft wurde. Beides besagt nicht, dass die Seite irrelevant, ungenutzt oder unzuverlässig ist.
• Eine ungelesene Seite bleibt ungewiss. Ist sources[].error gesetzt, wurde diese Quelle von der Analyse ausgeschlossen; werten Sie fehlende Verknüpfungen nicht als negatives Ergebnis. Versuchen Sie es erneut oder liefern Sie ihren body, wenn sie wichtig ist.
• Entsprechung, nicht Kausalität. Das Ergebnis beschreibt, wie eine vorhandene Antwort und ein vorhandener Seitentext nachträglich zusammenpassen. Es misst keinen Einfluss auf die Generierung, ordnet Seiten nicht gegeneinander, bewertet die Seite nicht und sagt nicht, wie die Antwort entstanden ist.
• Ids sind intern. Speichern Sie p…/l…-Kennungen nicht als stabile Schlüssel über Läufe hinweg; sie gelten nur innerhalb eines Ergebnisses.

​

Ausführung und Grenzen

• Größe ist kein Fehlergrund. Alles, was der Anfragevertrag akzeptiert, also eine answer mit bis zu 200.000 Zeichen und bis zu 100 Quellen, wird analysiert. Lange Antworten, große Quellsätze und sehr lange Seiten werden durch Aufteilen der Arbeit bewältigt, nicht durch Ablehnen des Tasks.
• Die Tiefe richtet sich nach der Antwort, nicht nach der Seite. Eine lange Seite erzeugt nicht mehr Verknüpfungen, als die Antwort tragen kann: Die Analyse konzentriert sich auf die Passagen, die der Antwort am wahrscheinlichsten entsprechen, und jede Quelle mit einer Entsprechung ist vertreten. Bei einer großen Seite oder einer, die dieselbe Aussage in Navigation, Listen und Bewertungen wiederholt, erhalten Sie die stärksten Passagen statt jedes Vorkommens.
• Markup ist kein Beleg. Sitemaps, Linkverzeichnisse und Bildergalerien liefern keine Verknüpfungen; eine Seite, die nur daraus besteht, wird ohne Absätze gemeldet statt mit erfundenen Entsprechungen.
• Eine nicht lesbare Quelle wird in sources[].error gemeldet, ohne den Task scheitern zu lassen, wenn eine andere Quelle lesbar ist. Der Task scheitert, wenn keine Quelle gelesen werden konnte, bei einem Analysefehler, einem Timeout oder einem Konfigurationsfehler des Dienstes.
• Anfragen werden wie der Rest der API nach Nutzung abgerechnet. Die Antwort beim Einreichen zeigt die vorläufige Credit-Reservierung; die endgültige Belastung wird verrechnet, wenn der Task einen Endzustand erreicht.