- Resource: Message
- MessageInput
- Action
- FollowUp
- Navigation
- ActionType
- Context
- MessageResponse
- ResponseBlock
- BlockType
- MessageFeedback
- FeedbackType
- FeedbackLabel
- Methods
Resource: Message
Message represents a Message in SecOps chat.
JSON representation |
---|
{ "name": string, "input": { object ( |
Fields | |
---|---|
name |
Output only. Full resource name for the message. Format: projects/{project}/locations/{location}/instances/{instance}/users/{user}/conversations/{conversation}/messages/{message} |
input |
Required. Wrapper for the user input for this chat message. |
responses[] |
Output only. Wrapper for the chat responses for this chat message. |
create_time |
Output only. The message creation timestamp. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
feedback |
Optional. Feedback for this chat message. |
MessageInput
Input represents the user input of a chat message.
JSON representation |
---|
{ "body": string, "action": { object ( |
Fields | |
---|---|
body |
Required. The main text body of the input. |
action |
Optional. The actions attached to the input. It's only populated when the message is triggered by a suggested action execution. |
context |
Optional. The context attached to the message input. The context gives information about the current state of user journey in the application hosting the chat. |
Action
Action represents an action that can be performed in the host UI.
JSON representation |
---|
{ "display_text": string, "action_type": enum ( |
Fields | |
---|---|
display_text |
Output only. The text that'll be displayed to the user if this is rendered in the UI as a suggested action. |
action_type |
Output only. Type of action. |
Union field action_metadata . Depending on the action type, the corresponding action metadata must be populated. action_metadata can be only one of the following: |
|
follow_up |
Metadata for follow up action. |
navigation |
Metadata for navigation action. |
FollowUp
FollowUp can be used to store metadata required to send a follow up message by the UI.
JSON representation |
---|
{ "follow_up": string } |
Fields | |
---|---|
follow_up |
Output only. The text to use as input when generating the follow up message. |
ActionType
Action type allows the UI to understand what operation to trigger when user clicks ona suggested action. For example: 1. For a FOLLOW_UP action type, the UI just needs to create a new message with the follow_up.follow_up string. 2. For a NAVIGATION action type, the UI should trigger a redirection to the navigation.target_url URL. Action type also allows the backend to understand what suggested action triggered a new message.
Enums | |
---|---|
ACTION_TYPE_UNSPECIFIED |
The action type is unspecified. |
FOLLOW_UP |
The action is a follow up action. |
NAVIGATION |
The action is a navigation action. |
Context
Context represents the state of the hosting product (application) at the time the message was created in SecOps chat.
JSON representation |
---|
{ "uri": string, "additional": string } |
Fields | |
---|---|
uri |
Output only. The URI of the page when the message was created. |
additional |
Output only. Additional freeform context. This can contain various type of data depending on the use case. |
MessageResponse
Response represents the AI response in a chat message.
JSON representation |
---|
{ "blocks": [ { object ( |
Fields | |
---|---|
blocks[] |
Output only. The blocks forming the main body of the response. The body is made up of one or more blocks. |
suggested_actions[] |
Output only. The suggested actions attached to the response body. |
ResponseBlock
ResponseBlock represents the response body in a chat message.
JSON representation |
---|
{
"block_type": enum ( |
Fields | |
---|---|
block_type |
Output only. Type of the response block. |
content |
Output only. The text contents of the block. This text should be formatted based on the block_type value. |
BlockType
Types of response blocks supported.
Enums | |
---|---|
BLOCK_TYPE_UNSPECIFIED |
Response block type is unspecified. |
TEXT |
The response block is plain text. |
CODE |
The response block is code block. |
MessageFeedback
Feedback represents the feedback of a chat message.
JSON representation |
---|
{ "type": enum ( |
Fields | |
---|---|
type |
Required. The feedback type. |
comment |
Optional. The feedback comment. |
labels[] |
Output only. Feedback labels. |
FeedbackType
Feedback type.
Enums | |
---|---|
FEEDBACK_TYPE_UNSPECIFIED |
Feedback type is unspecified. |
POSITIVE |
Feedback type is positive. |
NEGATIVE |
Feedback type is negative. |
FeedbackLabel
Feedback labels.
Enums | |
---|---|
FEEDBACK_LABEL_UNSPECIFIED |
Feedback label is unspecified. |
OFFENSIVE_OR_UNSAFE |
The response contains offensive or unsafe content. |
IRRELEVANT |
The response is irrelevant. |
NOT_FACTUALLY_CORRECT |
The response contains inaccurate information. |
BUG |
There's an issue in the response. |
DESIGN_OR_FUNCTIONALITY |
The design or functionality can be improved. |
Methods |
|
---|---|
|
CreateMessage is used to create a new message in a conversation. |
|
DeleteMessage is used to delete a message. |
|
GetMessage is used to retrieve a message. |
|
ListMessages is used to retrieve existing messages for a conversation. |
|
UpdateMessage is used to update an existing message. |