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 |
