Feedback-REST-API¶

Verwenden Sie diese API, um Feedback zu Cortex Agents von Endbenutzern zu sammeln.

Feedback zu einem Cortex Agent sammeln¶

POST /api/v2/databases/{database}/schemas/{schema}/agents/{name}:feedback

Erstellt ein Feedback-Ereignis für eine Antwort des Cortex Agent.

Parameter	Beschreibung
`database`	(Erforderlich) Bezeichner für die Datenbank, zu der die Ressource gehört. Sie können die GET-Anforderung „/api/v2/databases“ verwenden, um eine Liste der verfügbaren Datenbanken zu erhalten.
`schema`	(Erforderlich) Bezeichner für das Schema, zu dem die Ressource gehört. Sie können die GET-Anforderung „/api/v2/databases/{Datenbank}/schemas“ verwenden, um eine Liste der verfügbaren Schemas für die angegebene Datenbank zu erhalten.
`name`	(Erforderlich) Bezeichner für den Agenten.

Header	Beschreibung
`Authorization`	(Erforderliche) Autorisierungstoken. Weitere Informationen dazu finden Sie unter Authentifizierung.
`Content-Type`	(Erforderlich) Anwendung/json

Der Anforderungstext enthält die Feedbackdetails für die Antwort des Agenten.

Feld	Typ	Beschreibung
`request_id`	string	ID der Anforderung, die mit dem Feedback verbunden ist.
`positive`	boolean	Gibt an, ob die Antwort gut (`true`) oder schlecht (`false`) war.
`feedback_message`	string	Der Text für die ausführliche Feedbacknachricht.
`categories`	Ein Array von Zeichenfolgen.	Liste der Kategorien für das Feedback. Jede Kategorie ist eine Zeichenfolge, die eine bestimmte Kategorie von Feedback darstellt.
`thread_id`	Ganzzahl	Die ID des Threads.

{
  "categories": [
    "Something worked well"
  ],
  "feedback_message": "this is fantastic!",
  "positive": true
}

Copy

Eine erfolgreiche Antwort gibt eine Bestätigungsmeldung zurück.

Header	Beschreibung
`X-Snowflake-Request-ID`	Eindeutige ID der API-Anforderung

{
  "status": "Feedback submitted successfully"
}

Copy