@google-cloud/dialogflow
Version:
Dialogflow API client for Node.js
827 lines • 107 kB
TypeScript
import type * as gax from 'google-gax';
import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback, LocationsClient, LocationProtos } from 'google-gax';
import { Transform } from 'stream';
import * as protos from '../../protos/protos';
/**
* Service for managing {@link protos.google.cloud.dialogflow.v2.Participant|Participants}.
* @class
* @memberof v2
*/
export declare class ParticipantsClient {
private _terminated;
private _opts;
private _providedCustomServicePath;
private _gaxModule;
private _gaxGrpc;
private _protos;
private _defaults;
private _universeDomain;
private _servicePath;
private _log;
auth: gax.GoogleAuth;
descriptors: Descriptors;
warn: (code: string, message: string, warnType?: string) => void;
innerApiCalls: {
[name: string]: Function;
};
locationsClient: LocationsClient;
pathTemplates: {
[name: string]: gax.PathTemplate;
};
participantsStub?: Promise<{
[name: string]: Function;
}>;
/**
* Construct an instance of ParticipantsClient.
*
* @param {object} [options] - The configuration object.
* The options accepted by the constructor are described in detail
* in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
* The common options are:
* @param {object} [options.credentials] - Credentials object.
* @param {string} [options.credentials.client_email]
* @param {string} [options.credentials.private_key]
* @param {string} [options.email] - Account email address. Required when
* using a .pem or .p12 keyFilename.
* @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
* .p12 key downloaded from the Google Developers Console. If you provide
* a path to a JSON file, the projectId option below is not necessary.
* NOTE: .pem and .p12 require you to specify options.email as well.
* @param {number} [options.port] - The port on which to connect to
* the remote host.
* @param {string} [options.projectId] - The project ID from the Google
* Developer's Console, e.g. 'grape-spaceship-123'. We will also check
* the environment variable GCLOUD_PROJECT for your project ID. If your
* app is running in an environment which supports
* {@link https://cloud.google.com/docs/authentication/application-default-credentials Application Default Credentials},
* your project ID will be detected automatically.
* @param {string} [options.apiEndpoint] - The domain name of the
* API remote host.
* @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
* Follows the structure of {@link gapicConfig}.
* @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
* For more information, please check the
* {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
* @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
* need to avoid loading the default gRPC version and want to use the fallback
* HTTP implementation. Load only fallback version and pass it to the constructor:
* ```
* const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
* const client = new ParticipantsClient({fallback: true}, gax);
* ```
*/
constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
/**
* Initialize the client.
* Performs asynchronous operations (such as authentication) and prepares the client.
* This function will be called automatically when any class method is called for the
* first time, but if you need to initialize it before calling an actual method,
* feel free to call initialize() directly.
*
* You can await on this method if you want to make sure the client is initialized.
*
* @returns {Promise} A promise that resolves to an authenticated service stub.
*/
initialize(): Promise<{
[name: string]: Function;
}>;
/**
* The DNS address for this API service.
* @deprecated Use the apiEndpoint method of the client instance.
* @returns {string} The DNS address for this service.
*/
static get servicePath(): string;
/**
* The DNS address for this API service - same as servicePath.
* @deprecated Use the apiEndpoint method of the client instance.
* @returns {string} The DNS address for this service.
*/
static get apiEndpoint(): string;
/**
* The DNS address for this API service.
* @returns {string} The DNS address for this service.
*/
get apiEndpoint(): string;
get universeDomain(): string;
/**
* The port for this API service.
* @returns {number} The default port for this service.
*/
static get port(): number;
/**
* The scopes needed to make gRPC calls for every method defined
* in this service.
* @returns {string[]} List of default scopes.
*/
static get scopes(): string[];
getProjectId(): Promise<string>;
getProjectId(callback: Callback<string, undefined, undefined>): void;
/**
* Creates a new participant in a conversation.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. Resource identifier of the conversation adding the participant.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>`.
* @param {google.cloud.dialogflow.v2.Participant} request.participant
* Required. The participant to create.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.Participant|Participant}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.create_participant.js</caption>
* region_tag:dialogflow_v2_generated_Participants_CreateParticipant_async
*/
createParticipant(request?: protos.google.cloud.dialogflow.v2.ICreateParticipantRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.IParticipant,
protos.google.cloud.dialogflow.v2.ICreateParticipantRequest | undefined,
{} | undefined
]>;
createParticipant(request: protos.google.cloud.dialogflow.v2.ICreateParticipantRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.IParticipant, protos.google.cloud.dialogflow.v2.ICreateParticipantRequest | null | undefined, {} | null | undefined>): void;
createParticipant(request: protos.google.cloud.dialogflow.v2.ICreateParticipantRequest, callback: Callback<protos.google.cloud.dialogflow.v2.IParticipant, protos.google.cloud.dialogflow.v2.ICreateParticipantRequest | null | undefined, {} | null | undefined>): void;
/**
* Retrieves a conversation participant.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The name of the participant. Format:
* `projects/<Project ID>/locations/<Location ID>/conversations/<Conversation
* ID>/participants/<Participant ID>`.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.Participant|Participant}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.get_participant.js</caption>
* region_tag:dialogflow_v2_generated_Participants_GetParticipant_async
*/
getParticipant(request?: protos.google.cloud.dialogflow.v2.IGetParticipantRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.IParticipant,
protos.google.cloud.dialogflow.v2.IGetParticipantRequest | undefined,
{} | undefined
]>;
getParticipant(request: protos.google.cloud.dialogflow.v2.IGetParticipantRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.IParticipant, protos.google.cloud.dialogflow.v2.IGetParticipantRequest | null | undefined, {} | null | undefined>): void;
getParticipant(request: protos.google.cloud.dialogflow.v2.IGetParticipantRequest, callback: Callback<protos.google.cloud.dialogflow.v2.IParticipant, protos.google.cloud.dialogflow.v2.IGetParticipantRequest | null | undefined, {} | null | undefined>): void;
/**
* Updates the specified participant.
*
* @param {Object} request
* The request object that will be sent.
* @param {google.cloud.dialogflow.v2.Participant} request.participant
* Required. The participant to update.
* @param {google.protobuf.FieldMask} request.updateMask
* Required. The mask to specify which fields to update.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.Participant|Participant}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.update_participant.js</caption>
* region_tag:dialogflow_v2_generated_Participants_UpdateParticipant_async
*/
updateParticipant(request?: protos.google.cloud.dialogflow.v2.IUpdateParticipantRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.IParticipant,
protos.google.cloud.dialogflow.v2.IUpdateParticipantRequest | undefined,
{} | undefined
]>;
updateParticipant(request: protos.google.cloud.dialogflow.v2.IUpdateParticipantRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.IParticipant, protos.google.cloud.dialogflow.v2.IUpdateParticipantRequest | null | undefined, {} | null | undefined>): void;
updateParticipant(request: protos.google.cloud.dialogflow.v2.IUpdateParticipantRequest, callback: Callback<protos.google.cloud.dialogflow.v2.IParticipant, protos.google.cloud.dialogflow.v2.IUpdateParticipantRequest | null | undefined, {} | null | undefined>): void;
/**
* Adds a text (chat, for example), or audio (phone recording, for example)
* message from a participant into the conversation.
*
* Note: Always use agent versions for production traffic
* sent to virtual agents. See [Versions and
* environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.participant
* Required. The name of the participant this text comes from.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
* @param {google.cloud.dialogflow.v2.TextInput} request.textInput
* The natural language text to be processed.
* @param {google.cloud.dialogflow.v2.AudioInput} request.audioInput
* The natural language speech audio to be processed.
* @param {google.cloud.dialogflow.v2.EventInput} request.eventInput
* An input event to send to Dialogflow.
* @param {google.cloud.dialogflow.v2.SuggestionInput} request.suggestionInput
* An input representing the selection of a suggestion.
* @param {google.cloud.dialogflow.v2.OutputAudioConfig} request.replyAudioConfig
* Speech synthesis configuration.
* The speech synthesis settings for a virtual agent that may be configured
* for the associated conversation profile are not used when calling
* AnalyzeContent. If this configuration is not supplied, speech synthesis
* is disabled.
* @param {google.cloud.dialogflow.v2.QueryParameters} request.queryParams
* Parameters for a Dialogflow virtual-agent query.
* @param {google.cloud.dialogflow.v2.AssistQueryParameters} request.assistQueryParams
* Parameters for a human assist query.
* @param {google.protobuf.Struct} request.cxParameters
* Additional parameters to be put into Dialogflow CX session parameters. To
* remove a parameter from the session, clients should explicitly set the
* parameter value to null.
*
* Note: this field should only be used if you are connecting to a Dialogflow
* CX agent.
* @param {string} request.requestId
* A unique identifier for this request. Restricted to 36 ASCII characters.
* A random UUID is recommended.
* This request is only idempotent if a `request_id` is provided.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.AnalyzeContentResponse|AnalyzeContentResponse}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.analyze_content.js</caption>
* region_tag:dialogflow_v2_generated_Participants_AnalyzeContent_async
*/
analyzeContent(request?: protos.google.cloud.dialogflow.v2.IAnalyzeContentRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.IAnalyzeContentResponse,
protos.google.cloud.dialogflow.v2.IAnalyzeContentRequest | undefined,
{} | undefined
]>;
analyzeContent(request: protos.google.cloud.dialogflow.v2.IAnalyzeContentRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.IAnalyzeContentResponse, protos.google.cloud.dialogflow.v2.IAnalyzeContentRequest | null | undefined, {} | null | undefined>): void;
analyzeContent(request: protos.google.cloud.dialogflow.v2.IAnalyzeContentRequest, callback: Callback<protos.google.cloud.dialogflow.v2.IAnalyzeContentResponse, protos.google.cloud.dialogflow.v2.IAnalyzeContentRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets suggested articles for a participant based on specific historical
* messages.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The name of the participant to fetch suggestion for.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
* @param {string} [request.latestMessage]
* Optional. The name of the latest conversation message to compile suggestion
* for. If empty, it will be the latest message of the conversation.
*
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/messages/<Message ID>`.
* @param {number} [request.contextSize]
* Optional. Max number of messages prior to and including
* {@link protos.google.cloud.dialogflow.v2.SuggestArticlesRequest.latest_message|latest_message}
* to use as context when compiling the suggestion. By default 20 and at
* most 50.
* @param {google.cloud.dialogflow.v2.AssistQueryParameters} request.assistQueryParams
* Parameters for a human assist query.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.SuggestArticlesResponse|SuggestArticlesResponse}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.suggest_articles.js</caption>
* region_tag:dialogflow_v2_generated_Participants_SuggestArticles_async
*/
suggestArticles(request?: protos.google.cloud.dialogflow.v2.ISuggestArticlesRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.ISuggestArticlesResponse,
protos.google.cloud.dialogflow.v2.ISuggestArticlesRequest | undefined,
{} | undefined
]>;
suggestArticles(request: protos.google.cloud.dialogflow.v2.ISuggestArticlesRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestArticlesResponse, protos.google.cloud.dialogflow.v2.ISuggestArticlesRequest | null | undefined, {} | null | undefined>): void;
suggestArticles(request: protos.google.cloud.dialogflow.v2.ISuggestArticlesRequest, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestArticlesResponse, protos.google.cloud.dialogflow.v2.ISuggestArticlesRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets suggested faq answers for a participant based on specific historical
* messages.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The name of the participant to fetch suggestion for.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
* @param {string} [request.latestMessage]
* Optional. The name of the latest conversation message to compile suggestion
* for. If empty, it will be the latest message of the conversation.
*
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/messages/<Message ID>`.
* @param {number} [request.contextSize]
* Optional. Max number of messages prior to and including
* [latest_message] to use as context when compiling the
* suggestion. By default 20 and at most 50.
* @param {google.cloud.dialogflow.v2.AssistQueryParameters} request.assistQueryParams
* Parameters for a human assist query.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.SuggestFaqAnswersResponse|SuggestFaqAnswersResponse}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.suggest_faq_answers.js</caption>
* region_tag:dialogflow_v2_generated_Participants_SuggestFaqAnswers_async
*/
suggestFaqAnswers(request?: protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersResponse,
protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersRequest | undefined,
{} | undefined
]>;
suggestFaqAnswers(request: protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersResponse, protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersRequest | null | undefined, {} | null | undefined>): void;
suggestFaqAnswers(request: protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersRequest, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersResponse, protos.google.cloud.dialogflow.v2.ISuggestFaqAnswersRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets smart replies for a participant based on specific historical
* messages.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The name of the participant to fetch suggestion for.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
* @param {google.cloud.dialogflow.v2.TextInput} request.currentTextInput
* The current natural language text segment to compile suggestion
* for. This provides a way for user to get follow up smart reply suggestion
* after a smart reply selection, without sending a text message.
* @param {string} request.latestMessage
* The name of the latest conversation message to compile suggestion
* for. If empty, it will be the latest message of the conversation.
*
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/messages/<Message ID>`.
* @param {number} request.contextSize
* Max number of messages prior to and including
* [latest_message] to use as context when compiling the
* suggestion. By default 20 and at most 50.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.SuggestSmartRepliesResponse|SuggestSmartRepliesResponse}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.suggest_smart_replies.js</caption>
* region_tag:dialogflow_v2_generated_Participants_SuggestSmartReplies_async
*/
suggestSmartReplies(request?: protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesResponse,
protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesRequest | undefined,
{} | undefined
]>;
suggestSmartReplies(request: protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesResponse, protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesRequest | null | undefined, {} | null | undefined>): void;
suggestSmartReplies(request: protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesRequest, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesResponse, protos.google.cloud.dialogflow.v2.ISuggestSmartRepliesRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets knowledge assist suggestions based on historical messages.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The name of the participant to fetch suggestions for.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
* @param {string} [request.latestMessage]
* Optional. The name of the latest conversation message to compile
* suggestions for. If empty, it will be the latest message of the
* conversation. Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>/messages/<Message ID>`.
* @param {number} [request.contextSize]
* Optional. Max number of messages prior to and including
* {@link protos.google.cloud.dialogflow.v2.SuggestKnowledgeAssistRequest.latest_message|latest_message}
* to use as context when compiling the suggestion. The context size is by
* default 100 and at most 100.
* @param {string} [request.previousSuggestedQuery]
* Optional. The previously suggested query for the given conversation. This
* helps identify whether the next suggestion we generate is reasonably
* different from the previous one. This is useful to avoid similar
* suggestions within the conversation.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.cloud.dialogflow.v2.SuggestKnowledgeAssistResponse|SuggestKnowledgeAssistResponse}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.suggest_knowledge_assist.js</caption>
* region_tag:dialogflow_v2_generated_Participants_SuggestKnowledgeAssist_async
*/
suggestKnowledgeAssist(request?: protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistResponse,
protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistRequest | undefined,
{} | undefined
]>;
suggestKnowledgeAssist(request: protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistRequest, options: CallOptions, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistResponse, protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistRequest | null | undefined, {} | null | undefined>): void;
suggestKnowledgeAssist(request: protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistRequest, callback: Callback<protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistResponse, protos.google.cloud.dialogflow.v2.ISuggestKnowledgeAssistRequest | null | undefined, {} | null | undefined>): void;
/**
* Adds a text (chat, for example), or audio (phone recording, for example)
* message from a participant into the conversation.
* Note: This method is only available through the gRPC API (not REST).
*
* The top-level message sent to the client by the server is
* `StreamingAnalyzeContentResponse`. Multiple response messages can be
* returned in order. The first one or more messages contain the
* `recognition_result` field. Each result represents a more complete
* transcript of what the user said. The next message contains the
* `reply_text` field and potentially the `reply_audio` field. The message can
* also contain the `automated_agent_reply` field.
*
* Note: Always use agent versions for production traffic
* sent to virtual agents. See [Versions and
* environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
*
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Stream}
* An object stream which is both readable and writable. It accepts objects
* representing {@link protos.google.cloud.dialogflow.v2.StreamingAnalyzeContentRequest|StreamingAnalyzeContentRequest} for write() method, and
* will emit objects representing {@link protos.google.cloud.dialogflow.v2.StreamingAnalyzeContentResponse|StreamingAnalyzeContentResponse} on 'data' event asynchronously.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#bi-directional-streaming | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.streaming_analyze_content.js</caption>
* region_tag:dialogflow_v2_generated_Participants_StreamingAnalyzeContent_async
*/
streamingAnalyzeContent(options?: CallOptions): gax.CancellableStream;
/**
* Returns the list of all participants in the specified conversation.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The conversation to list all participants from.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>`.
* @param {number} [request.pageSize]
* Optional. The maximum number of items to return in a single page. By
* default 100 and at most 1000.
* @param {string} [request.pageToken]
* Optional. The next_page_token value returned from a previous list request.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is Array of {@link protos.google.cloud.dialogflow.v2.Participant|Participant}.
* The client library will perform auto-pagination by default: it will call the API as many
* times as needed and will merge results from all the pages into this array.
* Note that it can affect your quota.
* We recommend using `listParticipantsAsync()`
* method described below for async iteration which you can stop as needed.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
*/
listParticipants(request?: protos.google.cloud.dialogflow.v2.IListParticipantsRequest, options?: CallOptions): Promise<[
protos.google.cloud.dialogflow.v2.IParticipant[],
protos.google.cloud.dialogflow.v2.IListParticipantsRequest | null,
protos.google.cloud.dialogflow.v2.IListParticipantsResponse
]>;
listParticipants(request: protos.google.cloud.dialogflow.v2.IListParticipantsRequest, options: CallOptions, callback: PaginationCallback<protos.google.cloud.dialogflow.v2.IListParticipantsRequest, protos.google.cloud.dialogflow.v2.IListParticipantsResponse | null | undefined, protos.google.cloud.dialogflow.v2.IParticipant>): void;
listParticipants(request: protos.google.cloud.dialogflow.v2.IListParticipantsRequest, callback: PaginationCallback<protos.google.cloud.dialogflow.v2.IListParticipantsRequest, protos.google.cloud.dialogflow.v2.IListParticipantsResponse | null | undefined, protos.google.cloud.dialogflow.v2.IParticipant>): void;
/**
* Equivalent to `listParticipants`, but returns a NodeJS Stream object.
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The conversation to list all participants from.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>`.
* @param {number} [request.pageSize]
* Optional. The maximum number of items to return in a single page. By
* default 100 and at most 1000.
* @param {string} [request.pageToken]
* Optional. The next_page_token value returned from a previous list request.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Stream}
* An object stream which emits an object representing {@link protos.google.cloud.dialogflow.v2.Participant|Participant} on 'data' event.
* The client library will perform auto-pagination by default: it will call the API as many
* times as needed. Note that it can affect your quota.
* We recommend using `listParticipantsAsync()`
* method described below for async iteration which you can stop as needed.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
*/
listParticipantsStream(request?: protos.google.cloud.dialogflow.v2.IListParticipantsRequest, options?: CallOptions): Transform;
/**
* Equivalent to `listParticipants`, but returns an iterable object.
*
* `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The conversation to list all participants from.
* Format: `projects/<Project ID>/locations/<Location
* ID>/conversations/<Conversation ID>`.
* @param {number} [request.pageSize]
* Optional. The maximum number of items to return in a single page. By
* default 100 and at most 1000.
* @param {string} [request.pageToken]
* Optional. The next_page_token value returned from a previous list request.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Object}
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
* When you iterate the returned iterable, each element will be an object representing
* {@link protos.google.cloud.dialogflow.v2.Participant|Participant}. The API will be called under the hood as needed, once per the page,
* so you can stop the iteration when you don't need more results.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v2/participants.list_participants.js</caption>
* region_tag:dialogflow_v2_generated_Participants_ListParticipants_async
*/
listParticipantsAsync(request?: protos.google.cloud.dialogflow.v2.IListParticipantsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.dialogflow.v2.IParticipant>;
/**
* Gets information about a location.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Resource name for the location.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example
* ```
* const [response] = await client.getLocation(request);
* ```
*/
getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
/**
* Lists information about the supported locations for this service. Returns an iterable object.
*
* `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* The resource that owns the locations collection, if applicable.
* @param {string} request.filter
* The standard list filter.
* @param {number} request.pageSize
* The standard list page size.
* @param {string} request.pageToken
* The standard list page token.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Object}
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
* When you iterate the returned iterable, each element will be an object representing
* {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
* so you can stop the iteration when you don't need more results.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
* @example
* ```
* const iterable = client.listLocationsAsync(request);
* for await (const response of iterable) {
* // process response
* }
* ```
*/
listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
/**
* Return a fully-qualified conversationDataset resource name string.
*
* @param {string} project
* @param {string} location
* @param {string} conversation_dataset
* @returns {string} Resource name string.
*/
conversationDatasetPath(project: string, location: string, conversationDataset: string): string;
/**
* Parse the project from ConversationDataset resource.
*
* @param {string} conversationDatasetName
* A fully-qualified path representing ConversationDataset resource.
* @returns {string} A string representing the project.
*/
matchProjectFromConversationDatasetName(conversationDatasetName: string): string | number;
/**
* Parse the location from ConversationDataset resource.
*
* @param {string} conversationDatasetName
* A fully-qualified path representing ConversationDataset resource.
* @returns {string} A string representing the location.
*/
matchLocationFromConversationDatasetName(conversationDatasetName: string): string | number;
/**
* Parse the conversation_dataset from ConversationDataset resource.
*
* @param {string} conversationDatasetName
* A fully-qualified path representing ConversationDataset resource.
* @returns {string} A string representing the conversation_dataset.
*/
matchConversationDatasetFromConversationDatasetName(conversationDatasetName: string): string | number;
/**
* Return a fully-qualified encryptionSpec resource name string.
*
* @param {string} project
* @param {string} location
* @returns {string} Resource name string.
*/
encryptionSpecPath(project: string, location: string): string;
/**
* Parse the project from EncryptionSpec resource.
*
* @param {string} encryptionSpecName
* A fully-qualified path representing EncryptionSpec resource.
* @returns {string} A string representing the project.
*/
matchProjectFromEncryptionSpecName(encryptionSpecName: string): string | number;
/**
* Parse the location from EncryptionSpec resource.
*
* @param {string} encryptionSpecName
* A fully-qualified path representing EncryptionSpec resource.
* @returns {string} A string representing the location.
*/
matchLocationFromEncryptionSpecName(encryptionSpecName: string): string | number;
/**
* Return a fully-qualified generator resource name string.
*
* @param {string} project
* @param {string} location
* @param {string} generator
* @returns {string} Resource name string.
*/
generatorPath(project: string, location: string, generator: string): string;
/**
* Parse the project from Generator resource.
*
* @param {string} generatorName
* A fully-qualified path representing Generator resource.
* @returns {string} A string representing the project.
*/
matchProjectFromGeneratorName(generatorName: string): string | number;
/**
* Parse the location from Generator resource.
*
* @param {string} generatorName
* A fully-qualified path representing Generator resource.
* @returns {string} A string representing the location.
*/
matchLocationFromGeneratorName(generatorName: string): string | number;
/**
* Parse the generator from Generator resource.
*
* @param {string} generatorName
* A fully-qualified path representing Generator resource.
* @returns {string} A string representing the generator.
*/
matchGeneratorFromGeneratorName(generatorName: string): string | number;
/**
* Return a fully-qualified project resource name string.
*
* @param {string} project
* @returns {string} Resource name string.
*/
projectPath(project: string): string;
/**
* Parse the project from Project resource.
*
* @param {string} projectName
* A fully-qualified path representing Project resource.
* @returns {string} A string representing the project.
*/
matchProjectFromProjectName(projectName: string): string | number;
/**
* Return a fully-qualified projectAgent resource name string.
*
* @param {string} project
* @returns {string} Resource name string.
*/
projectAgentPath(project: string): string;
/**
* Parse the project from ProjectAgent resource.
*
* @param {string} projectAgentName
* A fully-qualified path representing project_agent resource.
* @returns {string} A string representing the project.
*/
matchProjectFromProjectAgentName(projectAgentName: string): string | number;
/**
* Return a fully-qualified projectAgentEntityType resource name string.
*
* @param {string} project
* @param {string} entity_type
* @returns {string} Resource name string.
*/
projectAgentEntityTypePath(project: string, entityType: string): string;
/**
* Parse the project from ProjectAgentEntityType resource.
*
* @param {string} projectAgentEntityTypeName
* A fully-qualified path representing project_agent_entity_type resource.
* @returns {string} A string representing the project.
*/
matchProjectFromProjectAgentEntityTypeName(projectAgentEntityTypeName: string): string | number;
/**
* Parse the entity_type from ProjectAgentEntityType resource.
*
* @param {string} projectAgentEntityTypeName
* A fully-qualified path representing project_agent_entity_type resource.
* @returns {string} A string representing the entity_type.
*/
matchEntityTypeFromProjectAgentEntityTypeName(projectAgentEntityTypeName: string): string | number;
/**
* Return a fully-qualified projectAgentEnvironment resource name string.
*
* @param {string} project
* @param {string} environment
* @returns {string} Resource name string.
*/
projectAgentEnvironmentPath(project: string, environment: string): string;
/**
* Parse the project from ProjectAgentEnvironment resource.
*
* @param {string} projectAgentEnvironmentName
* A fully-qualified path representing project_agent_environment resource.
* @returns {string} A string representing the project.
*/
matchProjectFromProjectAgentEnvironmentName(projectAgentEnvironmentName: string): string | number;
/**
* Parse the environment from ProjectAgentEnvironment resource.
*
* @param {string} projectAgentEnvironmentName
* A fully-qualified path representing project_agent_environment resource.
* @returns {string} A string representing the environment.
*/
matchEnvironmentFromProjectAgentEnvironmentName(projectAgentEnvironmentName: string): string | number;
/**
* Return a fully-qualified projectAgentEnvironmentUserSessionContext resource name string.
*
* @param {string} project
* @param {string} environment
* @param {string} user
* @param {string} session
* @param {string} context
* @returns {string} Resource name string.
*/
projectAgentEnvironmentUserSessionContextPath(project: string, environment: string, user: string, session: string, context: string): string;
/**
* Parse the project from ProjectAgentEnvironmentUserSessionContext resource.
*
* @param {string} projectAgentEnvironmentUserSessionContextName
* A fully-qualified path representing project_agent_environment_user_session_context resource.
* @returns {string} A string representing the project.
*/
matchProjectFromProjectAgentEnvironmentUserSessionContextName(projectAgentEnvironmentUserSessionContextName: string): string | number;
/**
* Parse the environment from ProjectAgentEnvironmentUserSessionContext resource.
*
* @param {string} projectAgentEnvironmentUserSessionContextName
* A fully-qualified path representing project_agent_environment_user_session_context resource.
* @returns {string} A string representing the environment.
*/
matchEnvironmentFromProjectAgentEnvironmentUserSessionContextName(projectAgentEnvironmentUserSessionContextName: string): string | number;
/**
* Parse the user from ProjectAgentEnvironmentUserSessionContext resource.
*
* @param {string} projectAgentEnvironmentUserSessionContextName
* A fully-qualified path representing project_agent_environment_user_session_context resource.
* @returns {string} A string representing the user.
*/
matchUserFromProjectAgentEnvironmentUserSessionContextName(projectAgentEnvironmentUserSessionContextName: string): string | number;
/**
* Parse the session from ProjectAgentEnvironmentUserSessionContext resource.
*
* @param {string} projectAgentEnvironmentUserSessionContextName
* A fully-qualified path representing project_agent_environment_user_session_context resource.
* @returns {string} A string representing the session.
*/
matchSessionFromProjectAgentEnvironmentUserSessionContextName(projectAgentEnvironmentUserSessionContextName: string): string | number;
/**
* Parse the context from ProjectAgentEnvironmentUserSessionContext resource.
*
* @param {string} projectAgentEnvironmentUserSessionContextName
* A fully-qualified path representing project_agent_environment_user_session_context resource.
* @returns {string} A string representing the context.
*/
matchContextFromProjectAgentEnvironmentUserSessionContextName(projectAgentEnvironmentUserSessionContextName: string): string | number;
/**
* Return a fully-qualified projectAgentEnvironmentUserSessionEntityType resource name string.
*
* @param {string} project
* @param {string} environment
* @param {string} user
* @param {string} session
* @param {string} entity_type
* @returns {string} Resource name string.
*/
projectAgentEnvironmentUserSessionEntityTypePath(project: string, environment: string, user: string, session: string, entityType: string): string;
/**
* Parse the project from ProjectAgentEnvironmentUserSessionEntityType resource.
*
* @param {string} projectAgentEnvironmentUserSessionEntityTypeName
* A fully-qualified path representing project_agent_environment_user_session_entity_type resource.
* @returns {string} A string representing the project.
*/
matchProjectFromProjectAgentEnvironmentUserSessionEntityTypeName(projectAgentEnvironmentUserSessionEntityTypeName: string): string | number;
/**
* Parse the environment from ProjectAgentEnvironmentUserSessionEntityType resource.
*
* @param {string} projectAgentEnvironmentUserSessionEntityTypeName
* A fully-qualified path representing project_agent_environment_user_session_entity_type resource.
* @returns {string} A string representing the environment.
*/
matchEnvironmentFromProjectAgentEnvironmentUserSessionEntityTypeName(projectAgentEnvironmentUserSessionEntityTypeName: string): string | number;
/**
* Parse the user from ProjectAgentEnvironmentUserSessionEntityType resource.
*
* @param {string} projectAgentEnvironmentUserSessionEntityTypeName