Index
ContactCenterInsights
(interface)Analysis
(message)AnalysisResult
(message)AnalysisResult.CallAnalysisMetadata
(message)AnnotationBoundary
(message)AnnotatorSelector
(message)AnnotatorSelector.SummarizationConfig
(message)AnnotatorSelector.SummarizationConfig.SummarizationModel
(enum)AnswerFeedback
(message)AnswerFeedback.CorrectnessLevel
(enum)ArticleSuggestionData
(message)BulkAnalyzeConversationsMetadata
(message)BulkAnalyzeConversationsRequest
(message)BulkAnalyzeConversationsResponse
(message)BulkDeleteConversationsMetadata
(message)BulkDeleteConversationsRequest
(message)BulkDeleteConversationsResponse
(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.QualityMetadata
(message)Conversation.QualityMetadata.AgentInfo
(message)Conversation.Transcript
(message)Conversation.Transcript.TranscriptSegment
(message)Conversation.Transcript.TranscriptSegment.DialogflowSegmentMetadata
(message)Conversation.Transcript.TranscriptSegment.WordInfo
(message)ConversationDataSource
(message)ConversationLevelSentiment
(message)ConversationLevelSilence
(message)ConversationParticipant
(message)ConversationParticipant.Role
(enum)ConversationSummarizationSuggestionData
(message)ConversationView
(enum)CreateAnalysisOperationMetadata
(message)CreateAnalysisRequest
(message)CreateConversationRequest
(message)CreateIssueModelMetadata
(message)CreateIssueModelRequest
(message)CreatePhraseMatcherRequest
(message)CreateViewRequest
(message)DeleteAnalysisRequest
(message)DeleteConversationRequest
(message)DeleteIssueModelMetadata
(message)DeleteIssueModelRequest
(message)DeleteIssueRequest
(message)DeletePhraseMatcherRequest
(message)DeleteViewRequest
(message)DeployIssueModelMetadata
(message)DeployIssueModelRequest
(message)DeployIssueModelResponse
(message)DialogflowIntent
(message)DialogflowInteractionData
(message)DialogflowSource
(message)EncryptionSpec
(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)ExportIssueModelMetadata
(message)ExportIssueModelRequest
(message)ExportIssueModelRequest.GcsDestination
(message)ExportIssueModelResponse
(message)FaqAnswerData
(message)GcsSource
(message)GetAnalysisRequest
(message)GetConversationRequest
(message)GetEncryptionSpecRequest
(message)GetIssueModelRequest
(message)GetIssueRequest
(message)GetPhraseMatcherRequest
(message)GetSettingsRequest
(message)GetViewRequest
(message)HoldData
(message)ImportIssueModelMetadata
(message)ImportIssueModelRequest
(message)ImportIssueModelRequest.GcsSource
(message)ImportIssueModelResponse
(message)IngestConversationsMetadata
(message)IngestConversationsMetadata.IngestConversationsStats
(message)IngestConversationsRequest
(message)IngestConversationsRequest.ConversationConfig
(message)IngestConversationsRequest.GcsSource
(message)IngestConversationsRequest.GcsSource.BucketObjectType
(enum)IngestConversationsRequest.TranscriptObjectConfig
(message)IngestConversationsResponse
(message)InitializeEncryptionSpecMetadata
(message)InitializeEncryptionSpecRequest
(message)InitializeEncryptionSpecResponse
(message)Intent
(message)IntentMatchData
(message)InterruptionData
(message)Issue
(message)IssueAssignment
(message)IssueMatchData
(message)IssueModel
(message)IssueModel.InputDataConfig
(message)IssueModel.ModelType
(enum)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)RedactionConfig
(message)RuntimeAnnotation
(message)RuntimeAnnotation.UserInput
(message)RuntimeAnnotation.UserInput.QuerySource
(enum)SentimentData
(message)Settings
(message)Settings.AnalysisConfig
(message)SilenceData
(message)SmartComposeSuggestionData
(message)SmartReplyData
(message)SpeechConfig
(message)UndeployIssueModelMetadata
(message)UndeployIssueModelRequest
(message)UndeployIssueModelResponse
(message)UpdateConversationRequest
(message)UpdateIssueModelRequest
(message)UpdateIssueRequest
(message)UpdatePhraseMatcherRequest
(message)UpdateSettingsRequest
(message)UpdateViewRequest
(message)UploadConversationMetadata
(message)UploadConversationRequest
(message)View
(message)
ContactCenterInsights
An API that lets users analyze and explore their business conversation data.
BulkAnalyzeConversations |
---|
Analyzes multiple conversations in a single request.
|
BulkDeleteConversations |
---|
Deletes multiple conversations in a single request.
|
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. Note that this method does not support audio transcription or redaction. Use
|
CreateIssueModel |
---|
Creates an issue model.
|
CreatePhraseMatcher |
---|
Creates a phrase matcher.
|
CreateView |
---|
Creates a view.
|
DeleteAnalysis |
---|
Deletes an analysis.
|
DeleteConversation |
---|
Deletes a conversation.
|
DeleteIssue |
---|
Deletes an issue.
|
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.
|
ExportIssueModel |
---|
Exports an issue model to the provided destination.
|
GetAnalysis |
---|
Gets an analysis.
|
GetConversation |
---|
Gets a conversation.
|
GetEncryptionSpec |
---|
Gets location-level encryption key specification.
|
GetIssue |
---|
Gets an issue.
|
GetIssueModel |
---|
Gets an issue model.
|
GetPhraseMatcher |
---|
Gets a phrase matcher.
|
GetSettings |
---|
Gets project-level settings.
|
GetView |
---|
Gets a view.
|
ImportIssueModel |
---|
Imports an issue model from a Cloud Storage bucket.
|
IngestConversations |
---|
Imports conversations and processes them according to the user's configuration.
|
InitializeEncryptionSpec |
---|
Initializes a location-level encryption key specification. An error will result if the location has resources already created before the initialization. After the encryption specification is initialized at a location, it is immutable and all newly created resources under the location will be encrypted with the existing specification.
|
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.
|
UploadConversation |
---|
Create a long-running conversation upload operation. This method differs from
|
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. |
annotator_selector |
To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run. |
AnalysisResult
The result of an analysis.
Fields | |
---|---|
end_time |
The time at which the analysis ended. |
Union field metadata . Metadata discovered during analysis. metadata can be only one of the following: |
|
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. |
silence |
Overall conversation-level silence during 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. |
Union field detailed_boundary . A detailed boundary, which describes a more specific point. detailed_boundary can be only one of the following: |
|
word_index |
The word index of this boundary with respect to the first word in the transcript piece. This index starts at zero. |
AnnotatorSelector
Selector of all available annotators and phrase matchers to run.
Fields | |
---|---|
run_interruption_annotator |
Whether to run the interruption annotator. |
run_silence_annotator |
Whether to run the silence annotator. |
run_phrase_matcher_annotator |
Whether to run the active phrase matcher annotator(s). |
phrase_matchers[] |
The list of phrase matchers to run. If not provided, all active phrase matchers will be used. If inactive phrase matchers are provided, they will not be used. Phrase matchers will be run only if run_phrase_matcher_annotator is set to true. Format: projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher} |
run_sentiment_annotator |
Whether to run the sentiment annotator. |
run_entity_annotator |
Whether to run the entity annotator. |
run_intent_annotator |
Whether to run the intent annotator. |
run_issue_model_annotator |
Whether to run the issue model annotator. A model should have already been deployed for this to take effect. |
issue_models[] |
The issue model to run. If not provided, the most recently deployed topic model will be used. The provided issue model will only be used for inference if the issue model is deployed and if run_issue_model_annotator is set to true. If more than one issue model is provided, only the first provided issue model will be used for inference. |
run_summarization_annotator |
Whether to run the summarization annotator. |
summarization_config |
Configuration for the summarization annotator. |
SummarizationConfig
Configuration for summarization.
Fields | |
---|---|
Union field model_source . Summarization must use either a preexisting conversation profile or one of the supported default models. model_source can be only one of the following: |
|
conversation_profile |
Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile} |
summarization_model |
Default summarization model to be used. |
SummarizationModel
Summarization model to use, if conversation_profile
is not used.
Enums | |
---|---|
SUMMARIZATION_MODEL_UNSPECIFIED |
Unspecified summarization model. |
BASELINE_MODEL |
The CCAI baseline model. |
BASELINE_MODEL_V2_0 |
The CCAI baseline model, V2.0. |
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} |
BulkAnalyzeConversationsMetadata
The metadata for a bulk analyze conversations operation.
Fields | |
---|---|
create_time |
The time the operation was created. |
end_time |
The time the operation finished running. |
request |
The original request for bulk analyze. |
completed_analyses_count |
The number of requested analyses that have completed successfully so far. |
failed_analyses_count |
The number of requested analyses that have failed so far. |
total_requested_analyses_count |
Total number of analyses requested. Computed by the number of conversations returned by |
partial_errors[] |
Output only. Partial errors during bulk analyze operation that might cause the operation output to be incomplete. |
BulkAnalyzeConversationsRequest
The request to analyze conversations in bulk.
Fields | |
---|---|
parent |
Required. The parent resource to create analyses in. |
filter |
Required. Filter used to select the subset of conversations to analyze. |
analysis_percentage |
Required. Percentage of selected conversation to analyze, between [0, 100]. |
annotator_selector |
To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run. |
BulkAnalyzeConversationsResponse
The response for a bulk analyze conversations operation.
Fields | |
---|---|
successful_analysis_count |
Count of successful analyses. |
failed_analysis_count |
Count of failed analyses. |
BulkDeleteConversationsMetadata
The metadata for a bulk delete conversations operation.
Fields | |
---|---|
create_time |
The time the operation was created. |
end_time |
The time the operation finished running. |
request |
The original request for bulk delete. |
partial_errors[] |
Partial errors during bulk delete conversations operation that might cause the operation output to be incomplete. |
BulkDeleteConversationsRequest
The request to delete conversations in bulk.
Fields | |
---|---|
parent |
Required. The parent resource to delete conversations from. Format: projects/{project}/locations/{location} |
filter |
Filter used to select the subset of conversations to delete. |
max_delete_count |
Maximum number of conversations 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. |
BulkDeleteConversationsResponse
This type has no fields.
The response for a bulk delete conversations operation.
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. |
issue_match_data |
Data specifying an issue 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. |
quality_metadata |
Conversation metadata related to quality management. |
metadata_json |
Input only. JSON metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insight's supported formats. |
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. |
latest_summary |
Output only. Latest summary of the conversation. |
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. |
Union field metadata . Metadata that applies to the conversation. metadata can be only one of the following: |
|
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. |
QualityMetadata
Conversation metadata related to quality management.
Fields | |
---|---|
customer_satisfaction_rating |
An arbitrary integer value indicating the customer's satisfaction rating. |
wait_duration |
The amount of time the customer waited to connect with an agent. |
menu_path |
An arbitrary string value specifying the menu path the customer took. |
agent_info[] |
Information about agents involved in the call. |
AgentInfo
Information about an agent involved in the conversation.
Fields | |
---|---|
agent_id |
A user-specified string representing the agent. |
display_name |
The agent's name. |
team |
A user-specified string representing the agent's team. |
disposition_code |
A user-provided string indicating the outcome of the agent's segment of the call. |
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. |
ConversationLevelSilence
Conversation-level silence data.
Fields | |
---|---|
silence_duration |
Amount of time calculated to be in silence. |
silence_percentage |
Percentage of the total conversation spent in silence. |
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. |
ConversationSummarizationSuggestionData
Conversation summarization suggestion data.
Fields | |
---|---|
text |
The summarization content that is concatenated into one string. |
text_sections |
The summarization content that is divided into sections. The key is the section's name and the value is the section's content. There is no specific format for the key or value. |
confidence |
The confidence score of the summarization. |
metadata |
A map that contains metadata about the summarization and the document from which it originates. |
answer_record |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answer_record} |
conversation_model |
The name of the model that generates this summary. Format: projects/{project}/locations/{location}/conversationModels/{conversation_model} |
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. |
annotator_selector |
Output only. The annotator selector used for the analysis (if any). |
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. |
DeleteIssueRequest
The request to delete an issue.
Fields | |
---|---|
name |
Required. The name of the issue 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
This type has no fields.
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. |
EncryptionSpec
A customer-managed encryption key specification that can be applied to all created resources (e.g. Conversation
).
Fields | |
---|---|
name |
Immutable. The resource name of the encryption key specification resource. Format: projects/{project}/locations/{location}/encryptionSpec |
kms_key |
Required. The name of customer-managed encryption key that is used to secure a resource and its sub-resources. If empty, the resource is secured by our default encryption key. Only the key in the same location as this resource is allowed to be used for encryption. Format: |
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. |
Union field destination . Exporter destination. destination can be only one of the following: |
|
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
This type has no fields.
Response for an export insights operation.
ExportIssueModelMetadata
Metadata used for export issue model.
Fields | |
---|---|
create_time |
The time the operation was created. |
end_time |
The time the operation finished running. |
request |
The original export request. |
ExportIssueModelRequest
Request to export an issue model.
Fields | |
---|---|
name |
Required. The issue model to export. |
Union field
|
|
gcs_destination |
Google Cloud Storage URI to export the issue model to. |
GcsDestination
Google Cloud Storage Object URI to save the issue model to.
Fields | |
---|---|
object_uri |
Required. Format: |
ExportIssueModelResponse
This type has no fields.
Response from export issue model
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 |
GetEncryptionSpecRequest
The request to get location-level encryption specification.
Fields | |
---|---|
name |
Required. The name of the encryption spec resource to get. |
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
This type has no fields.
The data for a hold annotation.
ImportIssueModelMetadata
Metadata used for import issue model.
Fields | |
---|---|
create_time |
The time the operation was created. |
end_time |
The time the operation finished running. |
request |
The original import request. |
ImportIssueModelRequest
Request to import an issue model.
Fields | |
---|---|
parent |
Required. The parent resource of the issue model. |
create_new_model |
Optional. If set to true, will create an issue model from the imported file with randomly generated IDs for the issue model and corresponding issues. Otherwise, replaces an existing model with the same ID as the file. |
Union field
|
|
gcs_source |
Google Cloud Storage source message. |
GcsSource
Google Cloud Storage Object URI to get the issue model file from.
Fields | |
---|---|
object_uri |
Required. Format: |
ImportIssueModelResponse
This type has no fields.
Response from import issue model
IngestConversationsMetadata
The metadata for an IngestConversations operation.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
Output only. The original request for ingest. |
partial_errors[] |
Output only. Partial errors during ingest operation that might cause the operation output to be incomplete. |
ingest_conversations_stats |
Output only. Statistics for IngestConversations operation. |
IngestConversationsStats
Statistics for IngestConversations operation.
Fields | |
---|---|
processed_object_count |
Output only. The number of objects processed during the ingest operation. |
duplicates_skipped_count |
Output only. The number of objects skipped because another conversation with the same transcript uri had already been ingested. |
successful_ingest_count |
Output only. The number of new conversations added during this ingest operation. |
failed_ingest_count |
Output only. The number of objects which were unable to be ingested due to errors. The errors are populated in the partial_errors field. |
IngestConversationsRequest
The request to ingest conversations.
Fields | |
---|---|
parent |
Required. The parent resource for new conversations. |
conversation_config |
Configuration that applies to all conversations. |
redaction_config |
Optional. DLP settings for transcript redaction. Optional, will default to the config specified in Settings. |
speech_config |
Optional. Default Speech-to-Text configuration. Optional, will default to the config specified in Settings. |
Union field source . Configuration for an external data store containing objects that will be converted to conversations. source can be only one of the following: |
|
gcs_source |
A cloud storage bucket source. Note that any previously ingested objects from the source will be skipped to avoid duplication. |
Union field object_config . Configuration for converting individual source objects to conversations. object_config can be only one of the following: |
|
transcript_object_config |
Configuration for when |
sample_size |
Optional. If set, this fields indicates the number of objects to ingest from the Cloud Storage bucket. If empty, the entire bucket will be ingested. Unless they are first deleted, conversations produced through sampling won't be ingested by subsequent ingest requests. |
ConversationConfig
Configuration that applies to all conversations.
Fields | |
---|---|
agent_id |
Optional. An opaque, user-specified string representing a human agent who handled all conversations in the import. Note that this will be overridden if per-conversation metadata is provided through the |
agent_channel |
Optional. Indicates which of the channels, 1 or 2, contains the agent. Note that this must be set for conversations to be properly displayed and analyzed. |
customer_channel |
Optional. Indicates which of the channels, 1 or 2, contains the agent. Note that this must be set for conversations to be properly displayed and analyzed. |
GcsSource
Configuration for Cloud Storage bucket sources.
Fields | |
---|---|
bucket_uri |
Required. The Cloud Storage bucket containing source objects. |
bucket_object_type |
Optional. Specifies the type of the objects in |
custom_metadata_keys[] |
Optional. Custom keys to extract as conversation labels from metadata files in |
metadata_bucket_uri |
Optional. The Cloud Storage path to the conversation metadata. Note that: [1] Metadata files are expected to be in JSON format. [2] Metadata and source files (transcripts or audio) must be in separate buckets. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. |
BucketObjectType
Enums | |
---|---|
BUCKET_OBJECT_TYPE_UNSPECIFIED |
The object type is unspecified and will default to TRANSCRIPT . |
TRANSCRIPT |
The object is a transcript. |
AUDIO |
The object is an audio file. |
TranscriptObjectConfig
Configuration for processing transcript objects.
Fields | |
---|---|
medium |
Required. The medium transcript objects represent. |
IngestConversationsResponse
This type has no fields.
The response to an IngestConversations operation.
InitializeEncryptionSpecMetadata
Metadata for initializing a location-level encryption specification.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
Output only. The original request for initialization. |
partial_errors[] |
Partial errors during initializing operation that might cause the operation output to be incomplete. |
InitializeEncryptionSpecRequest
The request to initialize a location-level encryption specification.
Fields | |
---|---|
encryption_spec |
Required. The encryption spec used for CMEK encryption. It is required that the kms key is in the same region as the endpoint. The same key will be used for all provisioned resources, if encryption is available. If the |
InitializeEncryptionSpecResponse
This type has no fields.
The response to initialize a location-level encryption specification.
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
This type has no fields.
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. |
sample_utterances[] |
Output only. Resource names of the sample representative utterances that match to this issue. |
display_description |
Representative description of the issue. |
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. |
IssueMatchData
The data for an issue match annotation.
Fields | |
---|---|
issue_assignment |
Information about the issue's assignment. |
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. |
issue_count |
Output only. Number of issues in this issue model. |
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. |
model_type |
Type of the model. |
language_code |
Language of the model. |
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. |
ModelType
Type of the model.
Enums | |
---|---|
MODEL_TYPE_UNSPECIFIED |
Unspecified model type. |
TYPE_V1 |
Type V1. |
TYPE_V2 |
Type V2. |
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 100,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. |
order_by |
Optional. The attribute by which to order conversations in the response. If empty, conversations will be ordered by descending creation time. Supported values are one of the following:
The default sort order is ascending. To specify order, append |
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 | |
---|---|
Union field config . The configuration of the phrase match rule. config can be only one of the following: |
|
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 phrase 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. |
RedactionConfig
DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the UploadConversation
and IngestConversations
endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation
endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations, redaction should be performed in Dialogflow / Agent Assist.
Fields | |
---|---|
deidentify_template |
The fully-qualified DLP deidentify template resource name. Format: |
inspect_template |
The fully-qualified DLP inspect template resource name. Format: |
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 |
user_input |
Explicit input used for generating the answer |
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. |
conversation_summarization_suggestion |
Conversation summarization suggestion data. |
UserInput
Explicit input used for generating the answer
Fields | |
---|---|
query |
Query text. Article Search uses this to store the input query used to generate the search results. |
generator_name |
The resource name of associated generator. Format: |
query_source |
Query source for the answer. |
QuerySource
The source of the query.
Enums | |
---|---|
QUERY_SOURCE_UNSPECIFIED |
Unknown query source. |
AGENT_QUERY |
The query is from agents. |
SUGGESTED_QUERY |
The query is a query from previous suggestions, e.g. from a preceding SuggestKnowledgeAssist response. |
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 CCAI Insights project wide settings. Use these settings to configure the behavior of Insights. View these settings with getsettings
and change the settings with updateSettings
.
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. |
redaction_config |
Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the |
speech_config |
Optional. Default Speech-to-Text resources to use while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the |
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]. |
upload_conversation_analysis_percentage |
Percentage of conversations created using the UploadConversation endpoint to analyze automatically, between [0, 100]. |
annotator_selector |
To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run. |
SilenceData
This type has no fields.
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} |
SpeechConfig
Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the UploadConversation
and IngestConversations
endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation
endpoint.
Fields | |
---|---|
speech_recognizer |
The fully-qualified Speech Recognizer resource name. Format: |
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
This type has no fields.
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. All possible fields can be updated by passing
|
UpdateIssueModelRequest
The request to update an issue model.
Fields | |
---|---|
issue_model |
Required. The new values for the issue model. |
update_mask |
The list of fields to be updated. |
UpdateIssueRequest
The request to update an issue.
Fields | |
---|---|
issue |
Required. The new values for the issue. |
update_mask |
The list of fields to be updated. |
UpdatePhraseMatcherRequest
The request to update a phrase matcher.
Fields | |
---|---|
phrase_matcher |
Required. The new values for the phrase matcher. |
update_mask |
The list of fields to be updated. |
UpdateSettingsRequest
The request to update project-level settings.
Fields | |
---|---|
settings |
Required. The new settings values. |
update_mask |
Required. The list of fields to be updated. |
UpdateViewRequest
The request to update a view.
Fields | |
---|---|
view |
Required. The new view. |
update_mask |
The list of fields to be updated. |
UploadConversationMetadata
The metadata for an UploadConversation
operation.
Fields | |
---|---|
create_time |
Output only. The time the operation was created. |
end_time |
Output only. The time the operation finished running. |
request |
Output only. The original request. |
analysis_operation |
Output only. The operation name for a successfully created analysis operation, if any. |
applied_redaction_config |
Output only. The redaction config applied to the uploaded conversation. |
UploadConversationRequest
Request to upload a conversation.
Fields | |
---|---|
parent |
Required. The parent resource of the conversation. |
conversation |
Required. The conversation resource to create. |
conversation_id |
Optional. 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 |
redaction_config |
Optional. DLP settings for transcript redaction. Will default to the config specified in Settings. |
speech_config |
Optional. Speech-to-Text configuration. Will default to the config specified in Settings. |
View
The View resource.
Fields | |
---|---|
name |
Immutable. The resource name of the view. Format: projects/{project}/locations/{location}/views/{view} |
display_name |
The human-readable display name of the view. |
create_time |
Output only. The time at which this view was created. |
update_time |
Output only. The most recent time at which the view was updated. |
value |
String with specific view properties, must be non-empty. |