Index
ContactCenterInsights
(interface)Analysis
(message)AnalysisResult
(message)AnalysisResult.CallAnalysisMetadata
(message)AnnotationBoundary
(message)AnswerFeedback
(message)AnswerFeedback.CorrectnessLevel
(enum)ArticleSuggestionData
(message)CalculateIssueModelStatsRequest
(message)CalculateIssueModelStatsResponse
(message)CalculateStatsRequest
(message)CalculateStatsResponse
(message)CalculateStatsResponse.TimeSeries
(message)CalculateStatsResponse.TimeSeries.Interval
(message)CallAnnotation
(message)Conversation
(message)Conversation.CallMetadata
(message)Conversation.Medium
(enum)Conversation.Transcript
(message)Conversation.Transcript.TranscriptSegment
(message)Conversation.Transcript.TranscriptSegment.DialogflowSegmentMetadata
(message)Conversation.Transcript.TranscriptSegment.WordInfo
(message)ConversationDataSource
(message)ConversationLevelSentiment
(message)ConversationParticipant
(message)ConversationParticipant.Role
(enum)ConversationView
(enum)CreateAnalysisOperationMetadata
(message)CreateAnalysisRequest
(message)CreateConversationRequest
(message)CreateIssueModelMetadata
(message)CreateIssueModelRequest
(message)CreatePhraseMatcherRequest
(message)CreateViewRequest
(message)DeleteAnalysisRequest
(message)DeleteConversationRequest
(message)DeleteIssueModelMetadata
(message)DeleteIssueModelRequest
(message)DeletePhraseMatcherRequest
(message)DeleteViewRequest
(message)DeployIssueModelMetadata
(message)DeployIssueModelRequest
(message)DeployIssueModelResponse
(message)DialogflowIntent
(message)DialogflowInteractionData
(message)DialogflowSource
(message)Entity
(message)Entity.Type
(enum)EntityMentionData
(message)EntityMentionData.MentionType
(enum)ExactMatchConfig
(message)ExportInsightsDataMetadata
(message)ExportInsightsDataRequest
(message)ExportInsightsDataRequest.BigQueryDestination
(message)ExportInsightsDataRequest.WriteDisposition
(enum)ExportInsightsDataResponse
(message)FaqAnswerData
(message)GcsSource
(message)GetAnalysisRequest
(message)GetConversationRequest
(message)GetIssueModelRequest
(message)GetIssueRequest
(message)GetPhraseMatcherRequest
(message)GetSettingsRequest
(message)GetViewRequest
(message)HoldData
(message)Intent
(message)IntentMatchData
(message)InterruptionData
(message)Issue
(message)IssueAssignment
(message)IssueModel
(message)IssueModel.InputDataConfig
(message)IssueModel.State
(enum)IssueModelLabelStats
(message)IssueModelLabelStats.IssueStats
(message)IssueModelResult
(message)ListAnalysesRequest
(message)ListAnalysesResponse
(message)ListConversationsRequest
(message)ListConversationsResponse
(message)ListIssueModelsRequest
(message)ListIssueModelsResponse
(message)ListIssuesRequest
(message)ListIssuesResponse
(message)ListPhraseMatchersRequest
(message)ListPhraseMatchersResponse
(message)ListViewsRequest
(message)ListViewsResponse
(message)PhraseMatchData
(message)PhraseMatchRule
(message)PhraseMatchRuleConfig
(message)PhraseMatchRuleGroup
(message)PhraseMatchRuleGroup.PhraseMatchRuleGroupType
(enum)PhraseMatcher
(message)PhraseMatcher.PhraseMatcherType
(enum)RuntimeAnnotation
(message)SentimentData
(message)Settings
(message)Settings.AnalysisConfig
(message)SilenceData
(message)SmartComposeSuggestionData
(message)SmartReplyData
(message)UndeployIssueModelMetadata
(message)UndeployIssueModelRequest
(message)UndeployIssueModelResponse
(message)UpdateConversationRequest
(message)UpdateIssueModelRequest
(message)UpdateIssueRequest
(message)UpdatePhraseMatcherRequest
(message)UpdateSettingsRequest
(message)UpdateViewRequest
(message)View
(message)
ContactCenterInsights
An API that lets users analyze and explore their business conversation data.
CalculateIssueModelStats |
---|
Gets an issue model's statistics.
|
CalculateStats |
---|
Gets conversation statistics.
|
CreateAnalysis |
---|
Creates an analysis. The long running operation is done when the analysis has completed.
|
CreateConversation |
---|
Creates a conversation.
|
CreateIssueModel |
---|
Creates an issue model.
|
CreatePhraseMatcher |
---|
Creates a phrase matcher.
|
CreateView |
---|
Creates a view.
|
DeleteAnalysis |
---|
Deletes an analysis.
|
DeleteConversation |
---|
Deletes a conversation.
|
DeleteIssueModel |
---|
Deletes an issue model.
|
DeletePhraseMatcher |
---|
Deletes a phrase matcher.
|
DeleteView |
---|
Deletes a view.
|
DeployIssueModel |
---|
Deploys an issue model. Returns an error if a model is already deployed. An issue model can only be used in analysis after it has been deployed.
|
ExportInsightsData |
---|
Export insights data to a destination defined in the request body.
|
GetAnalysis |
---|
Gets an analysis.
|
GetConversation |
---|
Gets a conversation.
|
GetIssue |
---|
Gets an issue.
|
GetIssueModel |
---|
Gets an issue model.
|
GetPhraseMatcher |
---|
Gets a phrase matcher.
|
GetSettings |
---|
Gets project-level settings.
|
GetView |
---|
Gets a view.
|
ListAnalyses |
---|
Lists analyses.
|
ListConversations |
---|
Lists conversations.
|
ListIssueModels |
---|
Lists issue models.
|
ListIssues |
---|
Lists issues.
|
ListPhraseMatchers |
---|
Lists phrase matchers.
|
ListViews |
---|
Lists views.
|
UndeployIssueModel |
---|
Undeploys an issue model. An issue model can not be used in analysis after it has been undeployed.
|
UpdateConversation |
---|
Updates a conversation.
|
UpdateIssue |
---|
Updates an issue.
|
UpdateIssueModel |
---|
Updates an issue model.
|
UpdatePhraseMatcher |
---|
Updates a phrase matcher.
|
UpdateSettings |
---|
Updates project-level settings.
|
UpdateView |
---|
Updates a view.
|
Analysis
The analysis resource.
Fields | |
---|---|
name |
Immutable. The resource name of the analysis. Format: projects/{project}/locations/{location}/conversations/{conversation}/analyses/{analysis} |
request_time |
Output only. The time at which the analysis was requested. |
create_time |
Output only. The time at which the analysis was created, which occurs when the long-running operation completes. |
analysis_result |
Output only. The result of the analysis, which is populated when the analysis finishes. |
AnalysisResult
The result of an analysis.
Fields | |
---|---|
end_time |
The time at which the analysis ended. |
call_analysis_metadata |
Call-specific metadata created by the analysis. |
CallAnalysisMetadata
Call-specific metadata created during analysis.
Fields | |
---|---|
annotations[] |
A list of call annotations that apply to this call. |
entities |
All the entities in the call. |
sentiments[] |
Overall conversation-level sentiment for each channel of the call. |
intents |
All the matched intents in the call. |
phrase_matchers |
All the matched phrase matchers in the call. |
issue_model_result |
Overall conversation-level issue modeling result. |
AnnotationBoundary
A point in a conversation that marks the start or the end of an annotation.
Fields | |
---|---|
transcript_index |
The index in the sequence of transcribed pieces of the conversation where the boundary is located. This index starts at zero. |
word_index |
The word index of this boundary with respect to the first word in the transcript piece. This index starts at zero. |
AnswerFeedback
The feedback that the customer has about a certain answer in the conversation.
Fields | |
---|---|
correctness_level |
The correctness level of an answer. |
clicked |
Indicates whether an answer or item was clicked by the human agent. |
displayed |
Indicates whether an answer or item was displayed to the human agent in the agent desktop UI. |
CorrectnessLevel
The correctness level of an answer.
Enums | |
---|---|
CORRECTNESS_LEVEL_UNSPECIFIED |
Correctness level unspecified. |
NOT_CORRECT |
Answer is totally wrong. |
PARTIALLY_CORRECT |
Answer is partially correct. |
FULLY_CORRECT |
Answer is fully correct. |
ArticleSuggestionData
Agent Assist Article Suggestion data.
Fields | |
---|---|
title |
Article title. |
uri |
Article URI. |
confidence_score |
The system's confidence score that this article is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
metadata |
Map that contains metadata about the Article Suggestion and the document that it originates from. |
query_record |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record} |
source |
The knowledge document that this answer was extracted from. Format: projects/{project}/knowledgeBases/{knowledge_base}/documents/{document} |
CalculateIssueModelStatsRequest
Request to get statistics of an issue model.
Fields | |
---|---|
issue_model |
Required. The resource name of the issue model to query against. |
CalculateIssueModelStatsResponse
Response of querying an issue model's statistics.
Fields | |
---|---|
current_stats |
The latest label statistics for the queried issue model. Includes results on both training data and data labeled after deployment. |
CalculateStatsRequest
The request for calculating conversation statistics.
Fields | |
---|---|
location |
Required. The location of the conversations. |
filter |
A filter to reduce results to a specific subset. This field is useful for getting statistics about conversations with specific properties. |
CalculateStatsResponse
The response for calculating conversation statistics.
Fields | |
---|---|
average_duration |
The average duration of all conversations. The average is calculated using only conversations that have a time duration. |
average_turn_count |
The average number of turns per conversation. |
conversation_count |
The total number of conversations. |
smart_highlighter_matches |
A map associating each smart highlighter display name with its respective number of matches in the set of conversations. |
custom_highlighter_matches |
A map associating each custom highlighter resource name with its respective number of matches in the set of conversations. |
issue_matches |
A map associating each issue resource name with its respective number of matches in the set of conversations. Key has the format: |
issue_matches_stats |
A map associating each issue resource name with its respective number of matches in the set of conversations. Key has the format: |
conversation_count_time_series |
A time series representing the count of conversations created over time that match that requested filter criteria. |
TimeSeries
A time series representing conversations over time.
Fields | |
---|---|
interval_duration |
The duration of each interval. |
points[] |
An ordered list of intervals from earliest to latest, where each interval represents the number of conversations that transpired during the time window. |
Interval
A single interval in a time series.
Fields | |
---|---|
start_time |
The start time of this interval. |
conversation_count |
The number of conversations created in this interval. |
CallAnnotation
A piece of metadata that applies to a window of a call.
Fields | |
---|---|
channel_tag |
The channel of the audio where the annotation occurs. For single-channel audio, this field is not populated. |
annotation_start_boundary |
The boundary in the conversation where the annotation starts, inclusive. |
annotation_end_boundary |
The boundary in the conversation where the annotation ends, inclusive. |
Union field data . The data in the annotation. data can be only one of the following: |
|
interruption_data |
Data specifying an interruption. |
sentiment_data |
Data specifying sentiment. |
silence_data |
Data specifying silence. |
hold_data |
Data specifying a hold. |
entity_mention_data |
Data specifying an entity mention. |
intent_match_data |
Data specifying an intent match. |
phrase_match_data |
Data specifying a phrase match. |
Conversation
The conversation resource.
Fields | |
---|---|
name |
Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation} |
data_source |
The source of the audio and transcription for the conversation. |
create_time |
Output only. The time at which the conversation was created. |
update_time |
Output only. The most recent time at which the conversation was updated. |
start_time |
The time at which the conversation started. |
language_code |
A user-specified language code for the conversation. |
agent_id |
An opaque, user-specified string representing the human agent who handled the conversation. |
labels |
A map for the user to specify any custom fields. A maximum of 20 labels per conversation is allowed, with a maximum of 256 characters per entry. |
transcript |
Output only. The conversation transcript. |
medium |
Immutable. The conversation medium, if unspecified will default to PHONE_CALL. |
duration |
Output only. The duration of the conversation. |
turn_count |
Output only. The number of turns in the conversation. |
latest_analysis |
Output only. The conversation's latest analysis, if one exists. |
runtime_annotations[] |
Output only. The annotations that were generated during the customer and agent interaction. |
dialogflow_intents |
Output only. All the matched Dialogflow intents in the call. The key corresponds to a Dialogflow intent, format: projects/{project}/agent/{agent}/intents/{intent} |
obfuscated_user_id |
Obfuscated user ID which the customer sent to us. |
call_metadata |
Call-specific metadata. |
Union field expiration . A time to live expiration setting, can be either a specified timestamp or a duration from the time that the conversation creation request was received. Conversations with an expiration set will be removed up to 24 hours after the specified time. expiration can be only one of the following: |
|
expire_time |
The time at which this conversation should expire. After this time, the conversation data and any associated analyses will be deleted. |
ttl |
Input only. The TTL for this resource. If specified, then this TTL will be used to calculate the expire time. |
CallMetadata
Call-specific metadata.
Fields | |
---|---|
customer_channel |
The audio channel that contains the customer. |
agent_channel |
The audio channel that contains the agent. |
Medium
Possible media for the conversation.
Enums | |
---|---|
MEDIUM_UNSPECIFIED |
Default value, if unspecified will default to PHONE_CALL. |
PHONE_CALL |
The format for conversations that took place over the phone. |
CHAT |
The format for conversations that took place over chat. |
Transcript
A message representing the transcript of a conversation.
Fields | |
---|---|
transcript_segments[] |
A list of sequential transcript segments that comprise the conversation. |
TranscriptSegment
A segment of a full transcript.
Fields | |
---|---|
message_time |
The time that the message occurred, if provided. |
text |
The text of this segment. |
confidence |
A confidence estimate between 0.0 and 1.0 of the fidelity of this segment. A default value of 0.0 indicates that the value is unset. |
words[] |
A list of the word-specific information for each word in the segment. |
language_code |
The language code of this segment as a BCP-47 language tag. Example: "en-US". |
channel_tag |
For conversations derived from multi-channel audio, this is the channel number corresponding to the audio from that channel. For audioChannelCount = N, its output values can range from '1' to 'N'. A channel tag of 0 indicates that the audio is mono. |
segment_participant |
The participant of this segment. |
dialogflow_segment_metadata |
CCAI metadata relating to the current transcript segment. |
sentiment |
The sentiment for this transcript segment. |
DialogflowSegmentMetadata
Metadata from Dialogflow relating to the current transcript segment.
Fields | |
---|---|
smart_reply_allowlist_covered |
Whether the transcript segment was covered under the configured smart reply allowlist in Agent Assist. |
WordInfo
Word-level info for words in a transcript.
Fields | |
---|---|
start_offset |
Time offset of the start of this word relative to the beginning of the total conversation. |
end_offset |
Time offset of the end of this word relative to the beginning of the total conversation. |
word |
The word itself. Includes punctuation marks that surround the word. |
confidence |
A confidence estimate between 0.0 and 1.0 of the fidelity of this word. A default value of 0.0 indicates that the value is unset. |
ConversationDataSource
The conversation source, which is a combination of transcript and audio.
Fields | |
---|---|
Union field source . The source of the conversation. source can be only one of the following: |
|
gcs_source |
A Cloud Storage location specification for the audio and transcript. |
dialogflow_source |
The source when the conversation comes from Dialogflow. |
ConversationLevelSentiment
One channel of conversation-level sentiment data.
Fields | |
---|---|
channel_tag |
The channel of the audio that the data applies to. |
sentiment_data |
Data specifying sentiment. |
ConversationParticipant
The call participant speaking for a given utterance.
Fields | |
---|---|
dialogflow_participant |
Deprecated. Use |
obfuscated_external_user_id |
Obfuscated user ID from Dialogflow. |
role |
The role of the participant. |
Union field
|
|
dialogflow_participant_name |
The name of the participant provided by Dialogflow. Format: projects/{project}/locations/{location}/conversations/{conversation}/participants/{participant} |
user_id |
A user-specified ID representing the participant. |
Role
The role of the participant.
Enums | |
---|---|
ROLE_UNSPECIFIED |
Participant's role is not set. |
HUMAN_AGENT |
Participant is a human agent. |
AUTOMATED_AGENT |
Participant is an automated agent. |
END_USER |
Participant is an end user who conversed with the contact center. |
ANY_AGENT |
Participant is either a human or automated agent. |
ConversationView
Represents the options for viewing a conversation.
Enums | |
---|---|
CONVERSATION_VIEW_UNSPECIFIED |
The conversation view is not specified.
|
FULL |
Populates all fields in the conversation. |
BASIC |
Populates all fields in the conversation except the transcript. |
CreateAnalysisOperationMetadata
Metadata for a create analysis operation.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
conversation |
Output only. The Conversation that this Analysis Operation belongs to. |
CreateAnalysisRequest
The request to create an analysis.
Fields | |
---|---|
parent |
Required. The parent resource of the analysis. |
analysis |
Required. The analysis to create. |
CreateConversationRequest
Request to create a conversation.
Fields | |
---|---|
parent |
Required. The parent resource of the conversation. |
conversation |
Required. The conversation resource to create. |
conversation_id |
A unique ID for the new conversation. This ID will become the final component of the conversation's resource name. If no ID is specified, a server-generated ID will be used. This value should be 4-64 characters and must match the regular expression |
CreateIssueModelMetadata
Metadata for creating an issue model.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
The original request for creation. |
CreateIssueModelRequest
The request to create an issue model.
Fields | |
---|---|
parent |
Required. The parent resource of the issue model. |
issue_model |
Required. The issue model to create. |
CreatePhraseMatcherRequest
Request to create a phrase matcher.
Fields | |
---|---|
parent |
Required. The parent resource of the phrase matcher. Required. The location to create a phrase matcher for. Format: |
phrase_matcher |
Required. The phrase matcher resource to create. |
CreateViewRequest
The request to create a view.
Fields | |
---|---|
parent |
Required. The parent resource of the view. Required. The location to create a view for. Format: |
view |
Required. The view resource to create. |
DeleteAnalysisRequest
The request to delete an analysis.
Fields | |
---|---|
name |
Required. The name of the analysis to delete. |
DeleteConversationRequest
The request to delete a conversation.
Fields | |
---|---|
name |
Required. The name of the conversation to delete. |
force |
If set to true, all of this conversation's analyses will also be deleted. Otherwise, the request will only succeed if the conversation has no analyses. |
DeleteIssueModelMetadata
Metadata for deleting an issue model.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
The original request for deletion. |
DeleteIssueModelRequest
The request to delete an issue model.
Fields | |
---|---|
name |
Required. The name of the issue model to delete. |
DeletePhraseMatcherRequest
The request to delete a phrase matcher.
Fields | |
---|---|
name |
Required. The name of the phrase matcher to delete. |
DeleteViewRequest
The request to delete a view.
Fields | |
---|---|
name |
Required. The name of the view to delete. |
DeployIssueModelMetadata
Metadata for deploying an issue model.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
The original request for deployment. |
DeployIssueModelRequest
The request to deploy an issue model.
Fields | |
---|---|
name |
Required. The issue model to deploy. |
DeployIssueModelResponse
The response to deploy an issue model.
DialogflowIntent
The data for a Dialogflow intent. Represents a detected intent in the conversation, e.g. MAKES_PROMISE.
Fields | |
---|---|
display_name |
The human-readable name of the intent. |
DialogflowInteractionData
Dialogflow interaction data.
Fields | |
---|---|
dialogflow_intent_id |
The Dialogflow intent resource path. Format: projects/{project}/agent/{agent}/intents/{intent} |
confidence |
The confidence of the match ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
DialogflowSource
A Dialogflow source of conversation data.
Fields | |
---|---|
dialogflow_conversation |
Output only. The name of the Dialogflow conversation that this conversation resource is derived from. Format: projects/{project}/locations/{location}/conversations/{conversation} |
audio_uri |
Cloud Storage URI that points to a file that contains the conversation audio. |
Entity
The data for an entity annotation. Represents a phrase in the conversation that is a known entity, such as a person, an organization, or location.
Fields | |
---|---|
display_name |
The representative name for the entity. |
type |
The entity type. |
metadata |
Metadata associated with the entity. For most entity types, the metadata is a Wikipedia URL ( |
salience |
The salience score associated with the entity in the [0, 1.0] range. The salience score for an entity provides information about the importance or centrality of that entity to the entire document text. Scores closer to 0 are less salient, while scores closer to 1.0 are highly salient. |
sentiment |
The aggregate sentiment expressed for this entity in the conversation. |
Type
The type of the entity. For most entity types, the associated metadata is a Wikipedia URL (wikipedia_url
) and Knowledge Graph MID (mid
). The table below lists the associated fields for entities that have different metadata.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Unspecified. |
PERSON |
Person. |
LOCATION |
Location. |
ORGANIZATION |
Organization. |
EVENT |
Event. |
WORK_OF_ART |
Artwork. |
CONSUMER_GOOD |
Consumer product. |
OTHER |
Other types of entities. |
PHONE_NUMBER |
Phone number. The metadata lists the phone number (formatted according to local convention), plus whichever additional elements appear in the text:
|
ADDRESS |
Address. The metadata identifies the street number and locality plus whichever additional elements appear in the text:
|
DATE |
Date. The metadata identifies the components of the date:
|
NUMBER |
Number. The metadata is the number itself. |
PRICE |
Price. The metadata identifies the |
EntityMentionData
The data for an entity mention annotation. This represents a mention of an Entity
in the conversation.
Fields | |
---|---|
entity_unique_id |
The key of this entity in conversation entities. Can be used to retrieve the exact |
type |
The type of the entity mention. |
sentiment |
Sentiment expressed for this mention of the entity. |
MentionType
The supported types of mentions.
Enums | |
---|---|
MENTION_TYPE_UNSPECIFIED |
Unspecified. |
PROPER |
Proper noun. |
COMMON |
Common noun (or noun compound). |
ExactMatchConfig
Exact match configuration.
Fields | |
---|---|
case_sensitive |
Whether to consider case sensitivity when performing an exact match. |
ExportInsightsDataMetadata
Metadata for an export insights operation.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
The original request for export. |
partial_errors[] |
Partial errors during export operation that might cause the operation output to be incomplete. |
ExportInsightsDataRequest
The request to export insights.
Fields | |
---|---|
parent |
Required. The parent resource to export data from. |
filter |
A filter to reduce results to a specific subset. Useful for exporting conversations with specific properties. |
kms_key |
A fully qualified KMS key name for BigQuery tables protected by CMEK. Format: projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}/cryptoKeyVersions/{version} |
write_disposition |
Options for what to do if the destination table already exists. |
big_query_destination |
Specified if sink is a BigQuery table. |
BigQueryDestination
A BigQuery Table Reference.
Fields | |
---|---|
project_id |
A project ID or number. If specified, then export will attempt to write data to this project instead of the resource project. Otherwise, the resource project will be used. |
dataset |
Required. The name of the BigQuery dataset that the snapshot result should be exported to. If this dataset does not exist, the export call returns an INVALID_ARGUMENT error. |
table |
The BigQuery table name to which the insights data should be written. If this table does not exist, the export call returns an INVALID_ARGUMENT error. |
WriteDisposition
Specifies the action that occurs if the destination table already exists.
Enums | |
---|---|
WRITE_DISPOSITION_UNSPECIFIED |
Write disposition is not specified. Defaults to WRITE_TRUNCATE. |
WRITE_TRUNCATE |
If the table already exists, BigQuery will overwrite the table data and use the schema from the load. |
WRITE_APPEND |
If the table already exists, BigQuery will append data to the table. |
ExportInsightsDataResponse
Response for an export insights operation.
FaqAnswerData
Agent Assist frequently-asked-question answer data.
Fields | |
---|---|
answer |
The piece of text from the |
confidence_score |
The system's confidence score that this answer is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
question |
The corresponding FAQ question. |
metadata |
Map that contains metadata about the FAQ answer and the document that it originates from. |
query_record |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record} |
source |
The knowledge document that this answer was extracted from. Format: projects/{project}/knowledgeBases/{knowledge_base}/documents/{document}. |
GcsSource
A Cloud Storage source of conversation data.
Fields | |
---|---|
audio_uri |
Cloud Storage URI that points to a file that contains the conversation audio. |
transcript_uri |
Immutable. Cloud Storage URI that points to a file that contains the conversation transcript. |
GetAnalysisRequest
The request to get an analysis.
Fields | |
---|---|
name |
Required. The name of the analysis to get. |
GetConversationRequest
The request to get a conversation.
Fields | |
---|---|
name |
Required. The name of the conversation to get. |
view |
The level of details of the conversation. Default is |
GetIssueModelRequest
The request to get an issue model.
Fields | |
---|---|
name |
Required. The name of the issue model to get. |
GetIssueRequest
The request to get an issue.
Fields | |
---|---|
name |
Required. The name of the issue to get. |
GetPhraseMatcherRequest
The request to get a a phrase matcher.
Fields | |
---|---|
name |
Required. The name of the phrase matcher to get. |
GetSettingsRequest
The request to get project-level settings.
Fields | |
---|---|
name |
Required. The name of the settings resource to get. |
GetViewRequest
The request to get a view.
Fields | |
---|---|
name |
Required. The name of the view to get. |
HoldData
The data for a hold annotation.
Intent
The data for an intent. Represents a detected intent in the conversation, for example MAKES_PROMISE.
Fields | |
---|---|
id |
The unique identifier of the intent. |
display_name |
The human-readable name of the intent. |
IntentMatchData
The data for an intent match. Represents an intent match for a text segment in the conversation. A text segment can be part of a sentence, a complete sentence, or an utterance with multiple sentences.
Fields | |
---|---|
intent_unique_id |
The id of the matched intent. Can be used to retrieve the corresponding intent information. |
InterruptionData
The data for an interruption annotation.
Issue
The issue resource.
Fields | |
---|---|
name |
Immutable. The resource name of the issue. Format: projects/{project}/locations/{location}/issueModels/{issue_model}/issues/{issue} |
display_name |
The representative name for the issue. |
create_time |
Output only. The time at which this issue was created. |
update_time |
Output only. The most recent time that this issue was updated. |
IssueAssignment
Information about the issue.
Fields | |
---|---|
issue |
Resource name of the assigned issue. |
score |
Score indicating the likelihood of the issue assignment. currently bounded on [0,1]. |
display_name |
Immutable. Display name of the assigned issue. This field is set at time of analyis and immutable since then. |
IssueModel
The issue model resource.
Fields | |
---|---|
name |
Immutable. The resource name of the issue model. Format: projects/{project}/locations/{location}/issueModels/{issue_model} |
display_name |
The representative name for the issue model. |
create_time |
Output only. The time at which this issue model was created. |
update_time |
Output only. The most recent time at which the issue model was updated. |
state |
Output only. State of the model. |
input_data_config |
Configs for the input data that used to create the issue model. |
training_stats |
Output only. Immutable. The issue model's label statistics on its training data. |
InputDataConfig
Configs for the input data used to create the issue model.
Fields | |
---|---|
medium |
Medium of conversations used in training data. This field is being deprecated. To specify the medium to be used in training a new issue model, set the |
training_conversations_count |
Output only. Number of conversations used in training. Output only. |
filter |
A filter to reduce the conversations used for training the model to a specific subset. |
State
State of the model.
Enums | |
---|---|
STATE_UNSPECIFIED |
Unspecified. |
UNDEPLOYED |
Model is not deployed but is ready to deploy. |
DEPLOYING |
Model is being deployed. |
DEPLOYED |
Model is deployed and is ready to be used. A model can only be used in analysis if it's in this state. |
UNDEPLOYING |
Model is being undeployed. |
DELETING |
Model is being deleted. |
IssueModelLabelStats
Aggregated statistics about an issue model.
Fields | |
---|---|
analyzed_conversations_count |
Number of conversations the issue model has analyzed at this point in time. |
unclassified_conversations_count |
Number of analyzed conversations for which no issue was applicable at this point in time. |
issue_stats |
Statistics on each issue. Key is the issue's resource name. |
IssueStats
Aggregated statistics about an issue.
Fields | |
---|---|
issue |
Issue resource. Format: projects/{project}/locations/{location}/issueModels/{issue_model}/issues/{issue} |
labeled_conversations_count |
Number of conversations attached to the issue at this point in time. |
display_name |
Display name of the issue. |
IssueModelResult
Issue Modeling result on a conversation.
Fields | |
---|---|
issue_model |
Issue model that generates the result. Format: projects/{project}/locations/{location}/issueModels/{issue_model} |
issues[] |
All the matched issues. |
ListAnalysesRequest
The request to list analyses.
Fields | |
---|---|
parent |
Required. The parent resource of the analyses. |
page_size |
The maximum number of analyses to return in the response. If this value is zero, the service will select a default size. A call might return fewer objects than requested. A non-empty |
page_token |
The value returned by the last |
filter |
A filter to reduce results to a specific subset. Useful for querying conversations with specific properties. |
ListAnalysesResponse
The response to list analyses.
Fields | |
---|---|
analyses[] |
The analyses that match the request. |
next_page_token |
A token, which can be sent as |
ListConversationsRequest
Request to list conversations.
Fields | |
---|---|
parent |
Required. The parent resource of the conversation. |
page_size |
The maximum number of conversations to return in the response. A valid page size ranges from 0 to 1,000 inclusive. If the page size is zero or unspecified, a default page size of 100 will be chosen. Note that a call might return fewer results than the requested page size. |
page_token |
The value returned by the last |
filter |
A filter to reduce results to a specific subset. Useful for querying conversations with specific properties. |
view |
The level of details of the conversation. Default is |
ListConversationsResponse
The response of listing conversations.
Fields | |
---|---|
conversations[] |
The conversations that match the request. |
next_page_token |
A token which can be sent as |
ListIssueModelsRequest
Request to list issue models.
Fields | |
---|---|
parent |
Required. The parent resource of the issue model. |
ListIssueModelsResponse
The response of listing issue models.
Fields | |
---|---|
issue_models[] |
The issue models that match the request. |
ListIssuesRequest
Request to list issues.
Fields | |
---|---|
parent |
Required. The parent resource of the issue. |
ListIssuesResponse
The response of listing issues.
Fields | |
---|---|
issues[] |
The issues that match the request. |
ListPhraseMatchersRequest
Request to list phrase matchers.
Fields | |
---|---|
parent |
Required. The parent resource of the phrase matcher. |
page_size |
The maximum number of phrase matchers to return in the response. If this value is zero, the service will select a default size. A call might return fewer objects than requested. A non-empty |
page_token |
The value returned by the last |
filter |
A filter to reduce results to a specific subset. Useful for querying phrase matchers with specific properties. |
ListPhraseMatchersResponse
The response of listing phrase matchers.
Fields | |
---|---|
phrase_matchers[] |
The phrase matchers that match the request. |
next_page_token |
A token, which can be sent as |
ListViewsRequest
The request to list views.
Fields | |
---|---|
parent |
Required. The parent resource of the views. |
page_size |
The maximum number of views to return in the response. If this value is zero, the service will select a default size. A call may return fewer objects than requested. A non-empty |
page_token |
The value returned by the last |
ListViewsResponse
The response of listing views.
Fields | |
---|---|
views[] |
The views that match the request. |
next_page_token |
A token, which can be sent as |
PhraseMatchData
The data for a matched phrase matcher. Represents information identifying a phrase matcher for a given match.
Fields | |
---|---|
phrase_matcher |
The unique identifier (the resource name) of the phrase matcher. |
display_name |
The human-readable name of the phrase matcher. |
PhraseMatchRule
The data for a phrase match rule.
Fields | |
---|---|
query |
Required. The phrase to be matched. |
negated |
Specifies whether the phrase must be missing from the transcript segment or present in the transcript segment. |
config |
Provides additional information about the rule that specifies how to apply the rule. |
PhraseMatchRuleConfig
Configuration information of a phrase match rule.
Fields | |
---|---|
exact_match_config |
The configuration for the exact match rule. |
PhraseMatchRuleGroup
A message representing a rule in the phrase matcher.
Fields | |
---|---|
type |
Required. The type of this phrase match rule group. |
phrase_match_rules[] |
A list of phase match rules that are included in this group. |
PhraseMatchRuleGroupType
Specifies how to combine each phrase match rule for whether there is a match.
Enums | |
---|---|
PHRASE_MATCH_RULE_GROUP_TYPE_UNSPECIFIED |
Unspecified. |
ALL_OF |
Must meet all phrase match rules or there is no match. |
ANY_OF |
If any of the phrase match rules are met, there is a match. |
PhraseMatcher
The phrase matcher resource.
Fields | |
---|---|
name |
The resource name of the phrase matcher. Format: projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher} |
revision_id |
Output only. Immutable. The revision ID of the phrase matcher. A new revision is committed whenever the matcher is changed, except when it is activated or deactivated. A server generated random ID will be used. Example: locations/global/phraseMatchers/my-first-matcher@1234567 |
version_tag |
The customized version tag to use for the phrase matcher. If not specified, it will default to |
revision_create_time |
Output only. The timestamp of when the revision was created. It is also the create time when a new matcher is added. |
display_name |
The human-readable name of the phrase matcher. |
type |
Required. The type of this phrase matcher. |
active |
Applies the phrase matcher only when it is active. |
phrase_match_rule_groups[] |
A list of phase match rule groups that are included in this matcher. |
activation_update_time |
Output only. The most recent time at which the activation status was updated. |
role_match |
The role whose utterances the phrase matcher should be matched against. If the role is ROLE_UNSPECIFIED it will be matched against any utterances in the transcript. |
update_time |
Output only. The most recent time at which the phrase matcher was updated. |
PhraseMatcherType
Specifies how to combine each phrase match rule group to determine whether there is a match.
Enums | |
---|---|
PHRASE_MATCHER_TYPE_UNSPECIFIED |
Unspecified. |
ALL_OF |
Must meet all phrase match rule groups or there is no match. |
ANY_OF |
If any of the phrase match rule groups are met, there is a match. |
RuntimeAnnotation
An annotation that was generated during the customer and agent interaction.
Fields | |
---|---|
annotation_id |
The unique identifier of the annotation. Format: projects/{project}/locations/{location}/conversationDatasets/{dataset}/conversationDataItems/{data_item}/conversationAnnotations/{annotation} |
create_time |
The time at which this annotation was created. |
start_boundary |
The boundary in the conversation where the annotation starts, inclusive. |
end_boundary |
The boundary in the conversation where the annotation ends, inclusive. |
answer_feedback |
The feedback that the customer has about the answer in |
Union field data . The data in the annotation. data can be only one of the following: |
|
article_suggestion |
Agent Assist Article Suggestion data. |
faq_answer |
Agent Assist FAQ answer data. |
smart_reply |
Agent Assist Smart Reply data. |
smart_compose_suggestion |
Agent Assist Smart Compose suggestion data. |
dialogflow_interaction |
Dialogflow interaction data. |
SentimentData
The data for a sentiment annotation.
Fields | |
---|---|
magnitude |
A non-negative number from 0 to infinity which represents the abolute magnitude of sentiment regardless of score. |
score |
The sentiment score between -1.0 (negative) and 1.0 (positive). |
Settings
The settings resource.
Fields | |
---|---|
name |
Immutable. The resource name of the settings resource. Format: projects/{project}/locations/{location}/settings |
create_time |
Output only. The time at which the settings was created. |
update_time |
Output only. The time at which the settings were last updated. |
language_code |
A language code to be applied to each transcript segment unless the segment already specifies a language code. Language code defaults to "en-US" if it is neither specified on the segment nor here. |
conversation_ttl |
The default TTL for newly-created conversations. If a conversation has a specified expiration, that value will be used instead. Changing this value will not change the expiration of existing conversations. Conversations with no expire time persist until they are deleted. |
pubsub_notification_settings |
A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are:
Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic} |
analysis_config |
Default analysis settings. |
AnalysisConfig
Default configuration when creating Analyses in Insights.
Fields | |
---|---|
runtime_integration_analysis_percentage |
Percentage of conversations created using Dialogflow runtime integration to analyze automatically, between [0, 100]. |
SilenceData
The data for a silence annotation.
SmartComposeSuggestionData
Agent Assist Smart Compose suggestion data.
Fields | |
---|---|
suggestion |
The content of the suggestion. |
confidence_score |
The system's confidence score that this suggestion is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
metadata |
Map that contains metadata about the Smart Compose suggestion and the document from which it originates. |
query_record |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record} |
SmartReplyData
Agent Assist Smart Reply data.
Fields | |
---|---|
reply |
The content of the reply. |
confidence_score |
The system's confidence score that this reply is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
metadata |
Map that contains metadata about the Smart Reply and the document from which it originates. |
query_record |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record} |
UndeployIssueModelMetadata
Metadata for undeploying an issue model.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
The original request for undeployment. |
UndeployIssueModelRequest
The request to undeploy an issue model.
Fields | |
---|---|
name |
Required. The issue model to undeploy. |
UndeployIssueModelResponse
The response to undeploy an issue model.
UpdateConversationRequest
The request to update a conversation.
Fields | |
---|---|
conversation |
Required. The new values for the conversation. |
update_mask |
The list of fields to be updated. |
UpdateIssueModelRequest
The request to update an issue model.
Fields | |
---|---|
issue_model |
Required. The new values for the issue model. |