Skip to content

feat: [geminidataanalytics] add ClarificationMessage, thought-signature, formatted-data #7076

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gcf-owl-bot wants to merge 3 commits into
base: main
Choose a base branch
from
+7,403 −5,179
Open

feat: [geminidataanalytics] add ClarificationMessage, thought-signature, formatted-data #7076

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d5671dd
feat: add ClarificationMessage, thought-signature, formatted-data
gcf-owl-bot[bot] Jan 31, 2026
c628c39
feat: add ClarificationMessage, thought-signature, formatted-data
gcf-owl-bot[bot] Jan 31, 2026
1727a7f
🦉 Updates from OwlBot post-processor
gcf-owl-bot[bot] Jan 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 71 additions & 1 deletion ...minidataanalytics/protos/google/cloud/geminidataanalytics/v1alpha/data_chat_service.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -458,6 +458,10 @@ message SystemMessage {
// Optional. A message containing example queries.
ExampleQueries example_queries = 13
[(google.api.field_behavior) = OPTIONAL];

// Optional. A message containing clarification questions.
ClarificationMessage clarification = 14
[(google.api.field_behavior) = OPTIONAL];
}

// Identifies the group that the event belongs to. Similar events are deemed
Expand All @@ -476,7 +480,7 @@ message TextMessage {
// The text is a final response to the user question.
FINAL_RESPONSE = 1;

// The text is a thinking plan generated by the thinking tool.
// The text is a thought from the model.
THOUGHT = 2;

// The text is an informational message about the agent's progress, such as
Expand All @@ -492,6 +496,10 @@ message TextMessage {

// Optional. The type of the text message.
TextType text_type = 2 [(google.api.field_behavior) = OPTIONAL];

// Optional. An opaque signature for a thought so it can be reused in
// subsequent requests.
bytes thought_signature = 3 [(google.api.field_behavior) = OPTIONAL];
}

// A message produced during schema resolution.
Expand Down Expand Up @@ -583,6 +591,16 @@ message DataResult {
// are represented as lists or structs.
repeated google.protobuf.Struct data = 2
[(google.api.field_behavior) = OPTIONAL];

// Optional. Formatted representation of the data, when applicable.
// Each row is a struct that directly corresponds to the row at the same index
// within the `data` field. Its values are string representations of the
// original data, formatted according to data source specifications (e.g.,
// "$1,234.56" for currency). Columns without formatting will default to
// their raw value representation. If no columns have formatting rules, this
// field will be empty.
repeated google.protobuf.Struct formatted_data = 6
[(google.api.field_behavior) = OPTIONAL];
}

// A BigQuery job executed by the system.
Expand Down Expand Up @@ -731,6 +749,58 @@ message ErrorMessage {
string text = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
}

// Represents a single question to the user to help clarify their query.
message ClarificationQuestion {
// The selection mode for the clarification question.
enum SelectionMode {
// Unspecified selection mode.
SELECTION_MODE_UNSPECIFIED = 0;

// The user can select only one option.
SINGLE_SELECT = 1;

// The user can select multiple options.
MULTI_SELECT = 2;
}

// The type of clarification question.
// This enum may be extended with new values in the future.
enum ClarificationQuestionType {
// Unspecified clarification question type.
CLARIFICATION_QUESTION_TYPE_UNSPECIFIED = 0;

// The clarification question is for filter values.
FILTER_VALUES = 1;

// The clarification question is for data fields. This is a generic term
// encompassing SQL columns, Looker fields (dimensions/measures), or
// nested data structure properties.
FIELDS = 2;
}

// Required. The natural language question to ask the user.
string question = 1 [(google.api.field_behavior) = REQUIRED];

// Required. The selection mode for this question.
SelectionMode selection_mode = 2 [(google.api.field_behavior) = REQUIRED];

// Required. A list of distinct options for the user to choose from.
// The number of options is limited to a maximum of 5.
repeated string options = 3 [(google.api.field_behavior) = REQUIRED];

// Optional. The type of clarification question.
ClarificationQuestionType clarification_question_type = 4
[(google.api.field_behavior) = OPTIONAL];
}

// A message of questions to help clarify the user's query. This is returned
// when the system cannot confidently answer the user's question.
message ClarificationMessage {
// Required. A batch of clarification questions to ask the user.
repeated ClarificationQuestion questions = 1
[(google.api.field_behavior) = REQUIRED];
}

// A message containing derived and authored example queries.
message ExampleQueries {
// Optional. A list of derived and authored example queries, providing
Expand Down
72 changes: 71 additions & 1 deletion ...eminidataanalytics/protos/google/cloud/geminidataanalytics/v1beta/data_chat_service.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -458,6 +458,10 @@ message SystemMessage {
// Optional. A message containing example queries.
ExampleQueries example_queries = 13
[(google.api.field_behavior) = OPTIONAL];

// Optional. A message containing clarification questions.
ClarificationMessage clarification = 14
[(google.api.field_behavior) = OPTIONAL];
}

// Identifies the group that the event belongs to. Similar events are deemed
Expand All @@ -476,7 +480,7 @@ message TextMessage {
// The text is a final response to the user question.
FINAL_RESPONSE = 1;

// The text is a thinking plan generated by the thinking tool.
// The text is a thought from the model.
THOUGHT = 2;

// The text is an informational message about the agent's progress, such as
Expand All @@ -492,6 +496,10 @@ message TextMessage {

// Optional. The type of the text message.
TextType text_type = 2 [(google.api.field_behavior) = OPTIONAL];

// Optional. An opaque signature for a thought so it can be reused in
// subsequent requests.
bytes thought_signature = 3 [(google.api.field_behavior) = OPTIONAL];
}

// A message produced during schema resolution.
Expand Down Expand Up @@ -583,6 +591,16 @@ message DataResult {
// are represented as lists or structs.
repeated google.protobuf.Struct data = 2
[(google.api.field_behavior) = OPTIONAL];

// Optional. Formatted representation of the data, when applicable.
// Each row is a struct that directly corresponds to the row at the same index
// within the `data` field. Its values are string representations of the
// original data, formatted according to data source specifications (e.g.,
// "$1,234.56" for currency). Columns without formatting will default to
// their raw value representation. If no columns have formatting rules, this
// field will be empty.
repeated google.protobuf.Struct formatted_data = 6
[(google.api.field_behavior) = OPTIONAL];
}

// A BigQuery job executed by the system.
Expand Down Expand Up @@ -731,6 +749,58 @@ message ErrorMessage {
string text = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
}

// Represents a single question to the user to help clarify their query.
message ClarificationQuestion {
// The selection mode for the clarification question.
enum SelectionMode {
// Unspecified selection mode.
SELECTION_MODE_UNSPECIFIED = 0;

// The user can select only one option.
SINGLE_SELECT = 1;

// The user can select multiple options.
MULTI_SELECT = 2;
}

// The type of clarification question.
// This enum may be extended with new values in the future.
enum ClarificationQuestionType {
// Unspecified clarification question type.
CLARIFICATION_QUESTION_TYPE_UNSPECIFIED = 0;

// The clarification question is for filter values.
FILTER_VALUES = 1;

// The clarification question is for data fields. This is a generic term
// encompassing SQL columns, Looker fields (dimensions/measures), or
// nested data structure properties.
FIELDS = 2;
}

// Required. The natural language question to ask the user.
string question = 1 [(google.api.field_behavior) = REQUIRED];

// Required. The selection mode for this question.
SelectionMode selection_mode = 2 [(google.api.field_behavior) = REQUIRED];

// Required. A list of distinct options for the user to choose from.
// The number of options is limited to a maximum of 5.
repeated string options = 3 [(google.api.field_behavior) = REQUIRED];

// Optional. The type of clarification question.
ClarificationQuestionType clarification_question_type = 4
[(google.api.field_behavior) = OPTIONAL];
}

// A message of questions to help clarify the user's query. This is returned
// when the system cannot confidently answer the user's question.
message ClarificationMessage {
// Required. A batch of clarification questions to ask the user.
repeated ClarificationQuestion questions = 1
[(google.api.field_behavior) = REQUIRED];
}

// A message containing derived and authored example queries.
message ExampleQueries {
// Optional. A list of derived and authored example queries, providing
Expand Down
Loading