Method: instances.createFeedback

Full name: projects.locations.instances.createFeedback

RPC to submit user feedback on content generated by AI services.

HTTP request


Path parameters

Parameters
instance

string

Required. The Chronicle instance associated with the request. Format: projects/{project}/locations/{location}/instances/{instance}

Request body

The request body contains data with the following structure:

JSON representation 
{
  "type": enum (FeedbackType),
  "comment": string,

  // Union field metadata can be only one of the following:
  "udmQueryFeedback": {
    object (UdmQueryFeedback)
  },
  "ylRuleFeedback": {
    object (YLRuleFeedback)
  }
  // End of list of possible types for union field metadata.
}
Fields
type

enum (FeedbackType)

Optional. Feedback type.
comment

string

Optional. Feedback comment.
Union field metadata. The feedback metadata associated with the user feedback. metadata can be only one of the following:
udmQueryFeedback

object (UdmQueryFeedback)

Feedback metadata for UDM query translation.
ylRuleFeedback

object (YLRuleFeedback)

Feedback metadata for Yara-L rule translation.

Response body

Response message for instances.createFeedback.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "feedbackId": string
}
Fields
feedbackId

string

Unique ID for this translation. Currently only used for audit logging purpose only.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the instance resource:

  • chronicle.ais.createFeedback

For more information, see the IAM documentation.

UdmQueryFeedback

UdmQueryFeedback contains metadata for the feedback submitted on UDM query translation.

JSON representation 
{
  "originalInputText": string,
  "originalOutputQuery": string,
  "rewrittenQuery": string
}
Fields
originalInputText

string

Required. The original natural language text used for the translation.
originalOutputQuery

string

Optional. Original UDM query returned by the translation.
rewrittenQuery

string

Optional. Rewritten UDM query (if modified).

YLRuleFeedback

YLRuleFeedback contains metadata for the feedback submitted on Yara-L rule translation.

JSON representation 
{
  "originalInputDescription": string,
  "originalInputQuery": string,
  "originalOutputRule": string,
  "rewrittenRule": string
}
Fields
originalInputDescription

string

Required. The original natural language description used for the translation.
originalInputQuery

string

Optional. The original UDM query used for the rule generation.
originalOutputRule

string

Optional. Original Yara-L rule returned by the translation.
rewrittenRule

string

Optional. Rewritten Yara-L rule text (if modified).

FeedbackType

Feedback types.

Enums
FEEDBACK_TYPE_UNKNOWN Unknown feedback.
POSITIVE Positive feedback.
NEGATIVE Negative feedback.
REWRITE Negative feedback with a rewritten answer.
DISCARD Indicates a generated response was discarded.