UNPKG

node-nlp

Version:

Library for NLU (Natural Language Understanding) done in Node.js

359 lines (358 loc) 18.3 kB
import * as Models from "botframework-schema"; import * as msRest from "ms-rest-js"; import { ConnectorClientContext } from "../connectorClientContext"; /** Class representing a Conversations. */ export declare class Conversations { private readonly client; /** * Create a Conversations. * @param {ConnectorClientContext} client Reference to the service client. */ constructor(client: ConnectorClientContext); /** * List the Conversations in which this bot has participated. * * GET from this method with a skip token * * The return value is a ConversationsResult, which contains an array of ConversationMembers and a * skip token. If the skip token is not empty, then * there are further values to be returned. Call this method again with the returned token to get * more values. * * Each ConversationMembers object contains the ID of the conversation and an array of * ChannelAccounts that describe the members of the conversation. * @summary GetConversations * @param [options] The optional parameters * @returns Promise<Models.ConversationsGetConversationsResponse> */ getConversations(options?: Models.ConversationsGetConversationsOptionalParams): Promise<Models.ConversationsGetConversationsResponse>; /** * @param callback The callback */ /** * @param options The optional parameters * @param callback The callback */ getConversations(options: Models.ConversationsGetConversationsOptionalParams, callback: msRest.ServiceCallback<Models.ConversationsResult>): void; /** * Create a new Conversation. * * POST to this method with a * * Bot being the bot creating the conversation * * IsGroup set to true if this is not a direct message (default is false) * * Array containing the members to include in the conversation * * The return value is a ResourceResponse which contains a conversation id which is suitable for * use * in the message payload and REST API uris. * * Most channels only support the semantics of bots initiating a direct message conversation. An * example of how to do that would be: * * ``` * var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ * Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } ); * await connect.Conversations.SendToConversationAsync(resource.Id, new Activity() ... ) ; * * ``` * @summary CreateConversation * @param parameters Parameters to create the conversation from * @param [options] The optional parameters * @returns Promise<Models.ConversationsCreateConversationResponse> */ createConversation(parameters: Models.ConversationParameters, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsCreateConversationResponse>; /** * @param parameters Parameters to create the conversation from * @param callback The callback */ createConversation(parameters: Models.ConversationParameters, callback: msRest.ServiceCallback<Models.ConversationResourceResponse>): void; /** * @param parameters Parameters to create the conversation from * @param options The optional parameters * @param callback The callback */ createConversation(parameters: Models.ConversationParameters, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ConversationResourceResponse>): void; /** * This method allows you to send an activity to the end of a conversation. * * This is slightly different from ReplyToActivity(). * * SendToConversation(conversationId) - will append the activity to the end of the conversation * according to the timestamp or semantics of the channel. * * ReplyToActivity(conversationId,ActivityId) - adds the activity as a reply to another activity, * if the channel supports it. If the channel does not support nested replies, ReplyToActivity * falls back to SendToConversation. * * Use ReplyToActivity when replying to a specific activity in the conversation. * * Use SendToConversation in all other cases. * @summary SendToConversation * @param conversationId Conversation ID * @param activity Activity to send * @param [options] The optional parameters * @returns Promise<Models.ConversationsSendToConversationResponse> */ sendToConversation(conversationId: string, activity: Models.Activity, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsSendToConversationResponse>; /** * @param conversationId Conversation ID * @param activity Activity to send * @param callback The callback */ sendToConversation(conversationId: string, activity: Models.Activity, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * @param conversationId Conversation ID * @param activity Activity to send * @param options The optional parameters * @param callback The callback */ sendToConversation(conversationId: string, activity: Models.Activity, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * This method allows you to upload the historic activities to the conversation. * * Sender must ensure that the historic activities have unique ids and appropriate timestamps. The * ids are used by the client to deal with duplicate activities and the timestamps are used by the * client to render the activities in the right order. * @summary SendConversationHistory * @param conversationId Conversation ID * @param history Historic activities * @param [options] The optional parameters * @returns Promise<Models.ConversationsSendConversationHistoryResponse> */ sendConversationHistory(conversationId: string, history: Models.Transcript, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsSendConversationHistoryResponse>; /** * @param conversationId Conversation ID * @param history Historic activities * @param callback The callback */ sendConversationHistory(conversationId: string, history: Models.Transcript, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * @param conversationId Conversation ID * @param history Historic activities * @param options The optional parameters * @param callback The callback */ sendConversationHistory(conversationId: string, history: Models.Transcript, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * Edit an existing activity. * * Some channels allow you to edit an existing activity to reflect the new state of a bot * conversation. * * For example, you can remove buttons after someone has clicked "Approve" button. * @summary UpdateActivity * @param conversationId Conversation ID * @param activityId activityId to update * @param activity replacement Activity * @param [options] The optional parameters * @returns Promise<Models.ConversationsUpdateActivityResponse> */ updateActivity(conversationId: string, activityId: string, activity: Models.Activity, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsUpdateActivityResponse>; /** * @param conversationId Conversation ID * @param activityId activityId to update * @param activity replacement Activity * @param callback The callback */ updateActivity(conversationId: string, activityId: string, activity: Models.Activity, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * @param conversationId Conversation ID * @param activityId activityId to update * @param activity replacement Activity * @param options The optional parameters * @param callback The callback */ updateActivity(conversationId: string, activityId: string, activity: Models.Activity, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * This method allows you to reply to an activity. * * This is slightly different from SendToConversation(). * * SendToConversation(conversationId) - will append the activity to the end of the conversation * according to the timestamp or semantics of the channel. * * ReplyToActivity(conversationId,ActivityId) - adds the activity as a reply to another activity, * if the channel supports it. If the channel does not support nested replies, ReplyToActivity * falls back to SendToConversation. * * Use ReplyToActivity when replying to a specific activity in the conversation. * * Use SendToConversation in all other cases. * @summary ReplyToActivity * @param conversationId Conversation ID * @param activityId activityId the reply is to (OPTIONAL) * @param activity Activity to send * @param [options] The optional parameters * @returns Promise<Models.ConversationsReplyToActivityResponse> */ replyToActivity(conversationId: string, activityId: string, activity: Models.Activity, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsReplyToActivityResponse>; /** * @param conversationId Conversation ID * @param activityId activityId the reply is to (OPTIONAL) * @param activity Activity to send * @param callback The callback */ replyToActivity(conversationId: string, activityId: string, activity: Models.Activity, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * @param conversationId Conversation ID * @param activityId activityId the reply is to (OPTIONAL) * @param activity Activity to send * @param options The optional parameters * @param callback The callback */ replyToActivity(conversationId: string, activityId: string, activity: Models.Activity, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * Delete an existing activity. * * Some channels allow you to delete an existing activity, and if successful this method will * remove the specified activity. * @summary DeleteActivity * @param conversationId Conversation ID * @param activityId activityId to delete * @param [options] The optional parameters * @returns Promise<msRest.RestResponse> */ deleteActivity(conversationId: string, activityId: string, options?: msRest.RequestOptionsBase): Promise<msRest.RestResponse>; /** * @param conversationId Conversation ID * @param activityId activityId to delete * @param callback The callback */ deleteActivity(conversationId: string, activityId: string, callback: msRest.ServiceCallback<void>): void; /** * @param conversationId Conversation ID * @param activityId activityId to delete * @param options The optional parameters * @param callback The callback */ deleteActivity(conversationId: string, activityId: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<void>): void; /** * Enumerate the members of a conversation. * * This REST API takes a ConversationId and returns an array of ChannelAccount objects representing * the members of the conversation. * @summary GetConversationMembers * @param conversationId Conversation ID * @param [options] The optional parameters * @returns Promise<Models.ConversationsGetConversationMembersResponse> */ getConversationMembers(conversationId: string, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsGetConversationMembersResponse>; /** * @param conversationId Conversation ID * @param callback The callback */ getConversationMembers(conversationId: string, callback: msRest.ServiceCallback<Models.ChannelAccount[]>): void; /** * @param conversationId Conversation ID * @param options The optional parameters * @param callback The callback */ getConversationMembers(conversationId: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ChannelAccount[]>): void; /** * Enumerate the members of a conversation one page at a time. * * This REST API takes a ConversationId. Optionally a pageSize and/or continuationToken can be * provided. It returns a PagedMembersResult, which contains an array * of ChannelAccounts representing the members of the conversation and a continuation token that * can be used to get more values. * * One page of ChannelAccounts records are returned with each call. The number of records in a page * may vary between channels and calls. The pageSize parameter can be used as * a suggestion. If there are no additional results the response will not contain a continuation * token. If there are no members in the conversation the Members will be empty or not present in * the response. * * A response to a request that has a continuation token from a prior request may rarely return * members from a previous request. * @summary GetConversationPagedMembers * @param conversationId Conversation ID * @param [options] The optional parameters * @returns Promise<Models.ConversationsGetConversationPagedMembersResponse> */ getConversationPagedMembers(conversationId: string, options?: Models.ConversationsGetConversationPagedMembersOptionalParams): Promise<Models.ConversationsGetConversationPagedMembersResponse>; /** * @param conversationId Conversation ID * @param callback The callback */ /** * @param conversationId Conversation ID * @param options The optional parameters * @param callback The callback */ getConversationPagedMembers(conversationId: string, options: Models.ConversationsGetConversationPagedMembersOptionalParams, callback: msRest.ServiceCallback<Models.PagedMembersResult>): void; /** * Deletes a member from a conversation. * * This REST API takes a ConversationId and a memberId (of type string) and removes that member * from the conversation. If that member was the last member * of the conversation, the conversation will also be deleted. * @summary DeleteConversationMember * @param conversationId Conversation ID * @param memberId ID of the member to delete from this conversation * @param [options] The optional parameters * @returns Promise<msRest.RestResponse> */ deleteConversationMember(conversationId: string, memberId: string, options?: msRest.RequestOptionsBase): Promise<msRest.RestResponse>; /** * @param conversationId Conversation ID * @param memberId ID of the member to delete from this conversation * @param callback The callback */ deleteConversationMember(conversationId: string, memberId: string, callback: msRest.ServiceCallback<void>): void; /** * @param conversationId Conversation ID * @param memberId ID of the member to delete from this conversation * @param options The optional parameters * @param callback The callback */ deleteConversationMember(conversationId: string, memberId: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<void>): void; /** * Enumerate the members of an activity. * * This REST API takes a ConversationId and a ActivityId, returning an array of ChannelAccount * objects representing the members of the particular activity in the conversation. * @summary GetActivityMembers * @param conversationId Conversation ID * @param activityId Activity ID * @param [options] The optional parameters * @returns Promise<Models.ConversationsGetActivityMembersResponse> */ getActivityMembers(conversationId: string, activityId: string, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsGetActivityMembersResponse>; /** * @param conversationId Conversation ID * @param activityId Activity ID * @param callback The callback */ getActivityMembers(conversationId: string, activityId: string, callback: msRest.ServiceCallback<Models.ChannelAccount[]>): void; /** * @param conversationId Conversation ID * @param activityId Activity ID * @param options The optional parameters * @param callback The callback */ getActivityMembers(conversationId: string, activityId: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ChannelAccount[]>): void; /** * Upload an attachment directly into a channel's blob storage. * * This is useful because it allows you to store data in a compliant store when dealing with * enterprises. * * The response is a ResourceResponse which contains an AttachmentId which is suitable for using * with the attachments API. * @summary UploadAttachment * @param conversationId Conversation ID * @param attachmentUpload Attachment data * @param [options] The optional parameters * @returns Promise<Models.ConversationsUploadAttachmentResponse> */ uploadAttachment(conversationId: string, attachmentUpload: Models.AttachmentData, options?: msRest.RequestOptionsBase): Promise<Models.ConversationsUploadAttachmentResponse>; /** * @param conversationId Conversation ID * @param attachmentUpload Attachment data * @param callback The callback */ uploadAttachment(conversationId: string, attachmentUpload: Models.AttachmentData, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; /** * @param conversationId Conversation ID * @param attachmentUpload Attachment data * @param options The optional parameters * @param callback The callback */ uploadAttachment(conversationId: string, attachmentUpload: Models.AttachmentData, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.ResourceResponse>): void; }