QnAMakerDialog class

Inizializza una nuova istanza della classe QnAMakerDialog .

new QnAMakerDialog(knowledgeBaseId?: string, endpointKey?: string, hostname?: string, noAnswer?: Activity, threshold?: number, suggestionsActivityFactory?: QnASuggestionsActivityFactory, cardNoMatchText?: string, top?: number, cardNoMatchResponse?: Activity, rankerType?: RankerTypes, strictFilters?: QnAMakerMetadata[], dialogId?: string, strictFiltersJoinOperator?: JoinOperator, enablePreciseAnswer?: boolean, displayPreciseAnswerOnly?: boolean, qnaServiceType?: ServiceType)

Parametri

Inizializza una nuova istanza della classe QnAMakerDialog .

new QnAMakerDialog(knowledgeBaseId?: string, endpointKey?: string, hostname?: string, noAnswer?: Activity, threshold?: number, activeLearningCardTitle?: string, cardNoMatchText?: string, top?: number, cardNoMatchResponse?: Activity, rankerType?: RankerTypes, strictFilters?: QnAMakerMetadata[], dialogId?: string, strictFiltersJoinOperator?: JoinOperator, enablePreciseAnswer?: boolean, displayPreciseAnswerOnly?: boolean, qnaServiceType?: ServiceType)

Parametri

static $kind: string

Valore della proprietà

Ottiene o imposta il titolo della scheda da utilizzare quando vengono visualizzate le opzioni di apprendimento attive per l'utente. Nota: se suggestionsActivityFactory viene passato, questo membro non viene usato.

activeLearningCardTitle: StringExpression

Valore della proprietà

Ottiene o imposta il modello da inviare all'utente se seleziona l'opzione nessuna corrispondenza in una scheda di apprendimento attiva.

cardNoMatchResponse: TemplateInterface<Partial<Activity>, DialogStateManager>

Valore della proprietà

Ottiene o imposta il testo del pulsante da utilizzare con le opzioni di apprendimento attive, consentendo a un utente di indicare che non sono applicabili le opzioni. Nota: se suggestionsActivityFactory viene passato, questo membro è obbligatorio.

cardNoMatchText: StringExpression

Valore della proprietà

Ottiene o imposta un valore che indica se la risposta del dialogo deve visualizzare solo risposte precise.

displayPreciseAnswerOnly: boolean

Valore della proprietà

Ottiene o imposta un valore che indica se includere una risposta precisa in risposta.

enablePreciseAnswer: boolean

Valore della proprietà

Ottiene o imposta la chiave dell'endpoint di QnA Maker da usare per eseguire query sul knowledge base.

endpointKey: StringExpression

Valore della proprietà

Ottiene o imposta i metadati e le origini utilizzati per filtrare i risultati.

filters: Filters

Valore della proprietà

Ottiene o imposta l'URL dell'host QnA Maker per il knowledge base.

hostname: StringExpression

Valore della proprietà

Ottiene o imposta un valore che indica se includere origini non strutturate nella ricerca di risposte.

includeUnstructuredSources: boolean

Valore della proprietà

Ottiene o imposta un valore che indica se ottiene o imposta l'ambiente della knowledge base da chiamare.

isTest: boolean

Valore della proprietà

Ottiene o imposta l'ID knowledge base QnA Maker su cui eseguire la query.

knowledgeBaseId: StringExpression

Valore della proprietà

Ottiene o imposta il flag per determinare se le informazioni personali devono essere registrate nei dati di telemetria.

logPersonalInformation: BoolExpression

Valore della proprietà

Ottiene o imposta il modello da inviare all'utente quando QnA Maker non trova una risposta.

noAnswer: TemplateInterface<Partial<Activity>, DialogStateManager>

Valore della proprietà

Tipo di servizio di risposta alle domande - qnaMaker o lingua

qnaServiceType: ServiceType

Valore della proprietà

Ottiene o imposta il tipo di classificazione di QnA Maker da usare.

rankerType: EnumExpression<RankerTypes>

Valore della proprietà

Ottiene o imposta i metadati di QnA Maker con cui filtrare o incrementare le query al knowledge base oppure null per applicare nessuno.

strictFilters: QnAMakerMetadata[]

Valore della proprietà

Ottiene o imposta un valore - AND o OR - operazione logica nell'elenco di metadati

strictFiltersJoinOperator: JoinOperator

Valore della proprietà

Ottiene o imposta la soglia per le risposte restituite, in base al punteggio.

threshold: NumberExpression

Valore della proprietà

Ottiene o imposta il numero massimo di risposte da restituire dal knowledge base.

top: IntExpression

Valore della proprietà

Ottiene un risultato di fine turno predefinito.

static EndOfTurn: DialogTurnResult

Valore della proprietà

Commenti

Questo risultato indica che un dialogo (o un passaggio logico all'interno di un dialogo) ha completato l'elaborazione per il turno corrente, è ancora attiva ed è in attesa di più input.

Ereditato da Dialog.EndOfTurn

id: string

Valore della proprietà

Ereditato da Dialog.id

telemetryClient: BotTelemetryClient

Valore della proprietà

Ereditato da Dialog.telemetryClient

Chiamato quando il dialogo viene avviato e inserito nello stack di dialoghi.

function beginDialog(dc: DialogContext, options?: object): Promise<DialogTurnResult>

Parametri

Restituisce

Una promessa che risolve il risultato del turno

Chiamato quando il dialogo viene continuato, dove è il dialogo attivo e l'utente risponde con una nuova attività.

function continueDialog(dc: DialogContext): Promise<DialogTurnResult>

Parametri

Restituisce

Promessa che rappresenta l'operazione asincrona.

function getConverter(property: Object): Converter | ConverterFactory

Parametri

Restituisce

Convertitore di espressioni.

Aggiunge un nuovo passaggio alla cascata.

function addStep(step: WaterfallStep<O>): this

Parametri

Restituisce

Finestra di dialogo a cascata per le chiamate fluent a addStep().

Commenti

Tutte le funzioni di passaggio devono essere asincrone e restituire un DialogTurnResultoggetto . Il WaterfallStepContext passato nella funzione deriva da DialogContext e contiene numerosi metodi di manipolazione dello stack che restituiscono un DialogTurnResult oggetto in modo da poter in genere restituire il risultato dal metodo DialogContext chiamato.

La funzione step stessa può essere una chiusura asincrona:

const helloDialog = new WaterfallDialog('hello');

helloDialog.addStep(async (step) => {
    await step.context.sendActivity(`Hello World!`);
    return await step.endDialog();
});

Funzione asincrona denominata:

async function helloWorldStep(step) {
    await step.context.sendActivity(`Hello World!`);
    return await step.endDialog();
}

helloDialog.addStep(helloWorldStep);

In alternativa, un metodo di classe associato al puntatore this :

helloDialog.addStep(this.helloWorldStep.bind(this));

Ereditato da WaterfallDialog.addStep

Metodo Fluent per la configurazione dell'oggetto.

function configure(config: Record<string, unknown>): this

Parametri

Restituisce

Configurabile al termine dell'operazione.

Ereditato da Configurable.configure

Viene chiamato quando termina il dialogo.

function endDialog(context: TurnContext, instance: DialogInstance, reason: DialogReason): Promise<void>

Parametri

Restituisce

Ereditato da WaterfallDialog.endDialog

Ottiene la versione della finestra di dialogo, composta dall'ID e dal numero di passaggi.

function getVersion(): string

Restituisce

Versione della finestra di dialogo, composta dall'ID e dal numero di passaggi.

Ereditato da WaterfallDialog.getVersion

Chiamato quando è stato generato un evento, utilizzando DialogContext.emitEvent(), dalla finestra di dialogo corrente o da un dialogo avviato dal dialogo corrente.

function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>

Parametri

Restituisce

True se l'evento viene gestito dalla finestra di dialogo corrente e il bubbling deve essere arrestato.

Ereditato da Dialog.onDialogEvent

Quando ne viene eseguito l'override in una classe derivata, reinserito l'utente per l'input.

function repromptDialog(_context: TurnContext, _instance: DialogInstance): Promise<void>

Parametri

Restituisce

Commenti

I dialoghi derivati che supportano la convalida e la logica di ripetizione della richiesta devono eseguire l'override di questo metodo. Per impostazione predefinita, questo metodo non ha alcun effetto.

DialogContext chiama questo metodo quando il dialogo corrente deve richiedere nuovamente l'input dell'utente. Questo metodo viene implementato per i dialoghi di richiesta.

Vedere anche

• DialogContext.repromptDialog
• Messaggio di richiesta

Ereditato da Dialog.repromptDialog

Chiamato quando un elemento WaterfallDialog figlio ha completato il suo turno, restituendo il controllo a questa finestra di dialogo.

function resumeDialog(dc: DialogContext, reason: DialogReason, result?: any): Promise<DialogTurnResult>

Parametri

Restituisce

Promessa che rappresenta l'operazione asincrona.

Ereditato da WaterfallDialog.resumeDialog