Feedback zu Agentenantworten

Ermöglicht Nutzer:innen, Feedback zu Antworten von Agent:innen zu geben, um Entwickler:innen bei der Optimierung der Performance zu unterstützen.

Anfragemethode

POST

Anfrage-URL

https://api-${endpoint}.gptbots.ai/v1/message/feedback

Authentifizierung der Anfrage

Siehe API-Übersicht für Authentifizierungsanweisungen.

Anfrage

Beispielanfrage

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/message/feedback' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "answer_id": "123456789", "feedback": "POSITIVE" }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/message/feedback' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
        "answer_id": "123456789",
        "feedback": "POSITIVE"
}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie Authorization: Bearer ${API Key} zur Authentifizierung. Den API-Schlüssel erhalten Sie auf der API-Key-Seite.
Content-Type	application/json	Datentyp, auf application/json setzen.

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
answer_id	string	Ja	Antwort-ID der Agent:innen-Antwort.
feedback	string	Ja	Feedback zur Agent:innen-Antwort. - POSITIVE: Positiv, Gefällt mir, Daumen hoch, Zustimmung - NEGATIVE: Negativ, Gefällt mir nicht, Daumen runter, Ablehnung - CANCELED: Feedback zurückziehen

Antwort

Beispielantwort

{ "affectCount": 1 }

                      
                      {
    "affectCount": 1
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
affectCount	long	Anzahl der erfolgreich verarbeiteten Feedbacks. Bei erfolgreicher Verarbeitung beträgt der Wert 1.

Fehlermeldung

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Details zur Fehlermeldung.

Fehlercodes

Code	Meldung
40000	Ungültiger Parameter
40127	Entwickler:innen-Authentifizierung fehlgeschlagen
20059	Agent:in gelöscht