REST API 피드백

이 API를 사용하여 최종 사용자로부터 Cortex Agent에 대한 피드백을 수집합니다.

Cortex Agent에 대한 피드백 수집

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

Cortex Agent 응답에 대한 피드백 이벤트를 생성합니다.

요청

경로 매개 변수

매개 변수

설명

database

(필수) 리소스가 속한 데이터베이스의 식별자입니다. /api/v2/databases GET 요청을 사용하여 사용 가능한 데이터베이스 목록을 가져올 수 있습니다.

schema

(필수) 리소스가 속한 스키마의 식별자입니다. /api/v2/databases/{database}/schemas GET 요청을 사용하여 지정된 데이터베이스에 대해 사용 가능한 스키마 목록을 가져올 수 있습니다.

name

(필수) 에이전트의 식별자입니다.

헤더 요청

헤더

설명

Authorization

(필수) 승인 토큰. 자세한 내용은 인증 섹션을 참조하십시오.

Content-Type

(필수) 애플리케이션/json

요청 본문

요청 본문에는 에이전트 응답에 대한 피드백 세부 정보가 포함됩니다.

필드

타입

설명

request_id

문자열

피드백과 연결된 요청 ID입니다.

positive

boolean

응답이 긍정적인지(true), 아니면 부정적인지(false) 나타냅니다.

feedback_message

문자열

자세한 피드백 메시지의 텍스트입니다.

categories

문자열 배열

피드백의 카테고리 목록입니다. 각 카테고리는 특정 피드백 카테고리를 나타내는 문자열입니다.

thread_id

정수

스레드의 ID입니다.

요청 본문의 예

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

응답

성공적인 응답은 확인 메시지를 반환합니다.

응답 헤더

헤더

설명

X-Snowflake-Request-ID

API 요청의 고유 ID입니다.

응답 본문

{
  "status": "Feedback submitted successfully"
}
Copy