Abrufen der Liste des Agenten-Gesprächspunktverbrauchs

Abrufen der Liste des Agenten-Gesprächspunktverbrauchs

Über diese Schnittstelle können die Details des Gesprächspunktverbrauchs eines bestimmten Agenten innerhalb eines bestimmten Zeitraums abgerufen werden, zusammengefasst nach conversationId, mit maximalen Daten von bis zu 30 Tagen.

Anfragemethode

GET

Aufrufadresse

https://api.gptbots.ai/v1/account/agent/conversation/credits

Authentifizierung

Details siehe die Authentifizierungsmethode in API-Übersicht.

Aufrufhäufigkeit

Diese Schnittstelle wird auf das Minutenkontingent der „Statistik-APIs“ des Organisationsplans angerechnet und teilt das Kontingent mit anderen Statistik-APIs (einschließlich organisationsweiter Statistik-APIs). Bei Überschreitung wird 40008 zurückgegeben.

Anfrage

Anfragebeispiel

curl -X GET 'https://api.gptbots.ai/v1/account/agent/conversation/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \ -H 'Authorization: Bearer your_apikey'
                      
                      curl -X GET 'https://api.gptbots.ai/v1/account/agent/conversation/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \
  -H 'Authorization: Bearer your_apikey'

                    
Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld Typ Beschreibung
Authorization Bearer ${token} Verwendung von Authorization: Bearer ${token} zur Aufrufauthentifizierung. Bitte beziehen Sie das Token auf der API-Schlüssel-Seite.

Anfrageparameter

Feld Typ Pflicht Beschreibung
start_time long Ja Abfrage-Startzeit, Zeitstempel in Millisekunden.
end_time long Ja Abfrage-Endzeit, Zeitstempel in Millisekunden. Der Abstand zwischen start_time und end_time darf 30 Tage nicht überschreiten.
page int Nein Seitenzahl, Standardwert ist 1.
page_size int Nein Anzahl der Einträge pro Seite, Standardwert ist 20, maximal 100.
conversation_id string Nein Gesprächs-ID.

Antwort

Antwortbeispiel

{ "list": [ { "conversation_id": "6830a1f2e4b0f1a2b3c4d5e6", "conversation_create_time": 1774838000000, "chat": 1.50, "anonymization": 0, "asr": 0, "tts": 0, "rerank": 0.30, "database_processing": 0, "tool_call": 0.20, "knowledge_doc_indexing": 0, "question_tag": 0, "moderation": 0.01, "total": 2.0 } ], "total": 1, "page": 1, "page_size": 20, "start_time": 1774837924000, "end_time": 1775183447000 }
                      
                      {
    "list": [
        {
            "conversation_id": "6830a1f2e4b0f1a2b3c4d5e6",
            "conversation_create_time": 1774838000000,
            "chat": 1.50,
            "anonymization": 0,
            "asr": 0,
            "tts": 0,
            "rerank": 0.30,
            "database_processing": 0,
            "tool_call": 0.20,
            "knowledge_doc_indexing": 0,
            "question_tag": 0,
            "moderation": 0.01,
            "total": 2.0
        }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "start_time": 1774837924000,
    "end_time": 1775183447000
}

                    
Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld Typ Beschreibung
list List Liste der Details zum Punkteverbrauch.
conversation_id string Sitzungs-ID.
conversation_create_time long Erstellungszeit der Sitzung (Zeitstempel in Millisekunden), null, wenn die Sitzungsaufzeichnung gelöscht wurde.
chat decimal Punkteverbrauch für das Gespräch (LLM-Chat).
anonymization decimal Punkteverbrauch für Anonymisierung.
asr decimal Punkteverbrauch für Spracherkennung (ASR).
tts decimal Punkteverbrauch für Text-zu-Sprache (TTS).
rerank decimal Punkteverbrauch für Vektor-Reranking.
database_processing decimal Punkteverbrauch für Datenbankverarbeitung.
tool_call decimal Punkteverbrauch für Werkzeugaufrufe.
knowledge_doc_indexing decimal Punkteverbrauch für Wissensdatenbank-Indexierung.
question_tag decimal Punkteverbrauch für Fragenkennzeichnung.
moderation decimal Punkteverbrauch für Inhaltsprüfung.
total decimal Gesamter Punkteverbrauch für diese Sitzung.
total long Gesamtzahl der zutreffenden Sitzungen (für Paging).
page int Aktuelle Seitenzahl.
page_size int Anzahl der Einträge pro Seite.
start_time long Abfrage Beginnzeit.
end_time long Abfrage Endzeit.

Fehlgeschlagene Antwort

Feld Typ Beschreibung
code int Fehlercode.
message string Fehlerinformationsbeschreibung.

Fehlercodes

Code Nachricht
40000 Parameterfehler
40001 Ungültiger Zeitraum (mehr als 30 Tage)
50000 Interner Systemfehler