Die Conversational Analytics API ist ein leistungsstarkes Tool, mit dem Sie Ihre Daten in natürlicher Sprache abfragen können. Auf dieser Seite finden Sie eine Anleitung zum Formulieren effektiver Fragen für eine ideale Ausgabe. Auf dieser Seite finden Sie Best Practices für die folgenden Aktionen:
- Allgemeine Fragen stellen
- Mehrteilige Fragen für komplexere Analysen stellen
- Fragen mit Datenbedingungen stellen
- Datenaggregation anfordern
- Weiterführende Fragen stellen
- Formatierte Ergebnisse anfordern
Allgemeine Fragen stellen
Wenn Sie allgemeine Fragen stellen, sollten Sie präzise sein und Kontext angeben. Statt grundlegende Fragen zu stellen, sollten Sie den Umfang eingrenzen, indem Sie relevante Details wie Datumsangaben, bestimmte Kategorien oder numerische Filter angeben.
Beispiel
Ursprüngliche Frage: „Wie viele Rechnungen werden jedes Jahr manuell und systematisch erstellt?“
Präzisierte Frage: „Gib die Anzahl der Rechnungen an, die jedes Jahr manuell und systematisch erstellt werden. Angenommen, es dauert 15 Minuten, um eine manuelle Rechnung zu erstellen. Berechne und fasse die Gesamtzeit in Stunden zusammen, die für die Bearbeitung aller manuellen Rechnungen benötigt wurde.“
Warum das funktioniert: Die präzisere Frage enthält eine spezifische Berechnungsanforderung (Zeitaufwand für manuelle Rechnungen) und gibt ein Ausgabeformat an, nämlich eine Zusammenfassung.
Mehrteilige Fragen für komplexere Analysen stellen
Teilen Sie komplexe Fragen in mehrere Teile auf, damit die Conversational Analytics API jede Komponente genau verarbeiten kann.
Beispiel
Ursprüngliche Frage: „Wie viele Tage dauert durchschnittlich die Bearbeitungszeit von Nachnahme und Payment Clearing für jede Forderungsart (PSA, Co-Op-Gelder, Kreditkarte, Retail Media), und welcher Prozentsatz davon ist manuelles Clearing? Angenommen, wir benötigen 15 Minuten für jedes manuelle Clearing. Wie viel Zeit verbringen wir dann jährlich mit der Cash-App und dem Clearing der einzelnen Forderungen?“
Präzisierte Frage, Teil 1: „Wie hoch ist die durchschnittliche Bearbeitungszeit in Tagen für die Forderungsart zwischen dem 05.05.2025 und dem 01.06.2025?“
Präzisierte Frage, Teil 2: „Wie viel Prozent der Clearings sind manuelle Clearings zwischen dem 05.05.2025 und dem 01.06.2025 für jeden Forderungstyp?“
Präzisierte Frage, Teil 3: „Angenommen, wir benötigen 15 Minuten für jedes manuelle Clearing. Wie viel Zeit verbringen wir dann jährlich mit der Cash-App und dem Clearing der einzelnen Forderungen?“
Warum das funktioniert: Wenn Sie die Fragen separat stellen, kann die Conversational Analytics API jeden spezifischen Messwert (durchschnittliche Bearbeitungszeit, Prozentsatz der manuellen Clearings, insgesamt aufgewendete Zeit) mit den entsprechenden Filtern berücksichtigen, um ein genaueres Ergebnis zu erhalten.
Fragen mit Datenbedingungen stellen
Wenn Sie Fragen mit Datenbedingungen stellen, geben Sie alle erforderlichen Filter und Bedingungen in Ihrer Frage an, einschließlich genauer Datumsangaben, Zahlenbeschränkungen und bestimmter Kategorien. Prüfen Sie, ob die Conversational Analytics API die richtigen Filter anwendet (z. B. Zeiträume, Top-N-Ergebnisse, bestimmte Kategorien).
Beispiele
In den folgenden Fragen werden Filterkriterien richtig angegeben:
„Zeige mir das Rechnungsdatum vom 02.05.2025 bis zum 03.06.2025 nur zusammen mit dem jeweiligen Durchschnittsalter der ausstehenden Rechnungen.“ In dieser Frage wird der Zeitraum klar angegeben.
„Gib für die Datensätze, die älter als 46 Tage sind, den Kundennamen, die Summe des ausstehenden Betrags, das Durchschnittsalter und den Forderungstyp an. Beschränke die Ergebnisse auf bis zu fünf Datensätze nach ausstehendem Betrag.“ Diese Frage gibt das Alter der Datensätze, eine Beschränkung und Sortieranforderungen an.
„Gib die wichtigsten Branchen nach Varianzbetrag bei den Kundenforderungssalden an, zusammen mit den Beträgen für 2025FP1 im Vergleich zum Ende des Vorjahres.“ In dieser Frage werden die „wichtigsten Branchen“ genannt und die Vergleichszeiträume angegeben.
Datenaggregation anfordern
Wenn Sie Fragen zum Aggregieren von Daten stellen, geben Sie den Aggregationstyp an (z. B. „Summe des ausstehenden Betrags“ oder „Durchschnittsalter“) und nennen Sie die Dimensionen, nach denen Sie aggregieren möchten (z. B. „Kundenname“, „Forderungstyp“ oder „Branche“).
Beispiel
Mit der folgenden Frage werden klare Anforderungen für die Datenaggregation effektiv festgelegt:
„Gib den Kundennamen, die Summe des ausstehenden Betrags, das Durchschnittsalter und den Forderungstyp für die Datensätze an, die älter als 46 Tage sind.“
Weiterführende Fragen stellen
Wenn Sie eine weiterführende Frage stellen, beziehen Sie sich auf den zuvor festgelegten Kontext, aber seien Sie explizit bei Änderungen oder Ergänzungen. Wenn Sie beispielsweise einen Zeitraum oder eine Beschränkung ändern möchten, geben Sie die neuen Parameter deutlich an.
Beispiele
Ursprüngliche Frage: „Gib für die Datensätze, die älter als 46 Tage sind, den Kundennamen, die Summe des ausstehenden Betrags, das Durchschnittsalter und den Forderungstyp an. Beschränke die Ergebnisse auf bis zu fünf Datensätze nach ausstehendem Betrag.“
Weiterführende Frage: „Gib die vorherigen Messwerte für Datensätze an, die älter als 90 Tage sind, und beschränke die Ausgabe auf die ersten 10 Datensätze.“
Warum das funktioniert: In der weiterführenden Frage werden die Änderungen am Filter „älter als“ und an der Beschränkung des Ergebnisses klar angegeben. Gleichzeitig wird zur Kontextualisierung auf dieselben Messwerte wie in der vorherigen Frage verwiesen.
Formatierte Ergebnisse anfordern
Wenn Sie eine Frage stellen, in der kein Ergebnisformat angegeben ist, bestimmt die Conversational Analytics API das Format, das am besten für die spezifischen Kriterien und die in der Frage angegebenen Schlüsselbegriffe geeignet ist.
Sie können die Conversational Analytics API anweisen, Ergebnisse in den folgenden Formaten zu liefern, indem Sie Schlüsselbegriffe in Ihre Frage aufnehmen:
Ergebnisse in einer Tabelle mit der Conversational Analytics API abrufen
Die folgende Frage impliziert, dass die Ergebnisse in Tabellenform zurückgegeben werden sollen, da sie Dimensions- und Messwertspaltennamen angibt:
„Gib den Kundennamen, die Summe des ausstehenden Betrags, das Durchschnittsalter und den Forderungstyp für die Datensätze an, die älter als 46 Tage sind.“
Ergebnisse als Text mit der Conversational Analytics API abrufen
Wenn Sie Schlüsselbegriffe wie „Zusammenfassung“ verwenden oder eine Frage stellen, die nur eine einfache Antwort erfordert, gibt die Conversational Analytics API Ergebnisse als Text zurück.
Bei den folgenden Fragen wird davon ausgegangen, dass die Ergebnisse als Text zurückgegeben werden:
„Berechne und fasse die Gesamtzeit in Stunden zusammen, die für die Bearbeitung aller manuellen Rechnungen benötigt wurde.“
„Wie viel Zeit wurde in der letzten Woche insgesamt für die Bearbeitung manueller Rechnungen benötigt?“
Ergebnisse als Liniendiagramm mit der Conversational Analytics API abrufen
Wenn Sie in einer Frage Schlüsselbegriffe wie „Trend“, „Änderung“ oder „Delta-Änderung“ verwenden, gibt die Conversational Analytics API die Ergebnisse als Liniendiagramm aus.
Bei den folgenden Fragen wird davon ausgegangen, dass die Ergebnisse als Liniendiagramm zurückgegeben werden sollen:
„Wie ist der monatliche Trend der Endsalden für jede Branche im Jahr 2024?“
„Wie hoch ist die tägliche Delta-Änderung des Durchschnittsalters ausstehender Rechnungen für den Tag im Vergleich zum Vortag zwischen dem 02.05.2025 und dem 03.06.2025?“
Ergebnisse als Balken- oder Vergleichsdiagramm mit der Conversational Analytics API abrufen
Wenn Sie Schlüsselbegriffe wie „vergleichen“ und „Varianz“ verwenden, gibt die Conversational Analytics API Ergebnisse als Balken- oder Vergleichsdiagramm zurück.
Bei den folgenden Fragen wird davon ausgegangen, dass die Ergebnisse als Balken- oder Vergleichsdiagramm zurückgegeben werden sollen:
„Gib die wichtigsten Branchen nach Varianzbetrag bei den Kundenforderungssalden an, zusammen mit den Beträgen für 2025FP1 im Vergleich zum Ende des Vorjahres.“
Die Ergebnisse für diese Frage werden als Balkendiagramm zurückgegeben, in dem die Varianz für jede Branche dargestellt ist.
Zusätzliche Ressourcen
Weitere Tipps zur Fehlerbehebung und Antworten auf häufig gestellte Fragen finden Sie auf der Seite Häufig gestellte Fragen zur Conversational Analytics API.
Weitere Informationen zu API-Fehlern und möglichen Lösungen finden Sie in der Übersicht Fehler bei der Conversational Analytics API beheben.