File: dialogflow_v2beta1.projects.locations.generators.evaluations.html

package info (click to toggle)
python-googleapi 2.186.0-1
links: PTS
area: main
in suites: forky, sid
size: 553,432 kB
sloc: python: 11,087; javascript: 249; sh: 114; makefile: 59
file content (1252 lines) | stat: -rw-r--r-- 114,966 bytes
<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="dialogflow_v2beta1.html">Dialogflow API</a> . <a href="dialogflow_v2beta1.projects.html">projects</a> . <a href="dialogflow_v2beta1.projects.locations.html">locations</a> . <a href="dialogflow_v2beta1.projects.locations.generators.html">generators</a> . <a href="dialogflow_v2beta1.projects.locations.generators.evaluations.html">evaluations</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
  <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates evaluation of a generator.</p>
<p class="toc_element">
  <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes an evaluation of generator.</p>
<p class="toc_element">
  <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets an evaluation of generator.</p>
<p class="toc_element">
  <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists evaluations of generator.</p>
<p class="toc_element">
  <code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="close">close()</code>
  <pre>Close httplib2 connections.</pre>
</div>

<div class="method">
    <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
  <pre>Creates evaluation of a generator.

Args:
  parent: string, Required. The generator resource name. Format: `projects//locations//generators/` (required)
  body: object, The request body.
    The object takes the form of:

{ # Represents evaluation result of a generator.
  &quot;completeTime&quot;: &quot;A String&quot;, # Output only. Completion time of this generator evaluation.
  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation time of this generator evaluation.
  &quot;displayName&quot;: &quot;A String&quot;, # Optional. The display name of the generator evaluation. At most 64 bytes long.
  &quot;evaluationStatus&quot;: { # A common evalaution pipeline status. # Output only. The result status of the evaluation pipeline. Provides the status information including if the evaluation is still in progress, completed or failed with certain error and user actionable message.
    &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the evaluation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
    &quot;pipelineStatus&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error result of the evaluation in case of failure in evaluation pipeline.
      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
      &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
        {
          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
        },
      ],
      &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
    },
  },
  &quot;generatorEvaluationConfig&quot;: { # Generator evaluation input config. # Required. The configuration of the evaluation task.
    &quot;inputDataConfig&quot;: { # Input data config details # Required. The config/source of input data.
      &quot;agentAssistInputDataConfig&quot;: { # The distinctive configs for Agent Assist conversations as the conversation source. # The distinctive configs for Agent Assist conversations as the conversation source.
        &quot;endTime&quot;: &quot;A String&quot;, # Required. The end of the time range for conversations to be evaluated. Only conversations ended at or before this timestamp will be sampled.
        &quot;startTime&quot;: &quot;A String&quot;, # Required. The start of the time range for conversations to be evaluated. Only conversations created at or after this timestamp will be sampled.
      },
      &quot;datasetInputDataConfig&quot;: { # The distinctive configs for dataset as the conversation source. # The distinctive configs for dataset as the conversation source.
        &quot;dataset&quot;: &quot;A String&quot;, # Required. The identifier of the dataset to be evaluated. Format: `projects//locations//datasets/`.
      },
      &quot;endTime&quot;: &quot;A String&quot;, # Optional. The end timestamp to fetch conversation data.
      &quot;inputDataSourceType&quot;: &quot;A String&quot;, # Required. The source type of input data.
      &quot;isSummaryGenerationAllowed&quot;: True or False, # Optional. Whether the summary generation is allowed when the pre-existing qualified summaries are insufficient to cover the sample size.
      &quot;sampleSize&quot;: 42, # Optional. Desired number of conversation-summary pairs to be evaluated.
      &quot;startTime&quot;: &quot;A String&quot;, # Optional. The start timestamp to fetch conversation data.
      &quot;summaryGenerationOption&quot;: &quot;A String&quot;, # Optional. Option to control whether summaries are generated during evaluation.
    },
    &quot;outputGcsBucketPath&quot;: &quot;A String&quot;, # Required. The output Cloud Storage bucket path to store eval files, e.g. per_summary_accuracy_score report. This path is provided by customer and files stored in it are visible to customer, no internal data should be stored in this path.
    &quot;summarizationConfig&quot;: { # Evaluation configs for summarization generator. # Evaluation configs for summarization generator.
      &quot;accuracyEvaluationVersion&quot;: &quot;A String&quot;, # Optional. Version for summarization accuracy. This will determine the prompt and model used at backend.
      &quot;completenessEvaluationVersion&quot;: &quot;A String&quot;, # Optional. Version for summarization completeness. This will determine the prompt and model used at backend.
      &quot;enableAccuracyEvaluation&quot;: True or False, # Optional. Enable accuracy evaluation.
      &quot;enableCompletenessEvaluation&quot;: True or False, # Optional. Enable completeness evaluation.
      &quot;evaluatorVersion&quot;: &quot;A String&quot;, # Output only. Version for summarization evaluation.
    },
  },
  &quot;initialGenerator&quot;: { # LLM generator. # Required. The initial generator that was used when creating this evaluation. This is a copy of the generator read from storage when creating the evaluation.
    &quot;agentCoachingContext&quot;: { # Agent Coaching context that customer can configure. # Input of Agent Coaching feature.
      &quot;instructions&quot;: [ # Optional. Customized instructions for agent coaching.
        { # Agent Coaching instructions that customer can configure.
          &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The action that human agent should take. For example, &quot;apologize for the slow shipping&quot;. If the users only want to use agent coaching for intent detection, agent_action can be empty
          &quot;condition&quot;: &quot;A String&quot;, # Optional. The condition of the instruction. For example, &quot;the customer wants to cancel an order&quot;. If the users want the instruction to be triggered unconditionally, the condition can be empty.
          &quot;displayDetails&quot;: &quot;A String&quot;, # Optional. The detailed description of this instruction.
          &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instruction.
          &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplication check for the AgentCoachingInstruction.
            &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
              { # The duplicate suggestion details.
                &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
              },
            ],
          },
          &quot;systemAction&quot;: &quot;A String&quot;, # Optional. The action that system should take. For example, &quot;call GetOrderTime with order_number={order number provided by the customer}&quot;. If the users don&#x27;t have plugins or don&#x27;t want to trigger plugins, the system_action can be empty
        },
      ],
      &quot;outputLanguageCode&quot;: &quot;A String&quot;, # Optional. Output language code.
      &quot;overarchingGuidance&quot;: &quot;A String&quot;, # Optional. The overarching guidance for the agent coaching. This should be set only for v1.5 and later versions.
      &quot;version&quot;: &quot;A String&quot;, # Optional. Version of the feature. If not set, default to latest version. Current candidates are [&quot;2.5&quot;].
    },
    &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation time of this generator.
    &quot;description&quot;: &quot;A String&quot;, # Optional. Human readable description of the generator.
    &quot;freeFormContext&quot;: { # Free form generator context that customer can configure. # Input of free from generator to LLM.
      &quot;text&quot;: &quot;A String&quot;, # Optional. Free form text input to LLM.
    },
    &quot;inferenceParameter&quot;: { # The parameters of inference. # Optional. Inference parameters for this generator.
      &quot;maxOutputTokens&quot;: 42, # Optional. Maximum number of the output tokens for the generator.
      &quot;temperature&quot;: 3.14, # Optional. Controls the randomness of LLM predictions. Low temperature = less random. High temperature = more random. If unset (or 0), uses a default value of 0.
      &quot;topK&quot;: 42, # Optional. Top-k changes how the model selects tokens for output. A top-k of 1 means the selected token is the most probable among all tokens in the model&#x27;s vocabulary (also called greedy decoding), while a top-k of 3 means that the next token is selected from among the 3 most probable tokens (using temperature). For each token selection step, the top K tokens with the highest probabilities are sampled. Then tokens are further filtered based on topP with the final token selected using temperature sampling. Specify a lower value for less random responses and a higher value for more random responses. Acceptable value is [1, 40], default to 40.
      &quot;topP&quot;: 3.14, # Optional. Top-p changes how the model selects tokens for output. Tokens are selected from most K (see topK parameter) probable to least until the sum of their probabilities equals the top-p value. For example, if tokens A, B, and C have a probability of 0.3, 0.2, and 0.1 and the top-p value is 0.5, then the model will select either A or B as the next token (using temperature) and doesn&#x27;t consider C. The default top-p value is 0.95. Specify a lower value for less random responses and a higher value for more random responses. Acceptable value is [0.0, 1.0], default to 0.95.
    },
    &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The resource name of the generator. Format: `projects//locations//generators/`
    &quot;publishedModel&quot;: &quot;A String&quot;, # Optional. The published Large Language Model name. * To use the latest model version, specify the model name without version number. Example: `text-bison` * To use a stable model version, specify the version number as well. Example: `text-bison@002`.
    &quot;suggestionDedupingConfig&quot;: { # Config for suggestion deduping. NEXT_ID: 3 # Optional. Configuration for suggestion deduping. This is only applicable to AI Coach feature.
      &quot;enableDeduping&quot;: True or False, # Optional. Whether to enable suggestion deduping.
      &quot;similarityThreshold&quot;: 3.14, # Optional. The threshold for similarity between two suggestions. Acceptable value is [0.0, 1.0], default to 0.8
    },
    &quot;summarizationContext&quot;: { # Summarization context that customer can configure. # Input of Summarization feature.
      &quot;fewShotExamples&quot;: [ # Optional. List of few shot examples.
        { # Providing examples in the generator (i.e. building a few-shot generator) helps convey the desired format of the LLM response.
          &quot;conversationContext&quot;: { # Context of the conversation, including transcripts. # Optional. Conversation transcripts.
            &quot;messageEntries&quot;: [ # Optional. List of message transcripts in the conversation.
              { # Represents a message entry of a conversation.
                &quot;createTime&quot;: &quot;A String&quot;, # Optional. Create time of the message entry.
                &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the text. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.
                &quot;role&quot;: &quot;A String&quot;, # Optional. Participant role of the message.
                &quot;text&quot;: &quot;A String&quot;, # Optional. Transcript content of the message.
              },
            ],
          },
          &quot;extraInfo&quot;: { # Optional. Key is the placeholder field name in input, value is the value of the placeholder. E.g. instruction contains &quot;@price&quot;, and ingested data has &lt;&quot;price&quot;, &quot;10&quot;&gt;
            &quot;a_key&quot;: &quot;A String&quot;,
          },
          &quot;output&quot;: { # Suggestion generated using a Generator. # Required. Example output of the model.
            &quot;agentCoachingSuggestion&quot;: { # Suggestion for coaching agents. # Optional. Suggestion to coach the agent.
              &quot;agentActionSuggestions&quot;: [ # Optional. Suggested actions for the agent to take.
                { # Actions suggested for the agent. This is based on applicable instructions.
                  &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The suggested action for the agent.
                  &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplicate check result for the agent action suggestion.
                    &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                      { # The duplicate suggestion details. Keeping answer_record and sources together as they are identifiers for duplicate suggestions.
                        &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                        &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                        &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the suggestion.
                          &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                            42,
                          ],
                        },
                        &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                      },
                    ],
                  },
                  &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the agent action suggestion.
                    &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                      42,
                    ],
                  },
                },
              ],
              &quot;applicableInstructions&quot;: [ # Optional. Instructions applicable based on the current context.
                { # Agent Coaching instructions that customer can configure.
                  &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The action that human agent should take. For example, &quot;apologize for the slow shipping&quot;. If the users only want to use agent coaching for intent detection, agent_action can be empty
                  &quot;condition&quot;: &quot;A String&quot;, # Optional. The condition of the instruction. For example, &quot;the customer wants to cancel an order&quot;. If the users want the instruction to be triggered unconditionally, the condition can be empty.
                  &quot;displayDetails&quot;: &quot;A String&quot;, # Optional. The detailed description of this instruction.
                  &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instruction.
                  &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplication check for the AgentCoachingInstruction.
                    &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                      { # The duplicate suggestion details.
                        &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                        &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                        &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                      },
                    ],
                  },
                  &quot;systemAction&quot;: &quot;A String&quot;, # Optional. The action that system should take. For example, &quot;call GetOrderTime with order_number={order number provided by the customer}&quot;. If the users don&#x27;t have plugins or don&#x27;t want to trigger plugins, the system_action can be empty
                },
              ],
              &quot;sampleResponses&quot;: [ # Optional. Sample response for the Agent.
                { # Sample response that the agent can use. This could be based on applicable instructions and ingested data from other systems.
                  &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplicate check result for the sample response.
                    &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                      { # The duplicate suggestion details. Keeping answer_record and sources together as they are identifiers for duplicate suggestions.
                        &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                        &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                        &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the suggestion.
                          &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                            42,
                          ],
                        },
                        &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                      },
                    ],
                  },
                  &quot;responseText&quot;: &quot;A String&quot;, # Optional. Sample response for Agent in text.
                  &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the Sample Response.
                    &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                      42,
                    ],
                  },
                },
              ],
            },
            &quot;freeFormSuggestion&quot;: { # Suggestion generated using free form generator. # Optional. Free form suggestion.
              &quot;response&quot;: &quot;A String&quot;, # Required. Free form suggestion.
            },
            &quot;summarySuggestion&quot;: { # Suggested summary of the conversation. # Optional. Suggested summary.
              &quot;summarySections&quot;: [ # Required. All the parts of generated summary.
                { # A component of the generated summary.
                  &quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
                  &quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
                },
              ],
            },
            &quot;toolCallInfo&quot;: [ # Optional. List of request and response for tool calls executed.
              { # Request and response for a tool call.
                &quot;toolCall&quot;: { # Represents a call of a specific tool&#x27;s action with the specified inputs. # Required. Request for a tool call.
                  &quot;action&quot;: &quot;A String&quot;, # Optional. The name of the tool&#x27;s action associated with this call.
                  &quot;answerRecord&quot;: &quot;A String&quot;, # Optional. The answer record associated with this tool call.
                  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Create time of the tool call.
                  &quot;inputParameters&quot;: { # Optional. The action&#x27;s input parameters.
                    &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
                  },
                  &quot;state&quot;: &quot;A String&quot;, # Output only. State of the tool call
                  &quot;tool&quot;: &quot;A String&quot;, # Optional. The tool associated with this call. Format: `projects//locations//tools/`.
                  &quot;toolDisplayDetails&quot;: &quot;A String&quot;, # Optional. A human readable description of the tool.
                  &quot;toolDisplayName&quot;: &quot;A String&quot;, # Optional. A human readable short name of the tool, to be shown on the UI.
                },
                &quot;toolCallResult&quot;: { # The result of calling a tool&#x27;s action. # Required. Response for a tool call.
                  &quot;action&quot;: &quot;A String&quot;, # Optional. The name of the tool&#x27;s action associated with this call.
                  &quot;answerRecord&quot;: &quot;A String&quot;, # Optional. The answer record associated with this tool call result.
                  &quot;content&quot;: &quot;A String&quot;, # Only populated if the response content is utf-8 encoded.
                  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Create time of the tool call result.
                  &quot;error&quot;: { # An error produced by the tool call. # The tool call&#x27;s error.
                    &quot;message&quot;: &quot;A String&quot;, # Optional. The error message of the function.
                  },
                  &quot;rawContent&quot;: &quot;A String&quot;, # Only populated if the response content is not utf-8 encoded. (by definition byte fields are base64 encoded).
                  &quot;tool&quot;: &quot;A String&quot;, # Optional. The tool associated with this call. Format: `projects//locations//tools/`.
                },
              },
            ],
          },
          &quot;summarizationSectionList&quot;: { # List of summarization sections. # Summarization sections.
            &quot;summarizationSections&quot;: [ # Optional. Summarization sections.
              { # Represents the section of summarization.
                &quot;definition&quot;: &quot;A String&quot;, # Optional. Definition of the section, for example, &quot;what the customer needs help with or has question about.&quot;
                &quot;key&quot;: &quot;A String&quot;, # Optional. Name of the section, for example, &quot;situation&quot;.
                &quot;type&quot;: &quot;A String&quot;, # Optional. Type of the summarization section.
              },
            ],
          },
        },
      ],
      &quot;outputLanguageCode&quot;: &quot;A String&quot;, # Optional. The target language of the generated summary. The language code for conversation will be used if this field is empty. Supported 2.0 and later versions.
      &quot;summarizationSections&quot;: [ # Optional. List of sections. Note it contains both predefined section sand customer defined sections.
        { # Represents the section of summarization.
          &quot;definition&quot;: &quot;A String&quot;, # Optional. Definition of the section, for example, &quot;what the customer needs help with or has question about.&quot;
          &quot;key&quot;: &quot;A String&quot;, # Optional. Name of the section, for example, &quot;situation&quot;.
          &quot;type&quot;: &quot;A String&quot;, # Optional. Type of the summarization section.
        },
      ],
      &quot;version&quot;: &quot;A String&quot;, # Optional. Version of the feature. If not set, default to latest version. Current candidates are [&quot;1.0&quot;].
    },
    &quot;tools&quot;: [ # Optional. Resource names of the tools that the generator can choose from. Format: `projects//locations//tools/`.
      &quot;A String&quot;,
    ],
    &quot;triggerEvent&quot;: &quot;A String&quot;, # Optional. The trigger event of the generator. It defines when the generator is triggered in a conversation.
    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Update time of this generator.
  },
  &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The resource name of the evaluation. Format: `projects//locations//generators// evaluations/`
  &quot;satisfiesPzi&quot;: True or False, # Output only. A read only boolean field reflecting Zone Isolation status of the model. The field is an aggregated value of ZI status of its underlying dependencies. See more details in go/zicy-resource-placement#resource-status
  &quot;satisfiesPzs&quot;: True or False, # Output only. A read only boolean field reflecting Zone Separation status of the model. The field is an aggregated value of ZS status of its underlying dependencies. See more details in go/zicy-resource-placement#resource-status
  &quot;summarizationMetrics&quot;: { # Evaluation metrics for summarization generator. # Output only. Only available when the summarization generator is provided.
    &quot;conversationDetails&quot;: [ # Output only. List of conversation details.
      { # Aggregated evaluation result on conversation level. This contains evaluation results of all the metrics and sections.
        &quot;messageEntries&quot;: [ # Output only. Conversation transcript that used for summarization evaluation as a reference.
          { # Represents a message entry of a conversation.
            &quot;createTime&quot;: &quot;A String&quot;, # Optional. Create time of the message entry.
            &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the text. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.
            &quot;role&quot;: &quot;A String&quot;, # Optional. Participant role of the message.
            &quot;text&quot;: &quot;A String&quot;, # Optional. Transcript content of the message.
          },
        ],
        &quot;metricDetails&quot;: [ # Output only. List of metric details.
          { # Aggregated result on metric level. This contains the evaluation results of all the sections.
            &quot;metric&quot;: &quot;A String&quot;, # Output only. Metrics name. e.g. accuracy, adherence, completeness.
            &quot;score&quot;: 3.14, # Output only. Aggregated(average) score on this metric across all sections.
            &quot;sectionDetails&quot;: [ # Output only. List of section details.
              { # Section level result.
                &quot;evaluationResults&quot;: [ # Output only. List of evaluation result. The list only contains one kind of the evaluation result.
                  { # Evaluation result that contains one of accuracy, adherence or completeness evaluation result.
                    &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # Only available for accuracy metric.
                      &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
                      &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
                      &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
                    },
                    &quot;adherenceRubric&quot;: { # Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions. # Only available for adherence metric.
                      &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                      &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                      &quot;reasoning&quot;: &quot;A String&quot;, # Output only. The reasoning of the rubric question is addressed or not.
                    },
                    &quot;completenessRubric&quot;: { # Rubric details of the completeness evaluation result. # Only available for completeness metric.
                      &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                      &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                    },
                  },
                ],
                &quot;score&quot;: 3.14, # Output only. Aggregated(average) score on this section across all evaluation results. Either decompositions or rubrics.
                &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
                &quot;sectionSummary&quot;: &quot;A String&quot;, # Output only. Summary for this section
              },
            ],
          },
        ],
        &quot;sectionTokens&quot;: [ # Output only. Conversation level token count per section. This is an aggregated(sum) result of input token of summary acorss all metrics for a single conversation.
          { # A pair of section name and input token count of the input summary section.
            &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
            &quot;tokenCount&quot;: &quot;A String&quot;, # Output only. Token count.
          },
        ],
        &quot;summarySections&quot;: [ # Output only. Summary sections that used for summarization evaluation as a reference.
          { # A component of the generated summary.
            &quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
            &quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
          },
        ],
      },
    ],
    &quot;overallMetrics&quot;: [ # Output only. A list of aggregated(average) scores per metric section.
      { # Overall performance per metric. This is the aggregated score for each metric across all conversations that are selected for summarization evaluation.
        &quot;metric&quot;: &quot;A String&quot;, # Output only. Metric name. e.g. accuracy, adherence, completeness.
      },
    ],
    &quot;overallSectionTokens&quot;: [ # Output only. Overall token per section. This is an aggregated(sum) result of input token of summary acorss all conversations that are selected for summarization evaluation.
      { # A pair of section name and input token count of the input summary section.
        &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
        &quot;tokenCount&quot;: &quot;A String&quot;, # Output only. Token count.
      },
    ],
    &quot;summarizationEvaluationMergedResultsUri&quot;: &quot;A String&quot;, # Output only. User bucket uri for merged evaluation score and aggregation score csv.
    &quot;summarizationEvaluationResults&quot;: [ # Output only. A list of evaluation results per conversation(&amp;summary), metric and section.
      { # Evaluation result per conversation(&amp;summary), metric and section.
        &quot;decompositions&quot;: [ # Output only. List of decompostion details
          { # Decomposition details
            &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # only available for accuracy metric.
              &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
              &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
              &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
            },
            &quot;adherenceDecomposition&quot;: { # Decomposition details for adherence. # only available for adherence metric.
              &quot;adherenceReasoning&quot;: &quot;A String&quot;, # Output only. The adherence reasoning of the breakdown point.
              &quot;isAdherent&quot;: True or False, # Output only. Whether the breakdown point is adherent or not.
              &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the given instructions.
            },
          },
        ],
        &quot;evaluationResults&quot;: [ # Output only. List of evaluation results.
          { # Evaluation result that contains one of accuracy, adherence or completeness evaluation result.
            &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # Only available for accuracy metric.
              &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
              &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
              &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
            },
            &quot;adherenceRubric&quot;: { # Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions. # Only available for adherence metric.
              &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
              &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
              &quot;reasoning&quot;: &quot;A String&quot;, # Output only. The reasoning of the rubric question is addressed or not.
            },
            &quot;completenessRubric&quot;: { # Rubric details of the completeness evaluation result. # Only available for completeness metric.
              &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
              &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
            },
          },
        ],
        &quot;metric&quot;: &quot;A String&quot;, # Output only. metric name, e.g. accuracy, completeness, adherence, etc.
        &quot;score&quot;: 3.14, # Output only. score calculated from decompositions
        &quot;section&quot;: &quot;A String&quot;, # Output only. section/task name, e.g. action, situation, etc
        &quot;sectionSummary&quot;: &quot;A String&quot;, # Output only. Summary of this section
        &quot;sessionId&quot;: &quot;A String&quot;, # Output only. conversation session id
      },
    ],
  },
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
  &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
    &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
    &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
      },
    ],
    &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
  },
  &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
    &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
  },
  &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
  &quot;response&quot;: { # The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
    &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
  },
}</pre>
</div>

<div class="method">
    <code class="details" id="delete">delete(name, x__xgafv=None)</code>
  <pre>Deletes an evaluation of generator.

Args:
  name: string, Required. The generator evaluation resource name. Format: `projects//locations//generators// evaluations/` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}</pre>
</div>

<div class="method">
    <code class="details" id="get">get(name, x__xgafv=None)</code>
  <pre>Gets an evaluation of generator.

Args:
  name: string, Required. The generator evaluation resource name. Format: `projects//locations//generators//evaluations/` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Represents evaluation result of a generator.
  &quot;completeTime&quot;: &quot;A String&quot;, # Output only. Completion time of this generator evaluation.
  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation time of this generator evaluation.
  &quot;displayName&quot;: &quot;A String&quot;, # Optional. The display name of the generator evaluation. At most 64 bytes long.
  &quot;evaluationStatus&quot;: { # A common evalaution pipeline status. # Output only. The result status of the evaluation pipeline. Provides the status information including if the evaluation is still in progress, completed or failed with certain error and user actionable message.
    &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the evaluation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
    &quot;pipelineStatus&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error result of the evaluation in case of failure in evaluation pipeline.
      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
      &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
        {
          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
        },
      ],
      &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
    },
  },
  &quot;generatorEvaluationConfig&quot;: { # Generator evaluation input config. # Required. The configuration of the evaluation task.
    &quot;inputDataConfig&quot;: { # Input data config details # Required. The config/source of input data.
      &quot;agentAssistInputDataConfig&quot;: { # The distinctive configs for Agent Assist conversations as the conversation source. # The distinctive configs for Agent Assist conversations as the conversation source.
        &quot;endTime&quot;: &quot;A String&quot;, # Required. The end of the time range for conversations to be evaluated. Only conversations ended at or before this timestamp will be sampled.
        &quot;startTime&quot;: &quot;A String&quot;, # Required. The start of the time range for conversations to be evaluated. Only conversations created at or after this timestamp will be sampled.
      },
      &quot;datasetInputDataConfig&quot;: { # The distinctive configs for dataset as the conversation source. # The distinctive configs for dataset as the conversation source.
        &quot;dataset&quot;: &quot;A String&quot;, # Required. The identifier of the dataset to be evaluated. Format: `projects//locations//datasets/`.
      },
      &quot;endTime&quot;: &quot;A String&quot;, # Optional. The end timestamp to fetch conversation data.
      &quot;inputDataSourceType&quot;: &quot;A String&quot;, # Required. The source type of input data.
      &quot;isSummaryGenerationAllowed&quot;: True or False, # Optional. Whether the summary generation is allowed when the pre-existing qualified summaries are insufficient to cover the sample size.
      &quot;sampleSize&quot;: 42, # Optional. Desired number of conversation-summary pairs to be evaluated.
      &quot;startTime&quot;: &quot;A String&quot;, # Optional. The start timestamp to fetch conversation data.
      &quot;summaryGenerationOption&quot;: &quot;A String&quot;, # Optional. Option to control whether summaries are generated during evaluation.
    },
    &quot;outputGcsBucketPath&quot;: &quot;A String&quot;, # Required. The output Cloud Storage bucket path to store eval files, e.g. per_summary_accuracy_score report. This path is provided by customer and files stored in it are visible to customer, no internal data should be stored in this path.
    &quot;summarizationConfig&quot;: { # Evaluation configs for summarization generator. # Evaluation configs for summarization generator.
      &quot;accuracyEvaluationVersion&quot;: &quot;A String&quot;, # Optional. Version for summarization accuracy. This will determine the prompt and model used at backend.
      &quot;completenessEvaluationVersion&quot;: &quot;A String&quot;, # Optional. Version for summarization completeness. This will determine the prompt and model used at backend.
      &quot;enableAccuracyEvaluation&quot;: True or False, # Optional. Enable accuracy evaluation.
      &quot;enableCompletenessEvaluation&quot;: True or False, # Optional. Enable completeness evaluation.
      &quot;evaluatorVersion&quot;: &quot;A String&quot;, # Output only. Version for summarization evaluation.
    },
  },
  &quot;initialGenerator&quot;: { # LLM generator. # Required. The initial generator that was used when creating this evaluation. This is a copy of the generator read from storage when creating the evaluation.
    &quot;agentCoachingContext&quot;: { # Agent Coaching context that customer can configure. # Input of Agent Coaching feature.
      &quot;instructions&quot;: [ # Optional. Customized instructions for agent coaching.
        { # Agent Coaching instructions that customer can configure.
          &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The action that human agent should take. For example, &quot;apologize for the slow shipping&quot;. If the users only want to use agent coaching for intent detection, agent_action can be empty
          &quot;condition&quot;: &quot;A String&quot;, # Optional. The condition of the instruction. For example, &quot;the customer wants to cancel an order&quot;. If the users want the instruction to be triggered unconditionally, the condition can be empty.
          &quot;displayDetails&quot;: &quot;A String&quot;, # Optional. The detailed description of this instruction.
          &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instruction.
          &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplication check for the AgentCoachingInstruction.
            &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
              { # The duplicate suggestion details.
                &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
              },
            ],
          },
          &quot;systemAction&quot;: &quot;A String&quot;, # Optional. The action that system should take. For example, &quot;call GetOrderTime with order_number={order number provided by the customer}&quot;. If the users don&#x27;t have plugins or don&#x27;t want to trigger plugins, the system_action can be empty
        },
      ],
      &quot;outputLanguageCode&quot;: &quot;A String&quot;, # Optional. Output language code.
      &quot;overarchingGuidance&quot;: &quot;A String&quot;, # Optional. The overarching guidance for the agent coaching. This should be set only for v1.5 and later versions.
      &quot;version&quot;: &quot;A String&quot;, # Optional. Version of the feature. If not set, default to latest version. Current candidates are [&quot;2.5&quot;].
    },
    &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation time of this generator.
    &quot;description&quot;: &quot;A String&quot;, # Optional. Human readable description of the generator.
    &quot;freeFormContext&quot;: { # Free form generator context that customer can configure. # Input of free from generator to LLM.
      &quot;text&quot;: &quot;A String&quot;, # Optional. Free form text input to LLM.
    },
    &quot;inferenceParameter&quot;: { # The parameters of inference. # Optional. Inference parameters for this generator.
      &quot;maxOutputTokens&quot;: 42, # Optional. Maximum number of the output tokens for the generator.
      &quot;temperature&quot;: 3.14, # Optional. Controls the randomness of LLM predictions. Low temperature = less random. High temperature = more random. If unset (or 0), uses a default value of 0.
      &quot;topK&quot;: 42, # Optional. Top-k changes how the model selects tokens for output. A top-k of 1 means the selected token is the most probable among all tokens in the model&#x27;s vocabulary (also called greedy decoding), while a top-k of 3 means that the next token is selected from among the 3 most probable tokens (using temperature). For each token selection step, the top K tokens with the highest probabilities are sampled. Then tokens are further filtered based on topP with the final token selected using temperature sampling. Specify a lower value for less random responses and a higher value for more random responses. Acceptable value is [1, 40], default to 40.
      &quot;topP&quot;: 3.14, # Optional. Top-p changes how the model selects tokens for output. Tokens are selected from most K (see topK parameter) probable to least until the sum of their probabilities equals the top-p value. For example, if tokens A, B, and C have a probability of 0.3, 0.2, and 0.1 and the top-p value is 0.5, then the model will select either A or B as the next token (using temperature) and doesn&#x27;t consider C. The default top-p value is 0.95. Specify a lower value for less random responses and a higher value for more random responses. Acceptable value is [0.0, 1.0], default to 0.95.
    },
    &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The resource name of the generator. Format: `projects//locations//generators/`
    &quot;publishedModel&quot;: &quot;A String&quot;, # Optional. The published Large Language Model name. * To use the latest model version, specify the model name without version number. Example: `text-bison` * To use a stable model version, specify the version number as well. Example: `text-bison@002`.
    &quot;suggestionDedupingConfig&quot;: { # Config for suggestion deduping. NEXT_ID: 3 # Optional. Configuration for suggestion deduping. This is only applicable to AI Coach feature.
      &quot;enableDeduping&quot;: True or False, # Optional. Whether to enable suggestion deduping.
      &quot;similarityThreshold&quot;: 3.14, # Optional. The threshold for similarity between two suggestions. Acceptable value is [0.0, 1.0], default to 0.8
    },
    &quot;summarizationContext&quot;: { # Summarization context that customer can configure. # Input of Summarization feature.
      &quot;fewShotExamples&quot;: [ # Optional. List of few shot examples.
        { # Providing examples in the generator (i.e. building a few-shot generator) helps convey the desired format of the LLM response.
          &quot;conversationContext&quot;: { # Context of the conversation, including transcripts. # Optional. Conversation transcripts.
            &quot;messageEntries&quot;: [ # Optional. List of message transcripts in the conversation.
              { # Represents a message entry of a conversation.
                &quot;createTime&quot;: &quot;A String&quot;, # Optional. Create time of the message entry.
                &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the text. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.
                &quot;role&quot;: &quot;A String&quot;, # Optional. Participant role of the message.
                &quot;text&quot;: &quot;A String&quot;, # Optional. Transcript content of the message.
              },
            ],
          },
          &quot;extraInfo&quot;: { # Optional. Key is the placeholder field name in input, value is the value of the placeholder. E.g. instruction contains &quot;@price&quot;, and ingested data has &lt;&quot;price&quot;, &quot;10&quot;&gt;
            &quot;a_key&quot;: &quot;A String&quot;,
          },
          &quot;output&quot;: { # Suggestion generated using a Generator. # Required. Example output of the model.
            &quot;agentCoachingSuggestion&quot;: { # Suggestion for coaching agents. # Optional. Suggestion to coach the agent.
              &quot;agentActionSuggestions&quot;: [ # Optional. Suggested actions for the agent to take.
                { # Actions suggested for the agent. This is based on applicable instructions.
                  &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The suggested action for the agent.
                  &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplicate check result for the agent action suggestion.
                    &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                      { # The duplicate suggestion details. Keeping answer_record and sources together as they are identifiers for duplicate suggestions.
                        &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                        &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                        &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the suggestion.
                          &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                            42,
                          ],
                        },
                        &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                      },
                    ],
                  },
                  &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the agent action suggestion.
                    &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                      42,
                    ],
                  },
                },
              ],
              &quot;applicableInstructions&quot;: [ # Optional. Instructions applicable based on the current context.
                { # Agent Coaching instructions that customer can configure.
                  &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The action that human agent should take. For example, &quot;apologize for the slow shipping&quot;. If the users only want to use agent coaching for intent detection, agent_action can be empty
                  &quot;condition&quot;: &quot;A String&quot;, # Optional. The condition of the instruction. For example, &quot;the customer wants to cancel an order&quot;. If the users want the instruction to be triggered unconditionally, the condition can be empty.
                  &quot;displayDetails&quot;: &quot;A String&quot;, # Optional. The detailed description of this instruction.
                  &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instruction.
                  &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplication check for the AgentCoachingInstruction.
                    &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                      { # The duplicate suggestion details.
                        &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                        &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                        &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                      },
                    ],
                  },
                  &quot;systemAction&quot;: &quot;A String&quot;, # Optional. The action that system should take. For example, &quot;call GetOrderTime with order_number={order number provided by the customer}&quot;. If the users don&#x27;t have plugins or don&#x27;t want to trigger plugins, the system_action can be empty
                },
              ],
              &quot;sampleResponses&quot;: [ # Optional. Sample response for the Agent.
                { # Sample response that the agent can use. This could be based on applicable instructions and ingested data from other systems.
                  &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplicate check result for the sample response.
                    &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                      { # The duplicate suggestion details. Keeping answer_record and sources together as they are identifiers for duplicate suggestions.
                        &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                        &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                        &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the suggestion.
                          &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                            42,
                          ],
                        },
                        &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                      },
                    ],
                  },
                  &quot;responseText&quot;: &quot;A String&quot;, # Optional. Sample response for Agent in text.
                  &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the Sample Response.
                    &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                      42,
                    ],
                  },
                },
              ],
            },
            &quot;freeFormSuggestion&quot;: { # Suggestion generated using free form generator. # Optional. Free form suggestion.
              &quot;response&quot;: &quot;A String&quot;, # Required. Free form suggestion.
            },
            &quot;summarySuggestion&quot;: { # Suggested summary of the conversation. # Optional. Suggested summary.
              &quot;summarySections&quot;: [ # Required. All the parts of generated summary.
                { # A component of the generated summary.
                  &quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
                  &quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
                },
              ],
            },
            &quot;toolCallInfo&quot;: [ # Optional. List of request and response for tool calls executed.
              { # Request and response for a tool call.
                &quot;toolCall&quot;: { # Represents a call of a specific tool&#x27;s action with the specified inputs. # Required. Request for a tool call.
                  &quot;action&quot;: &quot;A String&quot;, # Optional. The name of the tool&#x27;s action associated with this call.
                  &quot;answerRecord&quot;: &quot;A String&quot;, # Optional. The answer record associated with this tool call.
                  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Create time of the tool call.
                  &quot;inputParameters&quot;: { # Optional. The action&#x27;s input parameters.
                    &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
                  },
                  &quot;state&quot;: &quot;A String&quot;, # Output only. State of the tool call
                  &quot;tool&quot;: &quot;A String&quot;, # Optional. The tool associated with this call. Format: `projects//locations//tools/`.
                  &quot;toolDisplayDetails&quot;: &quot;A String&quot;, # Optional. A human readable description of the tool.
                  &quot;toolDisplayName&quot;: &quot;A String&quot;, # Optional. A human readable short name of the tool, to be shown on the UI.
                },
                &quot;toolCallResult&quot;: { # The result of calling a tool&#x27;s action. # Required. Response for a tool call.
                  &quot;action&quot;: &quot;A String&quot;, # Optional. The name of the tool&#x27;s action associated with this call.
                  &quot;answerRecord&quot;: &quot;A String&quot;, # Optional. The answer record associated with this tool call result.
                  &quot;content&quot;: &quot;A String&quot;, # Only populated if the response content is utf-8 encoded.
                  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Create time of the tool call result.
                  &quot;error&quot;: { # An error produced by the tool call. # The tool call&#x27;s error.
                    &quot;message&quot;: &quot;A String&quot;, # Optional. The error message of the function.
                  },
                  &quot;rawContent&quot;: &quot;A String&quot;, # Only populated if the response content is not utf-8 encoded. (by definition byte fields are base64 encoded).
                  &quot;tool&quot;: &quot;A String&quot;, # Optional. The tool associated with this call. Format: `projects//locations//tools/`.
                },
              },
            ],
          },
          &quot;summarizationSectionList&quot;: { # List of summarization sections. # Summarization sections.
            &quot;summarizationSections&quot;: [ # Optional. Summarization sections.
              { # Represents the section of summarization.
                &quot;definition&quot;: &quot;A String&quot;, # Optional. Definition of the section, for example, &quot;what the customer needs help with or has question about.&quot;
                &quot;key&quot;: &quot;A String&quot;, # Optional. Name of the section, for example, &quot;situation&quot;.
                &quot;type&quot;: &quot;A String&quot;, # Optional. Type of the summarization section.
              },
            ],
          },
        },
      ],
      &quot;outputLanguageCode&quot;: &quot;A String&quot;, # Optional. The target language of the generated summary. The language code for conversation will be used if this field is empty. Supported 2.0 and later versions.
      &quot;summarizationSections&quot;: [ # Optional. List of sections. Note it contains both predefined section sand customer defined sections.
        { # Represents the section of summarization.
          &quot;definition&quot;: &quot;A String&quot;, # Optional. Definition of the section, for example, &quot;what the customer needs help with or has question about.&quot;
          &quot;key&quot;: &quot;A String&quot;, # Optional. Name of the section, for example, &quot;situation&quot;.
          &quot;type&quot;: &quot;A String&quot;, # Optional. Type of the summarization section.
        },
      ],
      &quot;version&quot;: &quot;A String&quot;, # Optional. Version of the feature. If not set, default to latest version. Current candidates are [&quot;1.0&quot;].
    },
    &quot;tools&quot;: [ # Optional. Resource names of the tools that the generator can choose from. Format: `projects//locations//tools/`.
      &quot;A String&quot;,
    ],
    &quot;triggerEvent&quot;: &quot;A String&quot;, # Optional. The trigger event of the generator. It defines when the generator is triggered in a conversation.
    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Update time of this generator.
  },
  &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The resource name of the evaluation. Format: `projects//locations//generators// evaluations/`
  &quot;satisfiesPzi&quot;: True or False, # Output only. A read only boolean field reflecting Zone Isolation status of the model. The field is an aggregated value of ZI status of its underlying dependencies. See more details in go/zicy-resource-placement#resource-status
  &quot;satisfiesPzs&quot;: True or False, # Output only. A read only boolean field reflecting Zone Separation status of the model. The field is an aggregated value of ZS status of its underlying dependencies. See more details in go/zicy-resource-placement#resource-status
  &quot;summarizationMetrics&quot;: { # Evaluation metrics for summarization generator. # Output only. Only available when the summarization generator is provided.
    &quot;conversationDetails&quot;: [ # Output only. List of conversation details.
      { # Aggregated evaluation result on conversation level. This contains evaluation results of all the metrics and sections.
        &quot;messageEntries&quot;: [ # Output only. Conversation transcript that used for summarization evaluation as a reference.
          { # Represents a message entry of a conversation.
            &quot;createTime&quot;: &quot;A String&quot;, # Optional. Create time of the message entry.
            &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the text. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.
            &quot;role&quot;: &quot;A String&quot;, # Optional. Participant role of the message.
            &quot;text&quot;: &quot;A String&quot;, # Optional. Transcript content of the message.
          },
        ],
        &quot;metricDetails&quot;: [ # Output only. List of metric details.
          { # Aggregated result on metric level. This contains the evaluation results of all the sections.
            &quot;metric&quot;: &quot;A String&quot;, # Output only. Metrics name. e.g. accuracy, adherence, completeness.
            &quot;score&quot;: 3.14, # Output only. Aggregated(average) score on this metric across all sections.
            &quot;sectionDetails&quot;: [ # Output only. List of section details.
              { # Section level result.
                &quot;evaluationResults&quot;: [ # Output only. List of evaluation result. The list only contains one kind of the evaluation result.
                  { # Evaluation result that contains one of accuracy, adherence or completeness evaluation result.
                    &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # Only available for accuracy metric.
                      &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
                      &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
                      &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
                    },
                    &quot;adherenceRubric&quot;: { # Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions. # Only available for adherence metric.
                      &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                      &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                      &quot;reasoning&quot;: &quot;A String&quot;, # Output only. The reasoning of the rubric question is addressed or not.
                    },
                    &quot;completenessRubric&quot;: { # Rubric details of the completeness evaluation result. # Only available for completeness metric.
                      &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                      &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                    },
                  },
                ],
                &quot;score&quot;: 3.14, # Output only. Aggregated(average) score on this section across all evaluation results. Either decompositions or rubrics.
                &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
                &quot;sectionSummary&quot;: &quot;A String&quot;, # Output only. Summary for this section
              },
            ],
          },
        ],
        &quot;sectionTokens&quot;: [ # Output only. Conversation level token count per section. This is an aggregated(sum) result of input token of summary acorss all metrics for a single conversation.
          { # A pair of section name and input token count of the input summary section.
            &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
            &quot;tokenCount&quot;: &quot;A String&quot;, # Output only. Token count.
          },
        ],
        &quot;summarySections&quot;: [ # Output only. Summary sections that used for summarization evaluation as a reference.
          { # A component of the generated summary.
            &quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
            &quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
          },
        ],
      },
    ],
    &quot;overallMetrics&quot;: [ # Output only. A list of aggregated(average) scores per metric section.
      { # Overall performance per metric. This is the aggregated score for each metric across all conversations that are selected for summarization evaluation.
        &quot;metric&quot;: &quot;A String&quot;, # Output only. Metric name. e.g. accuracy, adherence, completeness.
      },
    ],
    &quot;overallSectionTokens&quot;: [ # Output only. Overall token per section. This is an aggregated(sum) result of input token of summary acorss all conversations that are selected for summarization evaluation.
      { # A pair of section name and input token count of the input summary section.
        &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
        &quot;tokenCount&quot;: &quot;A String&quot;, # Output only. Token count.
      },
    ],
    &quot;summarizationEvaluationMergedResultsUri&quot;: &quot;A String&quot;, # Output only. User bucket uri for merged evaluation score and aggregation score csv.
    &quot;summarizationEvaluationResults&quot;: [ # Output only. A list of evaluation results per conversation(&amp;summary), metric and section.
      { # Evaluation result per conversation(&amp;summary), metric and section.
        &quot;decompositions&quot;: [ # Output only. List of decompostion details
          { # Decomposition details
            &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # only available for accuracy metric.
              &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
              &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
              &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
            },
            &quot;adherenceDecomposition&quot;: { # Decomposition details for adherence. # only available for adherence metric.
              &quot;adherenceReasoning&quot;: &quot;A String&quot;, # Output only. The adherence reasoning of the breakdown point.
              &quot;isAdherent&quot;: True or False, # Output only. Whether the breakdown point is adherent or not.
              &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the given instructions.
            },
          },
        ],
        &quot;evaluationResults&quot;: [ # Output only. List of evaluation results.
          { # Evaluation result that contains one of accuracy, adherence or completeness evaluation result.
            &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # Only available for accuracy metric.
              &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
              &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
              &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
            },
            &quot;adherenceRubric&quot;: { # Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions. # Only available for adherence metric.
              &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
              &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
              &quot;reasoning&quot;: &quot;A String&quot;, # Output only. The reasoning of the rubric question is addressed or not.
            },
            &quot;completenessRubric&quot;: { # Rubric details of the completeness evaluation result. # Only available for completeness metric.
              &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
              &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
            },
          },
        ],
        &quot;metric&quot;: &quot;A String&quot;, # Output only. metric name, e.g. accuracy, completeness, adherence, etc.
        &quot;score&quot;: 3.14, # Output only. score calculated from decompositions
        &quot;section&quot;: &quot;A String&quot;, # Output only. section/task name, e.g. action, situation, etc
        &quot;sectionSummary&quot;: &quot;A String&quot;, # Output only. Summary of this section
        &quot;sessionId&quot;: &quot;A String&quot;, # Output only. conversation session id
      },
    ],
  },
}</pre>
</div>

<div class="method">
    <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
  <pre>Lists evaluations of generator.

Args:
  parent: string, Required. The generator resource name. Format: `projects//locations//generators/` Wildcard value `-` is supported on generator_id to list evaluations across all generators under same project. (required)
  pageSize: integer, Optional. Maximum number of evaluations to return in a single page. By default 100 and at most 1000.
  pageToken: string, Optional. The next_page_token value returned from a previous list request.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response of ListGeneratorEvaluations.
  &quot;generatorEvaluations&quot;: [ # The list of evaluations to return.
    { # Represents evaluation result of a generator.
      &quot;completeTime&quot;: &quot;A String&quot;, # Output only. Completion time of this generator evaluation.
      &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation time of this generator evaluation.
      &quot;displayName&quot;: &quot;A String&quot;, # Optional. The display name of the generator evaluation. At most 64 bytes long.
      &quot;evaluationStatus&quot;: { # A common evalaution pipeline status. # Output only. The result status of the evaluation pipeline. Provides the status information including if the evaluation is still in progress, completed or failed with certain error and user actionable message.
        &quot;done&quot;: True or False, # Output only. If the value is `false`, it means the evaluation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
        &quot;pipelineStatus&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The error result of the evaluation in case of failure in evaluation pipeline.
          &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
          &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
            {
              &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
            },
          ],
          &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
        },
      },
      &quot;generatorEvaluationConfig&quot;: { # Generator evaluation input config. # Required. The configuration of the evaluation task.
        &quot;inputDataConfig&quot;: { # Input data config details # Required. The config/source of input data.
          &quot;agentAssistInputDataConfig&quot;: { # The distinctive configs for Agent Assist conversations as the conversation source. # The distinctive configs for Agent Assist conversations as the conversation source.
            &quot;endTime&quot;: &quot;A String&quot;, # Required. The end of the time range for conversations to be evaluated. Only conversations ended at or before this timestamp will be sampled.
            &quot;startTime&quot;: &quot;A String&quot;, # Required. The start of the time range for conversations to be evaluated. Only conversations created at or after this timestamp will be sampled.
          },
          &quot;datasetInputDataConfig&quot;: { # The distinctive configs for dataset as the conversation source. # The distinctive configs for dataset as the conversation source.
            &quot;dataset&quot;: &quot;A String&quot;, # Required. The identifier of the dataset to be evaluated. Format: `projects//locations//datasets/`.
          },
          &quot;endTime&quot;: &quot;A String&quot;, # Optional. The end timestamp to fetch conversation data.
          &quot;inputDataSourceType&quot;: &quot;A String&quot;, # Required. The source type of input data.
          &quot;isSummaryGenerationAllowed&quot;: True or False, # Optional. Whether the summary generation is allowed when the pre-existing qualified summaries are insufficient to cover the sample size.
          &quot;sampleSize&quot;: 42, # Optional. Desired number of conversation-summary pairs to be evaluated.
          &quot;startTime&quot;: &quot;A String&quot;, # Optional. The start timestamp to fetch conversation data.
          &quot;summaryGenerationOption&quot;: &quot;A String&quot;, # Optional. Option to control whether summaries are generated during evaluation.
        },
        &quot;outputGcsBucketPath&quot;: &quot;A String&quot;, # Required. The output Cloud Storage bucket path to store eval files, e.g. per_summary_accuracy_score report. This path is provided by customer and files stored in it are visible to customer, no internal data should be stored in this path.
        &quot;summarizationConfig&quot;: { # Evaluation configs for summarization generator. # Evaluation configs for summarization generator.
          &quot;accuracyEvaluationVersion&quot;: &quot;A String&quot;, # Optional. Version for summarization accuracy. This will determine the prompt and model used at backend.
          &quot;completenessEvaluationVersion&quot;: &quot;A String&quot;, # Optional. Version for summarization completeness. This will determine the prompt and model used at backend.
          &quot;enableAccuracyEvaluation&quot;: True or False, # Optional. Enable accuracy evaluation.
          &quot;enableCompletenessEvaluation&quot;: True or False, # Optional. Enable completeness evaluation.
          &quot;evaluatorVersion&quot;: &quot;A String&quot;, # Output only. Version for summarization evaluation.
        },
      },
      &quot;initialGenerator&quot;: { # LLM generator. # Required. The initial generator that was used when creating this evaluation. This is a copy of the generator read from storage when creating the evaluation.
        &quot;agentCoachingContext&quot;: { # Agent Coaching context that customer can configure. # Input of Agent Coaching feature.
          &quot;instructions&quot;: [ # Optional. Customized instructions for agent coaching.
            { # Agent Coaching instructions that customer can configure.
              &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The action that human agent should take. For example, &quot;apologize for the slow shipping&quot;. If the users only want to use agent coaching for intent detection, agent_action can be empty
              &quot;condition&quot;: &quot;A String&quot;, # Optional. The condition of the instruction. For example, &quot;the customer wants to cancel an order&quot;. If the users want the instruction to be triggered unconditionally, the condition can be empty.
              &quot;displayDetails&quot;: &quot;A String&quot;, # Optional. The detailed description of this instruction.
              &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instruction.
              &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplication check for the AgentCoachingInstruction.
                &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                  { # The duplicate suggestion details.
                    &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                    &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                    &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                  },
                ],
              },
              &quot;systemAction&quot;: &quot;A String&quot;, # Optional. The action that system should take. For example, &quot;call GetOrderTime with order_number={order number provided by the customer}&quot;. If the users don&#x27;t have plugins or don&#x27;t want to trigger plugins, the system_action can be empty
            },
          ],
          &quot;outputLanguageCode&quot;: &quot;A String&quot;, # Optional. Output language code.
          &quot;overarchingGuidance&quot;: &quot;A String&quot;, # Optional. The overarching guidance for the agent coaching. This should be set only for v1.5 and later versions.
          &quot;version&quot;: &quot;A String&quot;, # Optional. Version of the feature. If not set, default to latest version. Current candidates are [&quot;2.5&quot;].
        },
        &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation time of this generator.
        &quot;description&quot;: &quot;A String&quot;, # Optional. Human readable description of the generator.
        &quot;freeFormContext&quot;: { # Free form generator context that customer can configure. # Input of free from generator to LLM.
          &quot;text&quot;: &quot;A String&quot;, # Optional. Free form text input to LLM.
        },
        &quot;inferenceParameter&quot;: { # The parameters of inference. # Optional. Inference parameters for this generator.
          &quot;maxOutputTokens&quot;: 42, # Optional. Maximum number of the output tokens for the generator.
          &quot;temperature&quot;: 3.14, # Optional. Controls the randomness of LLM predictions. Low temperature = less random. High temperature = more random. If unset (or 0), uses a default value of 0.
          &quot;topK&quot;: 42, # Optional. Top-k changes how the model selects tokens for output. A top-k of 1 means the selected token is the most probable among all tokens in the model&#x27;s vocabulary (also called greedy decoding), while a top-k of 3 means that the next token is selected from among the 3 most probable tokens (using temperature). For each token selection step, the top K tokens with the highest probabilities are sampled. Then tokens are further filtered based on topP with the final token selected using temperature sampling. Specify a lower value for less random responses and a higher value for more random responses. Acceptable value is [1, 40], default to 40.
          &quot;topP&quot;: 3.14, # Optional. Top-p changes how the model selects tokens for output. Tokens are selected from most K (see topK parameter) probable to least until the sum of their probabilities equals the top-p value. For example, if tokens A, B, and C have a probability of 0.3, 0.2, and 0.1 and the top-p value is 0.5, then the model will select either A or B as the next token (using temperature) and doesn&#x27;t consider C. The default top-p value is 0.95. Specify a lower value for less random responses and a higher value for more random responses. Acceptable value is [0.0, 1.0], default to 0.95.
        },
        &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The resource name of the generator. Format: `projects//locations//generators/`
        &quot;publishedModel&quot;: &quot;A String&quot;, # Optional. The published Large Language Model name. * To use the latest model version, specify the model name without version number. Example: `text-bison` * To use a stable model version, specify the version number as well. Example: `text-bison@002`.
        &quot;suggestionDedupingConfig&quot;: { # Config for suggestion deduping. NEXT_ID: 3 # Optional. Configuration for suggestion deduping. This is only applicable to AI Coach feature.
          &quot;enableDeduping&quot;: True or False, # Optional. Whether to enable suggestion deduping.
          &quot;similarityThreshold&quot;: 3.14, # Optional. The threshold for similarity between two suggestions. Acceptable value is [0.0, 1.0], default to 0.8
        },
        &quot;summarizationContext&quot;: { # Summarization context that customer can configure. # Input of Summarization feature.
          &quot;fewShotExamples&quot;: [ # Optional. List of few shot examples.
            { # Providing examples in the generator (i.e. building a few-shot generator) helps convey the desired format of the LLM response.
              &quot;conversationContext&quot;: { # Context of the conversation, including transcripts. # Optional. Conversation transcripts.
                &quot;messageEntries&quot;: [ # Optional. List of message transcripts in the conversation.
                  { # Represents a message entry of a conversation.
                    &quot;createTime&quot;: &quot;A String&quot;, # Optional. Create time of the message entry.
                    &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the text. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.
                    &quot;role&quot;: &quot;A String&quot;, # Optional. Participant role of the message.
                    &quot;text&quot;: &quot;A String&quot;, # Optional. Transcript content of the message.
                  },
                ],
              },
              &quot;extraInfo&quot;: { # Optional. Key is the placeholder field name in input, value is the value of the placeholder. E.g. instruction contains &quot;@price&quot;, and ingested data has &lt;&quot;price&quot;, &quot;10&quot;&gt;
                &quot;a_key&quot;: &quot;A String&quot;,
              },
              &quot;output&quot;: { # Suggestion generated using a Generator. # Required. Example output of the model.
                &quot;agentCoachingSuggestion&quot;: { # Suggestion for coaching agents. # Optional. Suggestion to coach the agent.
                  &quot;agentActionSuggestions&quot;: [ # Optional. Suggested actions for the agent to take.
                    { # Actions suggested for the agent. This is based on applicable instructions.
                      &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The suggested action for the agent.
                      &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplicate check result for the agent action suggestion.
                        &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                          { # The duplicate suggestion details. Keeping answer_record and sources together as they are identifiers for duplicate suggestions.
                            &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                            &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                            &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the suggestion.
                              &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                                42,
                              ],
                            },
                            &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                          },
                        ],
                      },
                      &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the agent action suggestion.
                        &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                          42,
                        ],
                      },
                    },
                  ],
                  &quot;applicableInstructions&quot;: [ # Optional. Instructions applicable based on the current context.
                    { # Agent Coaching instructions that customer can configure.
                      &quot;agentAction&quot;: &quot;A String&quot;, # Optional. The action that human agent should take. For example, &quot;apologize for the slow shipping&quot;. If the users only want to use agent coaching for intent detection, agent_action can be empty
                      &quot;condition&quot;: &quot;A String&quot;, # Optional. The condition of the instruction. For example, &quot;the customer wants to cancel an order&quot;. If the users want the instruction to be triggered unconditionally, the condition can be empty.
                      &quot;displayDetails&quot;: &quot;A String&quot;, # Optional. The detailed description of this instruction.
                      &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instruction.
                      &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplication check for the AgentCoachingInstruction.
                        &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                          { # The duplicate suggestion details.
                            &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                            &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                            &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                          },
                        ],
                      },
                      &quot;systemAction&quot;: &quot;A String&quot;, # Optional. The action that system should take. For example, &quot;call GetOrderTime with order_number={order number provided by the customer}&quot;. If the users don&#x27;t have plugins or don&#x27;t want to trigger plugins, the system_action can be empty
                    },
                  ],
                  &quot;sampleResponses&quot;: [ # Optional. Sample response for the Agent.
                    { # Sample response that the agent can use. This could be based on applicable instructions and ingested data from other systems.
                      &quot;duplicateCheckResult&quot;: { # Duplication check for the suggestion. # Output only. Duplicate check result for the sample response.
                        &quot;duplicateSuggestions&quot;: [ # Output only. The duplicate suggestions.
                          { # The duplicate suggestion details. Keeping answer_record and sources together as they are identifiers for duplicate suggestions.
                            &quot;answerRecord&quot;: &quot;A String&quot;, # Output only. The answer record id of the past duplicate suggestion.
                            &quot;similarityScore&quot;: 3.14, # Output only. The similarity score of between the past and current suggestion.
                            &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the suggestion.
                              &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                                42,
                              ],
                            },
                            &quot;suggestionIndex&quot;: 42, # Output only. The index of the duplicate suggestion in the past suggestion list.
                          },
                        ],
                      },
                      &quot;responseText&quot;: &quot;A String&quot;, # Optional. Sample response for Agent in text.
                      &quot;sources&quot;: { # Sources for the suggestion. # Output only. Sources for the Sample Response.
                        &quot;instructionIndexes&quot;: [ # Output only. Source instruction indexes for the suggestion. This is the index of the applicable_instructions field.
                          42,
                        ],
                      },
                    },
                  ],
                },
                &quot;freeFormSuggestion&quot;: { # Suggestion generated using free form generator. # Optional. Free form suggestion.
                  &quot;response&quot;: &quot;A String&quot;, # Required. Free form suggestion.
                },
                &quot;summarySuggestion&quot;: { # Suggested summary of the conversation. # Optional. Suggested summary.
                  &quot;summarySections&quot;: [ # Required. All the parts of generated summary.
                    { # A component of the generated summary.
                      &quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
                      &quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
                    },
                  ],
                },
                &quot;toolCallInfo&quot;: [ # Optional. List of request and response for tool calls executed.
                  { # Request and response for a tool call.
                    &quot;toolCall&quot;: { # Represents a call of a specific tool&#x27;s action with the specified inputs. # Required. Request for a tool call.
                      &quot;action&quot;: &quot;A String&quot;, # Optional. The name of the tool&#x27;s action associated with this call.
                      &quot;answerRecord&quot;: &quot;A String&quot;, # Optional. The answer record associated with this tool call.
                      &quot;createTime&quot;: &quot;A String&quot;, # Output only. Create time of the tool call.
                      &quot;inputParameters&quot;: { # Optional. The action&#x27;s input parameters.
                        &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
                      },
                      &quot;state&quot;: &quot;A String&quot;, # Output only. State of the tool call
                      &quot;tool&quot;: &quot;A String&quot;, # Optional. The tool associated with this call. Format: `projects//locations//tools/`.
                      &quot;toolDisplayDetails&quot;: &quot;A String&quot;, # Optional. A human readable description of the tool.
                      &quot;toolDisplayName&quot;: &quot;A String&quot;, # Optional. A human readable short name of the tool, to be shown on the UI.
                    },
                    &quot;toolCallResult&quot;: { # The result of calling a tool&#x27;s action. # Required. Response for a tool call.
                      &quot;action&quot;: &quot;A String&quot;, # Optional. The name of the tool&#x27;s action associated with this call.
                      &quot;answerRecord&quot;: &quot;A String&quot;, # Optional. The answer record associated with this tool call result.
                      &quot;content&quot;: &quot;A String&quot;, # Only populated if the response content is utf-8 encoded.
                      &quot;createTime&quot;: &quot;A String&quot;, # Output only. Create time of the tool call result.
                      &quot;error&quot;: { # An error produced by the tool call. # The tool call&#x27;s error.
                        &quot;message&quot;: &quot;A String&quot;, # Optional. The error message of the function.
                      },
                      &quot;rawContent&quot;: &quot;A String&quot;, # Only populated if the response content is not utf-8 encoded. (by definition byte fields are base64 encoded).
                      &quot;tool&quot;: &quot;A String&quot;, # Optional. The tool associated with this call. Format: `projects//locations//tools/`.
                    },
                  },
                ],
              },
              &quot;summarizationSectionList&quot;: { # List of summarization sections. # Summarization sections.
                &quot;summarizationSections&quot;: [ # Optional. Summarization sections.
                  { # Represents the section of summarization.
                    &quot;definition&quot;: &quot;A String&quot;, # Optional. Definition of the section, for example, &quot;what the customer needs help with or has question about.&quot;
                    &quot;key&quot;: &quot;A String&quot;, # Optional. Name of the section, for example, &quot;situation&quot;.
                    &quot;type&quot;: &quot;A String&quot;, # Optional. Type of the summarization section.
                  },
                ],
              },
            },
          ],
          &quot;outputLanguageCode&quot;: &quot;A String&quot;, # Optional. The target language of the generated summary. The language code for conversation will be used if this field is empty. Supported 2.0 and later versions.
          &quot;summarizationSections&quot;: [ # Optional. List of sections. Note it contains both predefined section sand customer defined sections.
            { # Represents the section of summarization.
              &quot;definition&quot;: &quot;A String&quot;, # Optional. Definition of the section, for example, &quot;what the customer needs help with or has question about.&quot;
              &quot;key&quot;: &quot;A String&quot;, # Optional. Name of the section, for example, &quot;situation&quot;.
              &quot;type&quot;: &quot;A String&quot;, # Optional. Type of the summarization section.
            },
          ],
          &quot;version&quot;: &quot;A String&quot;, # Optional. Version of the feature. If not set, default to latest version. Current candidates are [&quot;1.0&quot;].
        },
        &quot;tools&quot;: [ # Optional. Resource names of the tools that the generator can choose from. Format: `projects//locations//tools/`.
          &quot;A String&quot;,
        ],
        &quot;triggerEvent&quot;: &quot;A String&quot;, # Optional. The trigger event of the generator. It defines when the generator is triggered in a conversation.
        &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Update time of this generator.
      },
      &quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The resource name of the evaluation. Format: `projects//locations//generators// evaluations/`
      &quot;satisfiesPzi&quot;: True or False, # Output only. A read only boolean field reflecting Zone Isolation status of the model. The field is an aggregated value of ZI status of its underlying dependencies. See more details in go/zicy-resource-placement#resource-status
      &quot;satisfiesPzs&quot;: True or False, # Output only. A read only boolean field reflecting Zone Separation status of the model. The field is an aggregated value of ZS status of its underlying dependencies. See more details in go/zicy-resource-placement#resource-status
      &quot;summarizationMetrics&quot;: { # Evaluation metrics for summarization generator. # Output only. Only available when the summarization generator is provided.
        &quot;conversationDetails&quot;: [ # Output only. List of conversation details.
          { # Aggregated evaluation result on conversation level. This contains evaluation results of all the metrics and sections.
            &quot;messageEntries&quot;: [ # Output only. Conversation transcript that used for summarization evaluation as a reference.
              { # Represents a message entry of a conversation.
                &quot;createTime&quot;: &quot;A String&quot;, # Optional. Create time of the message entry.
                &quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the text. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes.
                &quot;role&quot;: &quot;A String&quot;, # Optional. Participant role of the message.
                &quot;text&quot;: &quot;A String&quot;, # Optional. Transcript content of the message.
              },
            ],
            &quot;metricDetails&quot;: [ # Output only. List of metric details.
              { # Aggregated result on metric level. This contains the evaluation results of all the sections.
                &quot;metric&quot;: &quot;A String&quot;, # Output only. Metrics name. e.g. accuracy, adherence, completeness.
                &quot;score&quot;: 3.14, # Output only. Aggregated(average) score on this metric across all sections.
                &quot;sectionDetails&quot;: [ # Output only. List of section details.
                  { # Section level result.
                    &quot;evaluationResults&quot;: [ # Output only. List of evaluation result. The list only contains one kind of the evaluation result.
                      { # Evaluation result that contains one of accuracy, adherence or completeness evaluation result.
                        &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # Only available for accuracy metric.
                          &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
                          &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
                          &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
                        },
                        &quot;adherenceRubric&quot;: { # Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions. # Only available for adherence metric.
                          &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                          &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                          &quot;reasoning&quot;: &quot;A String&quot;, # Output only. The reasoning of the rubric question is addressed or not.
                        },
                        &quot;completenessRubric&quot;: { # Rubric details of the completeness evaluation result. # Only available for completeness metric.
                          &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                          &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                        },
                      },
                    ],
                    &quot;score&quot;: 3.14, # Output only. Aggregated(average) score on this section across all evaluation results. Either decompositions or rubrics.
                    &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
                    &quot;sectionSummary&quot;: &quot;A String&quot;, # Output only. Summary for this section
                  },
                ],
              },
            ],
            &quot;sectionTokens&quot;: [ # Output only. Conversation level token count per section. This is an aggregated(sum) result of input token of summary acorss all metrics for a single conversation.
              { # A pair of section name and input token count of the input summary section.
                &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
                &quot;tokenCount&quot;: &quot;A String&quot;, # Output only. Token count.
              },
            ],
            &quot;summarySections&quot;: [ # Output only. Summary sections that used for summarization evaluation as a reference.
              { # A component of the generated summary.
                &quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
                &quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
              },
            ],
          },
        ],
        &quot;overallMetrics&quot;: [ # Output only. A list of aggregated(average) scores per metric section.
          { # Overall performance per metric. This is the aggregated score for each metric across all conversations that are selected for summarization evaluation.
            &quot;metric&quot;: &quot;A String&quot;, # Output only. Metric name. e.g. accuracy, adherence, completeness.
          },
        ],
        &quot;overallSectionTokens&quot;: [ # Output only. Overall token per section. This is an aggregated(sum) result of input token of summary acorss all conversations that are selected for summarization evaluation.
          { # A pair of section name and input token count of the input summary section.
            &quot;section&quot;: &quot;A String&quot;, # Output only. The name of the summary instruction.
            &quot;tokenCount&quot;: &quot;A String&quot;, # Output only. Token count.
          },
        ],
        &quot;summarizationEvaluationMergedResultsUri&quot;: &quot;A String&quot;, # Output only. User bucket uri for merged evaluation score and aggregation score csv.
        &quot;summarizationEvaluationResults&quot;: [ # Output only. A list of evaluation results per conversation(&amp;summary), metric and section.
          { # Evaluation result per conversation(&amp;summary), metric and section.
            &quot;decompositions&quot;: [ # Output only. List of decompostion details
              { # Decomposition details
                &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # only available for accuracy metric.
                  &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
                  &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
                  &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
                },
                &quot;adherenceDecomposition&quot;: { # Decomposition details for adherence. # only available for adherence metric.
                  &quot;adherenceReasoning&quot;: &quot;A String&quot;, # Output only. The adherence reasoning of the breakdown point.
                  &quot;isAdherent&quot;: True or False, # Output only. Whether the breakdown point is adherent or not.
                  &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the given instructions.
                },
              },
            ],
            &quot;evaluationResults&quot;: [ # Output only. List of evaluation results.
              { # Evaluation result that contains one of accuracy, adherence or completeness evaluation result.
                &quot;accuracyDecomposition&quot;: { # Decomposition details for accuracy. # Only available for accuracy metric.
                  &quot;accuracyReasoning&quot;: &quot;A String&quot;, # Output only. The accuracy reasoning of the breakdown point.
                  &quot;isAccurate&quot;: True or False, # Output only. Whether the breakdown point is accurate or not.
                  &quot;point&quot;: &quot;A String&quot;, # Output only. The breakdown point of the summary.
                },
                &quot;adherenceRubric&quot;: { # Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions. # Only available for adherence metric.
                  &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                  &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                  &quot;reasoning&quot;: &quot;A String&quot;, # Output only. The reasoning of the rubric question is addressed or not.
                },
                &quot;completenessRubric&quot;: { # Rubric details of the completeness evaluation result. # Only available for completeness metric.
                  &quot;isAddressed&quot;: True or False, # Output only. A boolean that indicates whether the rubric question is addressed or not.
                  &quot;question&quot;: &quot;A String&quot;, # Output only. The question generated from instruction that used to evaluate summary.
                },
              },
            ],
            &quot;metric&quot;: &quot;A String&quot;, # Output only. metric name, e.g. accuracy, completeness, adherence, etc.
            &quot;score&quot;: 3.14, # Output only. score calculated from decompositions
            &quot;section&quot;: &quot;A String&quot;, # Output only. section/task name, e.g. action, situation, etc
            &quot;sectionSummary&quot;: &quot;A String&quot;, # Output only. Summary of this section
            &quot;sessionId&quot;: &quot;A String&quot;, # Output only. conversation session id
          },
        ],
      },
    },
  ],
  &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more results in the list.
}</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next()</code>
  <pre>Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call &#x27;execute()&#x27; on to request the next
          page. Returns None if there are no more items in the collection.
        </pre>
</div>

</body></html>