Párbeszédpanelek használata egy adott képességen belül

Cikk
10/21/2023

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Ez a cikk bemutatja, hogyan hozhat létre olyan készséget, amely több műveletet támogat. Párbeszédpanelek használatával támogatja ezeket a műveleteket. A fő párbeszédpanel megkapja a kezdeti bemenetet a készségfelhasználótól, majd elindítja a megfelelő műveletet. A képességfelhasználónak a társított mintakódhoz való implementálásával kapcsolatos információkért tekintse meg, hogyan használhat fel készséget párbeszédpanelek használatával.

Ez a cikk feltételezi, hogy már ismeri a készségek létrehozását. A képességrobotok általános létrehozásához tekintse meg, hogyan valósíthat meg készséget.

Feljegyzés

A Bot Framework JavaScript, C# és Python SDK-k továbbra is támogatottak lesznek, a Java SDK-t azonban 2023 novemberében végső hosszú távú támogatással kivonják.

A Java SDK-val létrehozott meglévő robotok továbbra is működni fognak.

Új robotépítéshez fontolja meg a Power Virtual Agents használatát, és olvassa el a megfelelő csevegőrobot-megoldás kiválasztását.

További információ: A robotépítés jövője.

Előfeltételek

A robot alapjainak ismerete, a készségrobotok működése és egy képesség implementálása.
Azure-előfizetés (a képesség üzembe helyezéséhez). Ha még nincs előfizetése, hozzon létre egy ingyenes fiókot, mielőtt hozzákezd.
Opcionálisan LUIS-fiók. (További információ: természetes nyelvfelismerés hozzáadása a robothoz.)
A skills skillDialog mintapéldány másolata c#, JavaScript , Java vagy Python nyelven.

Feljegyzés

A Language Understanding (LUIS) 2025. október 1-jén megszűnik. 2023. április 1-től nem hozhat létre új LUIS-erőforrásokat. Az Azure AI Language részeként már elérhető a nyelvértés újabb verziója.

Az Azure AI Language egyik funkciója, a beszélgetési nyelv megértése (CLU) a LUIS frissített verziója. További információ a Bot Framework SDK nyelvfelismerési támogatásáról: Természetes nyelvfelismerés.

A minta ismertetése

A skillDialog minta két robot projektjeit tartalmazza:

A párbeszédpanel gyökérrobotja, amely egy készség-párbeszédpanel-osztály használatával használ fel egy készséget.
A párbeszédpanel készségrobotja, amely egy párbeszédpanelt használ a készségfelhasználóktól érkező tevékenységek kezeléséhez. Ez a képesség az alapvető robotminta adaptálása. (Az alaprobottal kapcsolatos további információkért tekintse meg, hogyan adhat hozzá természetes nyelvfelismerést a robothoz.)

Ez a cikk azt ismerteti, hogyan használhat párbeszédpanelt egy képességroboton belül több művelet kezeléséhez.

C# osztálydiagram.

A készségfelhasználó robottal kapcsolatos információkért tekintse meg, hogyan használhat fel készséget párbeszédpanelek használatával.

Források

Az üzembe helyezett robotok esetében a robotok között történő hitelesítéshez minden résztvevő robotnak érvényes identitással kell rendelkeznie. A Bot Framework Emulator segítségével azonban identitásadatok nélkül helyileg tesztelheti a készségeket és a készségfelhasználókat.

Ha elérhetővé szeretné tenni a képességet a felhasználói robotok számára, regisztrálja a képességet az Azure-ban. További információ: robot regisztrálása az Azure AI Bot Service-ben.

A képességrobot opcionálisan járatfoglalási LUIS-modellt is használhat. A modell használatához használja a CognitiveModels/FlightBooking.json fájlt a LUIS-modell létrehozásához, betanításához és közzétételéhez.

Alkalmazáskonfiguráció

Ha szükséges, adja hozzá a képesség identitásadatait a képesség konfigurációs fájljába. (Ha a képesség- vagy képességfelhasználó identitást határoz meg, mindkettőnek meg kell.)
Ha a LUIS-modellt használja, adja hozzá a LUIS-alkalmazásazonosítót, az API-kulcsot és az API-gazdagép nevét.

DialogSkillBot\appsettings.json

{
  "MicrosoftAppType": "",
  "MicrosoftAppId": "",
  "MicrosoftAppPassword": "",
  "MicrosoftAppTenantId": "",
  "ConnectionName": "",

  "LuisAppId": "",
  "LuisAPIKey": "",
  "LuisAPIHostName": "",

  // This is a comma separate list with the App IDs that will have access to the skill.
  // This setting is used in AllowedCallersClaimsValidator.
  // Examples: 
  //    [ "*" ] allows all callers.
  //    [ "AppId1", "AppId2" ] only allows access to parent bots with "AppId1" and "AppId2".
  "AllowedCallers": [ "*" ]
}

dialogSkillBot/.env

MicrosoftAppType=
MicrosoftAppId=
MicrosoftAppPassword=
MicrosoftAppTenantId=
AllowedCallers=*

LuisAppId=
LuisAPIKey=
LuisAPIHostName=

application.properties

MicrosoftAppId=
MicrosoftAppPassword=
server.port=39783

LuisAppId=
LuisAPIKey=
LuisAPIHostName=
# This is a comma separate list with the App IDs that will have access to the skill.
# This setting is used in AllowedCallersClaimsValidator.
# Examples:
#    * allows all callers.
#    AppId1,AppId2 only allows access to parent bots with "AppId1" and "AppId2".
AllowedCallers=*

dialog-skill-bot/config.py

PORT = 39783
APP_ID = os.environ.get("MicrosoftAppId", "")
APP_PASSWORD = os.environ.get("MicrosoftAppPassword", "")
APP_TYPE = os.environ.get("MicrosoftAppType", "MultiTenant")
APP_TENANTID = os.environ.get("MicrosoftAppTenantId", "")

# Callers to only those specified, '*' allows any caller.
# Example: os.environ.get("AllowedCallers", ["aaaaaaaa-1111-aaaa-aaaa-aaaaaaaa"])
ALLOWED_CALLERS = os.environ.get("AllowedCallers", ["*"])

LUIS_APP_ID = os.environ.get("LuisAppId", "")
LUIS_API_KEY = os.environ.get("LuisAPIKey", "")

Tevékenység-útválasztási logika

A képesség számos különböző funkciót támogat. Lefoglalhat egy repülőt, vagy lekérheti a város időjárását. Ezenkívül, ha az üzenet ezen környezetek bármelyikén kívül kap üzenetet, a LUIS használatával megpróbálhatja értelmezni az üzenetet. A képesség jegyzékfájlja ismerteti ezeket a műveleteket, azok bemeneti és kimeneti paramétereit, valamint a képesség végpontjait. A képesség képes kezelni a "BookFlight" vagy a "GetWeather" eseményt. Képes kezelni az üzenettevékenységeket is.

A képesség egy tevékenység-útválasztási párbeszédpanelt határoz meg, amellyel kiválaszthatja, hogy melyik műveletet kezdeményezi a képességfelhasználótól érkező kezdeti tevékenység alapján. Ha meg van adva, a LUIS-modell képes felismerni a könyv szerinti repülési és a get-weather szándékokat egy kezdeti üzenetben.

A book-flight művelet egy többlépéses folyamat, amely külön párbeszédpanelként van implementálva. A művelet megkezdése után a bejövő tevékenységeket az adott párbeszédpanel kezeli. A get-weather művelet helyőrző logikával rendelkezik, amelyet egy teljes mértékben implementált robot helyettesítene.

A tevékenység-útválasztás párbeszédpanel a következő kódot tartalmazza:

A párbeszédpanel inicializálása
Kezdeti tevékenység feldolgozása
Üzenettevékenységek kezelése
Többlépéses művelet indítása
Eredmény visszaadása

A képességben használt párbeszédpanelek az összetevő párbeszédpanelosztályától öröklődnek . Az összetevők párbeszédpaneljeiről további információt a párbeszédpanelek összetettségének kezelésével kapcsolatban talál.

A párbeszédpanel inicializálása

A tevékenység-útválasztás párbeszédpanel tartalmaz egy gyermek párbeszédpanelt egy járat foglalásához. A fő vízesés párbeszédpanel egy lépéssel indít el egy műveletet a kapott kezdeti tevékenység alapján.

Luis-felismerőt is elfogad. Ha ez a felismerő inicializálva van, a párbeszédpanel egy kezdeti üzenettevékenység szándékának értelmezésére fogja használni.

DialogSkillBot\Dialogs\ActivityRouterDialog.cs

private readonly DialogSkillBotRecognizer _luisRecognizer;

public ActivityRouterDialog(DialogSkillBotRecognizer luisRecognizer)
    : base(nameof(ActivityRouterDialog))
{
    _luisRecognizer = luisRecognizer;

    AddDialog(new BookingDialog());
    AddDialog(new WaterfallDialog(nameof(WaterfallDialog), new WaterfallStep[] { ProcessActivityAsync }));

    // The initial child Dialog to run.
    InitialDialogId = nameof(WaterfallDialog);
}

dialogSkillBot/dialogs/activityRouterDialog.js

constructor(conversationState, luisRecognizer = undefined) {
    super(ACTIVITY_ROUTER_DIALOG);

    if (!conversationState) throw new Error('[MainDialog]: Missing parameter \'conversationState\' is required');

    this.luisRecognizer = luisRecognizer;

    // Define the main dialog and its related components.
    // This is a sample "book a flight" dialog.
    this.addDialog(new BookingDialog())
        .addDialog(new WaterfallDialog(WATERFALL_DIALOG, [
            this.processActivity.bind(this)
        ]));

    this.initialDialogId = WATERFALL_DIALOG;
}

DialogSkillBot\Dialogs\ActivityRouterDialog.java

private final DialogSkillBotRecognizer luisRecognizer;

public ActivityRouterDialog(DialogSkillBotRecognizer luisRecognizer) {
    super("ActivityRouterDialog");
    this.luisRecognizer = luisRecognizer;

    addDialog(new BookingDialog());
    List<WaterfallStep> stepList = new ArrayList<WaterfallStep>();
    stepList.add(this::processActivity);
    addDialog(new WaterfallDialog("WaterfallDialog", stepList));

    // The initial child Dialog to run.
    setInitialDialogId("WaterfallDialog");
}

dialog-skill-bot/dialogs/activity_router_dialog.py

def __init__(self, luis_recognizer: DialogSkillBotRecognizer):
    super().__init__(ActivityRouterDialog.__name__)

    self._luis_recognizer = luis_recognizer

    self.add_dialog(BookingDialog())
    self.add_dialog(
        WaterfallDialog(WaterfallDialog.__name__, [self.process_activity])
    )

    self.initial_dialog_id = WaterfallDialog.__name__

Kezdeti tevékenység feldolgozása

A fő vízesés párbeszédpanel első (és egyetlen) lépésében a képesség ellenőrzi a bejövő tevékenység típusát.

Az eseménytevékenységeket egy eseménytevékenység-kezelő továbbítja, amely az esemény neve alapján elindítja a megfelelő műveletet.
Az üzenettevékenységek továbbítva lesznek egy üzenettevékenység-kezelőnek , amely további feldolgozást végez, mielőtt eldöntené, hogy mit kell tennie.

Ha a képesség nem ismeri fel a bejövő tevékenység típusát vagy az esemény nevét, hibaüzenetet küld, és véget ér.

DialogSkillBot\Dialogs\ActivityRouterDialog.cs

private async Task<DialogTurnResult> ProcessActivityAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
    // A skill can send trace activities, if needed.
    await stepContext.Context.TraceActivityAsync($"{GetType().Name}.ProcessActivityAsync()", label: $"Got ActivityType: {stepContext.Context.Activity.Type}", cancellationToken: cancellationToken);

    switch (stepContext.Context.Activity.Type)
    {
        case ActivityTypes.Event:
            return await OnEventActivityAsync(stepContext, cancellationToken);

        case ActivityTypes.Message:
            return await OnMessageActivityAsync(stepContext, cancellationToken);

        default:
            // We didn't get an activity type we can handle.
            await stepContext.Context.SendActivityAsync(MessageFactory.Text($"Unrecognized ActivityType: \"{stepContext.Context.Activity.Type}\".", inputHint: InputHints.IgnoringInput), cancellationToken);
            return new DialogTurnResult(DialogTurnStatus.Complete);
    }
}

// This method performs different tasks based on the event name.
private async Task<DialogTurnResult> OnEventActivityAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
    var activity = stepContext.Context.Activity;
    await stepContext.Context.TraceActivityAsync($"{GetType().Name}.OnEventActivityAsync()", label: $"Name: {activity.Name}. Value: {GetObjectAsJsonString(activity.Value)}", cancellationToken: cancellationToken);

    // Resolve what to execute based on the event name.
    switch (activity.Name)
    {
        case "BookFlight":
            return await BeginBookFlight(stepContext, cancellationToken);

        case "GetWeather":
            return await BeginGetWeather(stepContext, cancellationToken);

        default:
            // We didn't get an event name we can handle.
            await stepContext.Context.SendActivityAsync(MessageFactory.Text($"Unrecognized EventName: \"{activity.Name}\".", inputHint: InputHints.IgnoringInput), cancellationToken);
            return new DialogTurnResult(DialogTurnStatus.Complete);
    }
}

dialogSkillBot/dialogs/activityRouterDialog.js

async processActivity(stepContext) {
    // A skill can send trace activities, if needed.
    const traceActivity = {
        type: ActivityTypes.Trace,
        timestamp: new Date(),
        text: 'ActivityRouterDialog.processActivity()',
        label: `Got activityType: ${ stepContext.context.activity.type }`
    };
    await stepContext.context.sendActivity(traceActivity);

    switch (stepContext.context.activity.type) {
        case ActivityTypes.Event:
            return await this.onEventActivity(stepContext);
        case ActivityTypes.Message:
            return await this.onMessageActivity(stepContext);
        default:
            // Catch all for unhandled intents.
            await stepContext.context.sendActivity(
                `Unrecognized ActivityType: "${ stepContext.context.activity.type }".`,
                undefined,
                InputHints.IgnoringInput
            );
            return { status: DialogTurnStatus.complete };
    }
}

/**
 * This method performs different tasks based on event name.
 */
async onEventActivity(stepContext) {
    const activity = stepContext.context.activity;
    const traceActivity = {
        type: ActivityTypes.Trace,
        timestamp: new Date(),
        text: 'ActivityRouterDialog.onEventActivity()',
        label: `Name: ${ activity.name }, Value: ${ JSON.stringify(activity.value) }`
    };
    await stepContext.context.sendActivity(traceActivity);

    // Resolve what to execute based on the event name.
    switch (activity.name) {
        case 'BookFlight':
            return await this.beginBookFlight(stepContext);
        case 'GetWeather':
            return await this.beginGetWeather(stepContext);
        default:
            // We didn't get an event name we can handle.
            await stepContext.context.sendActivity(
                `Unrecognized EventName: "${ stepContext.context.activity.name }".`,
                undefined,
                InputHints.IgnoringInput
            );
            return { status: DialogTurnStatus.complete };
    }
}

DialogSkillBot\Dialogs\ActivityRouterDialog.java

private CompletableFuture<DialogTurnResult> processActivity(WaterfallStepContext stepContext) {
    // A skill can send trace activities, if needed.
    TurnContext.traceActivity(
        stepContext.getContext(),
        String.format(
            "{%s}.processActivity() Got ActivityType: %s",
            this.getClass().getName(),
            stepContext.getContext().getActivity().getType()
        )
    );

    switch (stepContext.getContext().getActivity().getType()) {
        case ActivityTypes.EVENT:
            return onEventActivity(stepContext);

        case ActivityTypes.MESSAGE:
            return onMessageActivity(stepContext);

        default:
            String defaultMessage = String
                .format("Unrecognized ActivityType: \"%s\".", stepContext.getContext().getActivity().getType());
            // We didn't get an activity type we can handle.
            return stepContext.getContext()
                .sendActivity(MessageFactory.text(defaultMessage, defaultMessage, InputHints.IGNORING_INPUT))
                .thenCompose(result -> {
                    return CompletableFuture.completedFuture(new DialogTurnResult(DialogTurnStatus.COMPLETE));
                });

    }
}

// This method performs different tasks super. on the event name.
private CompletableFuture<DialogTurnResult> onEventActivity(WaterfallStepContext stepContext) {
    Activity activity = stepContext.getContext().getActivity();
    TurnContext.traceActivity(
        stepContext.getContext(),
        String.format(
            "%s.onEventActivity(), label: %s, Value: %s",
            this.getClass().getName(),
            activity.getName(),
            GetObjectAsJsonString(activity.getValue())
        )
    );

    // Resolve what to execute super. on the event name.
    switch (activity.getName()) {
        case "BookFlight":
            return beginBookFlight(stepContext);

        case "GetWeather":
            return beginGetWeather(stepContext);

        default:
            String message = String.format("Unrecognized EventName: \"%s\".", activity.getName());
            // We didn't get an event name we can handle.
            stepContext.getContext().sendActivity(MessageFactory.text(message, message, InputHints.IGNORING_INPUT));
            return CompletableFuture.completedFuture(new DialogTurnResult(DialogTurnStatus.COMPLETE));
    }
}

dialog-skill-bot/dialogs/activity_router_dialog.py

async def process_activity(
    self, step_context: WaterfallStepContext
) -> DialogTurnResult:
    current_activity_type = step_context.context.activity.type

    # A skill can send trace activities, if needed.
    await step_context.context.send_trace_activity(
        f"{ActivityRouterDialog.__name__}.process_activity()",
        label=f"Got ActivityType: {current_activity_type}",
    )

    if current_activity_type == ActivityTypes.event:
        return await self._on_event_activity(step_context)
    if current_activity_type == ActivityTypes.message:
        return await self._on_message_activity(step_context)
    else:
        # We didn't get an activity type we can handle.
        await step_context.context.send_activity(
            MessageFactory.text(
                f'Unrecognized ActivityType: "{current_activity_type}".',
                input_hint=InputHints.ignoring_input,
            )
        )
        return DialogTurnResult(DialogTurnStatus.Complete)

async def _on_event_activity(
    self, step_context: WaterfallStepContext
) -> DialogTurnResult:
    """
    This method performs different tasks based on the event name.
    """

    activity = step_context.context.activity

    # Resolve what to execute based on the event name.
    if activity.name == "BookFlight":
        return await self._begin_book_flight(step_context)

    if activity.name == "GetWeather":
        return await self._begin_get_weather(step_context)

    # We didn't get an activity name we can handle.
    await step_context.context.send_activity(
        MessageFactory.text(
            f'Unrecognized ActivityName: "{activity.name}".',
            input_hint=InputHints.ignoring_input,
        )
    )
    return DialogTurnResult(DialogTurnStatus.Complete)

Üzenettevékenységek kezelése

Ha a LUIS-felismerő konfigurálva van, a képesség meghívja a LUIS-t, majd elindít egy műveletet a szándék alapján. Ha a LUIS-felismerő nincs konfigurálva, vagy a szándék nem támogatott, a képesség hibaüzenetet küld, és véget ér.

DialogSkillBot\Dialogs\ActivityRouterDialog.cs

// This method just gets a message activity and runs it through LUIS. 
private async Task<DialogTurnResult> OnMessageActivityAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
    var activity = stepContext.Context.Activity;
    await stepContext.Context.TraceActivityAsync($"{GetType().Name}.OnMessageActivityAsync()", label: $"Text: \"{activity.Text}\". Value: {GetObjectAsJsonString(activity.Value)}", cancellationToken: cancellationToken);

    if (!_luisRecognizer.IsConfigured)
    {
        await stepContext.Context.SendActivityAsync(MessageFactory.Text("NOTE: LUIS is not configured. To enable all capabilities, add 'LuisAppId', 'LuisAPIKey' and 'LuisAPIHostName' to the appsettings.json file.", inputHint: InputHints.IgnoringInput), cancellationToken);
    }
    else
    {
        // Call LUIS with the utterance.
        var luisResult = await _luisRecognizer.RecognizeAsync<FlightBooking>(stepContext.Context, cancellationToken);

        // Create a message showing the LUIS results.
        var sb = new StringBuilder();
        sb.AppendLine($"LUIS results for \"{activity.Text}\":");
        var (intent, intentScore) = luisResult.Intents.FirstOrDefault(x => x.Value.Equals(luisResult.Intents.Values.Max()));
        sb.AppendLine($"Intent: \"{intent}\" Score: {intentScore.Score}");

        await stepContext.Context.SendActivityAsync(MessageFactory.Text(sb.ToString(), inputHint: InputHints.IgnoringInput), cancellationToken);

        // Start a dialog if we recognize the intent.
        switch (luisResult.TopIntent().intent)
        {
            case FlightBooking.Intent.BookFlight:
                return await BeginBookFlight(stepContext, cancellationToken);

            case FlightBooking.Intent.GetWeather:
                return await BeginGetWeather(stepContext, cancellationToken);

            default:
                // Catch all for unhandled intents.
                var didntUnderstandMessageText = $"Sorry, I didn't get that. Please try asking in a different way (intent was {luisResult.TopIntent().intent})";
                var didntUnderstandMessage = MessageFactory.Text(didntUnderstandMessageText, didntUnderstandMessageText, InputHints.IgnoringInput);
                await stepContext.Context.SendActivityAsync(didntUnderstandMessage, cancellationToken);
                break;
        }
    }

    return new DialogTurnResult(DialogTurnStatus.Complete);
}

dialogSkillBot/dialogs/activityRouterDialog.js

/**
 * This method just gets a message activity and runs it through LUIS.
 */
async onMessageActivity(stepContext) {
    const activity = stepContext.context.activity;
    const traceActivity = {
        type: ActivityTypes.Trace,
        timestamp: new Date(),
        text: 'ActivityRouterDialog.onMessageActivity()',
        label: `Text: ${ activity.text }, Value: ${ JSON.stringify(activity.value) }`
    };
    await stepContext.context.sendActivity(traceActivity);

    if (!this.luisRecognizer || !this.luisRecognizer.isConfigured) {
        await stepContext.context.sendActivity(
            'NOTE: LUIS is not configured. To enable all capabilities, please add \'LuisAppId\', \'LuisAPIKey\' and \'LuisAPIHostName\' to the appsettings.json file.',
            undefined,
            InputHints.IgnoringInput
        );
    } else {
        // Call LUIS with the utterance.
        const luisResult = await this.luisRecognizer.executeLuisQuery(stepContext.context);
        const topIntent = LuisRecognizer.topIntent(luisResult);

        // Create a message showing the LUIS result.
        let resultString = '';
        resultString += `LUIS results for "${ activity.text }":\n`;
        resultString += `Intent: "${ topIntent }", Score: ${ luisResult.intents[topIntent].score }\n`;

        await stepContext.context.sendActivity(resultString, undefined, InputHints.IgnoringInput);

        switch (topIntent.intent) {
            case 'BookFlight':
                return await this.beginBookFlight(stepContext);
            case 'GetWeather':
                return await this.beginGetWeather(stepContext);
            default: {
                // Catch all for unhandled intents.
                const didntUnderstandMessageText = `Sorry, I didn't get that. Please try asking in a different way (intent was ${ topIntent.intent })`;
                await stepContext.context.sendActivity(didntUnderstandMessageText, didntUnderstandMessageText, InputHints.IgnoringInput);
                break;
            }
        }
    }

    return { status: DialogTurnStatus.complete };
}

DialogSkillBot\Dialogs\ActivityRouterDialog.java

// This method just gets a message activity and runs it through LUS.
private CompletableFuture<DialogTurnResult> onMessageActivity(WaterfallStepContext stepContext) {
    Activity activity = stepContext.getContext().getActivity();
    TurnContext.traceActivity(
        stepContext.getContext(),
        String.format(
            "%s.onMessageActivity(), label: %s, Value: %s",
            this.getClass().getName(),
            activity.getName(),
            GetObjectAsJsonString(activity.getValue())
        )
    );

    if (!luisRecognizer.getIsConfigured()) {
        String message = "NOTE: LUIS instanceof not configured. To enable all capabilities, add 'LuisAppId',"
            + " 'LuisAPKey' and 'LuisAPHostName' to the appsettings.json file.";
        return stepContext.getContext()
            .sendActivity(MessageFactory.text(message, message, InputHints.IGNORING_INPUT))
            .thenCompose(
                result -> CompletableFuture.completedFuture(new DialogTurnResult(DialogTurnStatus.COMPLETE))
            );
    } else {
        // Call LUIS with the utterance.
        return luisRecognizer.recognize(stepContext.getContext(), RecognizerResult.class)
            .thenCompose(luisResult -> {
                // Create a message showing the LUS results.
                StringBuilder sb = new StringBuilder();
                sb.append(String.format("LUIS results for \"%s\":", activity.getText()));

                sb.append(
                    String.format(
                        "Intent: \"%s\" Score: %s",
                        luisResult.getTopScoringIntent().intent,
                        luisResult.getTopScoringIntent().score
                    )
                );

                return stepContext.getContext()
                    .sendActivity(MessageFactory.text(sb.toString(), sb.toString(), InputHints.IGNORING_INPUT))
                    .thenCompose(result -> {
                        switch (luisResult.getTopScoringIntent().intent.toLowerCase()) {
                            case "bookflight":
                                return beginBookFlight(stepContext);

                            case "getweather":
                                return beginGetWeather(stepContext);

                            default:
                                // Catch all for unhandled intents.
                                String didntUnderstandMessageText = String.format(
                                    "Sorry, I didn't get that. Please try asking in a different "
                                    + "way (intent was %s)",
                                    luisResult.getTopScoringIntent().intent
                                );
                                Activity didntUnderstandMessage = MessageFactory.text(
                                    didntUnderstandMessageText,
                                    didntUnderstandMessageText,
                                    InputHints.IGNORING_INPUT
                                );
                                return stepContext.getContext()
                                    .sendActivity(didntUnderstandMessage)
                                    .thenCompose(
                                        stepResult -> CompletableFuture
                                            .completedFuture(new DialogTurnResult(DialogTurnStatus.COMPLETE))
                                    );

                        }
                    });
                // Start a dialog if we recognize the intent.
            });
    }
}

dialog-skill-bot/dialogs/activity_router_dialog.py

async def _on_message_activity(
    self, step_context: WaterfallStepContext
) -> DialogTurnResult:
    """
    This method just gets a message activity and runs it through LUIS.
    """

    activity = step_context.context.activity

    if not self._luis_recognizer.is_configured:
        await step_context.context.send_activity(
            MessageFactory.text(
                "NOTE: LUIS is not configured. To enable all capabilities, add 'LuisAppId', 'LuisAPIKey' and"
                " 'LuisAPIHostName' to the config.py file.",
                input_hint=InputHints.ignoring_input,
            )
        )
    else:
        # Call LUIS with the utterance.
        luis_result = await self._luis_recognizer.recognize(step_context.context)

        message = f'LUIS results for "{activity.Text}":\n'
        intent, intent_score = None, None
        if luis_result.intents:
            max_value_key = max(
                luis_result.intents, key=lambda key: luis_result.intents[key]
            )
            intent, intent_score = max_value_key, luis_result.intents[max_value_key]

        message += f'Intent: "{intent}" Score: {intent_score}\n'

        await step_context.context.send_activity(
            MessageFactory.text(message, input_hint=InputHints.ignoring_input,)
        )

        # Start a dialog if we recognize the intent.
        top_intent = luis_result.get_top_scoring_intent().intent

        if top_intent == "BookFlight":
            return await self._begin_book_flight(step_context)

        if top_intent == "GetWeather":
            return await self._begin_get_weather(step_context)

        # Catch all for unhandled intents.
        didnt_understand_message_text = f"Sorry, I didn't get that. Please try asking in a different way (intent was {top_intent})"
        await step_context.context.send_activity(
            MessageFactory.text(
                didnt_understand_message_text,
                didnt_understand_message_text,
                input_hint=InputHints.ignoring_input,
            )
        )

    return DialogTurnResult(DialogTurnStatus.Complete)

Többlépéses művelet indítása

A foglalási művelet egy többlépéses párbeszédpanelt indít el a foglalás részleteinek lekéréséhez a felhasználótól.

A get-weather művelet nincs implementálva. Jelenleg egy helyőrző üzenetet küld, majd véget ér.

DialogSkillBot\Dialogs\ActivityRouterDialog.cs

private async Task<DialogTurnResult> BeginBookFlight(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
    var activity = stepContext.Context.Activity;
    var bookingDetails = new BookingDetails();
    if (activity.Value != null)
    {
        bookingDetails = JsonConvert.DeserializeObject<BookingDetails>(JsonConvert.SerializeObject(activity.Value));
    }

    // Start the booking dialog.
    var bookingDialog = FindDialog(nameof(BookingDialog));
    return await stepContext.BeginDialogAsync(bookingDialog.Id, bookingDetails, cancellationToken);
}

private static async Task<DialogTurnResult> BeginGetWeather(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
    var activity = stepContext.Context.Activity;
    var location = new Location();
    if (activity.Value != null)
    {
        location = JsonConvert.DeserializeObject<Location>(JsonConvert.SerializeObject(activity.Value));
    }

    // We haven't implemented the GetWeatherDialog so we just display a TODO message.
    var getWeatherMessageText = $"TODO: get weather for here (lat: {location.Latitude}, long: {location.Longitude}";
    var getWeatherMessage = MessageFactory.Text(getWeatherMessageText, getWeatherMessageText, InputHints.IgnoringInput);
    await stepContext.Context.SendActivityAsync(getWeatherMessage, cancellationToken);
    return new DialogTurnResult(DialogTurnStatus.Complete);
}

dialogSkillBot/dialogs/activityRouterDialog.js

async beginBookFlight(stepContext) {
    const activity = stepContext.context.activity;
    const bookingDetails = activity.value || {};

    // Start the booking dialog.
    const bookingDialog = this.findDialog(BOOKING_DIALOG);
    return await stepContext.beginDialog(bookingDialog.id, bookingDetails);
}

async beginGetWeather(stepContext) {
    const activity = stepContext.context.activity;
    const location = activity.value || {};

    // We haven't implemented the GetWeatherDialog so we just display a TODO message.
    const getWeatherMessageText = `TODO: get weather for here (lat: ${ location.latitude }, long: ${ location.longitude })`;
    await stepContext.context.sendActivity(getWeatherMessageText, getWeatherMessageText, InputHints.IgnoringInput);
    return { status: DialogTurnStatus.complete };
}

DialogSkillBot\Dialogs\ActivityRouterDialog.java

private CompletableFuture<DialogTurnResult> beginBookFlight(WaterfallStepContext stepContext) {
    Activity activity = stepContext.getContext().getActivity();
    BookingDetails bookingDetails = new BookingDetails();
    if (activity.getValue() != null) {
        try {
            bookingDetails = Serialization.safeGetAs(activity.getValue(), BookingDetails.class);
        } catch (JsonProcessingException e) {
            // we already initialized bookingDetails above, so the flow will run as if
            // no details were sent.
        }
    }

    // Start the booking dialog.
    Dialog bookingDialog = findDialog("BookingDialog");
    return stepContext.beginDialog(bookingDialog.getId(), bookingDetails);
}

private static CompletableFuture<DialogTurnResult> beginGetWeather(WaterfallStepContext stepContext) {
    Activity activity = stepContext.getContext().getActivity();
    Location location = new Location();
    if (activity.getValue() != null) {
        try {
            location = Serialization.safeGetAs(activity.getValue(), Location.class);
        } catch (JsonProcessingException e) {
            // something went wrong, so we create an empty Location so we won't get a null
            // reference below when we acess location.
            location = new Location();
        }

    }

    // We haven't implemented the GetWeatherDialog so we just display a TODO
    // message.
    String getWeatherMessageText = String
        .format("TODO: get weather for here (lat: %s, long: %s)", location.getLatitude(), location.getLongitude());
    Activity getWeatherMessage =
        MessageFactory.text(getWeatherMessageText, getWeatherMessageText, InputHints.IGNORING_INPUT);
    return stepContext.getContext().sendActivity(getWeatherMessage).thenCompose(result -> {
        return CompletableFuture.completedFuture(new DialogTurnResult(DialogTurnStatus.COMPLETE));
    });

}

dialog-skill-bot/dialogs/activity_router_dialog.py

async def _begin_book_flight(
    self, step_context: WaterfallStepContext
) -> DialogTurnResult:
    activity = step_context.context.activity
    booking_details = BookingDetails()
    if activity.value:
        booking_details.from_json(activity.value)

    # Start the booking dialog
    booking_dialog = await self.find_dialog(BookingDialog.__name__)
    return await step_context.begin_dialog(booking_dialog.id, booking_details)

async def _begin_get_weather(
    self, step_context: WaterfallStepContext
) -> DialogTurnResult:
    activity = step_context.context.activity
    location = Location()
    if activity.value:
        location.from_json(activity.value)

    # We haven't implemented the GetWeatherDialog so we just display a TODO message.
    get_weather_message = f"TODO: get weather for here (lat: {location.latitude}, long: {location.longitude}"
    await step_context.context.send_activity(
        MessageFactory.text(
            get_weather_message, get_weather_message, InputHints.ignoring_input,
        )
    )

    return DialogTurnResult(DialogTurnStatus.Complete)

Eredmény visszaadása

A képesség elindít egy foglalási párbeszédpanelt a foglalási művelethez. Mivel a tevékenység-útválasztás párbeszédpanelnek csak egy lépése van, a foglalási párbeszédpanel végén a tevékenység-útválasztás párbeszédpanel is véget ér, és a foglalási párbeszédpanelen kapott párbeszédpanel lesz a tevékenység-útválasztás párbeszédpanel párbeszédpanel eredménye.

A get-weather művelet egyszerűen véget ér a visszatérési érték megadása nélkül.

Többlépéses művelet megszakítása

A foglalási párbeszédpanel és a gyermekdátum-feloldó párbeszédpanel egyaránt az alapszintű lemondási és súgó párbeszédpanelből származik, amely ellenőrzi a felhasználótól érkező üzeneteket.

A "súgó" vagy a "?", akkor megjelenik egy súgóüzenet, majd folytatja a beszélgetési folyamatot a következő sor.
A "mégse" vagy a "kilépés" lehetőségnél megszakítja az összes párbeszédpanelt, ami befejezi a készséget.

További információkért tekintse meg a felhasználói megszakítások kezelését.

Szolgáltatásregisztráció

Az ehhez a képességhez szükséges szolgáltatások megegyeznek a képességrobotok általános szolgáltatásaival. Megtudhatja, hogyan valósíthat meg készséget a szükséges szolgáltatások megvitatásához.

Készségjegyzék

A képességjegyzék egy JSON-fájl, amely leírja a képesség által elvégezhető tevékenységeket, azok bemeneti és kimeneti paramétereit, valamint a képesség végpontjait. A jegyzék tartalmazza azokat az információkat, amelyekre szüksége van a képesség eléréséhez egy másik robottól.

DialogSkillBot\wwwroot\manifest\dialogchildbot-manifest-1.0.json

{
  "$schema": "https://schemas.botframework.com/schemas/skills/skill-manifest-2.0.0.json",
  "$id": "DialogSkillBot",
  "name": "Skill bot with dialogs",
  "version": "1.0",
  "description": "This is a sample skill definition for multiple activity types.",
  "publisherName": "Microsoft",
  "privacyUrl": "https://dialogskillbot.contoso.com/privacy.html",
  "copyright": "Copyright (c) Microsoft Corporation. All rights reserved.",
  "license": "",
  "iconUrl": "https://dialogskillbot.contoso.com/icon.png",
  "tags": [
    "sample",
    "travel",
    "weather",
    "luis"
  ],
  "endpoints": [
    {
      "name": "default",
      "protocol": "BotFrameworkV3",
      "description": "Default endpoint for the skill.",
      "endpointUrl": "https://dialogskillbot.contoso.com/api/messages",
      "msAppId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "activities": {
    "bookFlight": {
      "description": "Books a flight (multi turn).",
      "type": "event",
      "name": "BookFlight",
      "value": {
        "$ref": "#/definitions/bookingInfo"
      },
      "resultValue": {
        "$ref": "#/definitions/bookingInfo"
      }
    },
    "getWeather": {
      "description": "Retrieves and returns the weather for the user's location.",
      "type": "event",
      "name": "GetWeather",
      "value": {
        "$ref": "#/definitions/location"
      },
      "resultValue": {
        "$ref": "#/definitions/weatherReport"
      }
    },
    "passthroughMessage": {
      "type": "message",
      "description": "Receives the user's utterance and attempts to resolve it using the skill's LUIS models.",
      "value": {
        "type": "object"
      }
    }
  },
  "definitions": {
    "bookingInfo": {
      "type": "object",
      "required": [
        "origin"
      ],
      "properties": {
        "origin": {
          "type": "string",
          "description": "This is the origin city for the flight."
        },
        "destination": {
          "type": "string",
          "description": "This is the destination city for the flight."
        },
        "travelDate": {
          "type": "string",
          "description": "The date for the flight in YYYY-MM-DD format."
        }
      }
    },
    "weatherReport": {
      "type": "array",
      "description": "Array of forecasts for the next week.",
      "items": [
        {
          "type": "string"
        }
      ]
    },
    "location": {
      "type": "object",
      "description": "Location metadata.",
      "properties": {
        "latitude": {
          "type": "number",
          "title": "Latitude"
        },
        "longitude": {
          "type": "number",
          "title": "Longitude"
        },
        "postalCode": {
          "type": "string",
          "title": "Postal code"
        }
      }
    }
  }
}

dialogSkillBot/manifest/dialogchildbot-manifest-1.0.json

{
  "$schema": "https://schemas.botframework.com/schemas/skills/skill-manifest-2.0.0.json",
  "$id": "dialogSkillBot",
  "name": "Skill bot with dialogs",
  "version": "1.0",
  "description": "This is a sample skill definition for multiple activity types.",
  "publisherName": "Microsoft",
  "privacyUrl": "https://dialogskillbot.contoso.com/privacy.html",
  "copyright": "Copyright (c) Microsoft Corporation. All rights reserved.",
  "license": "",
  "iconUrl": "https://dialogskillbot.contoso.com/icon.png",
  "tags": [
    "sample",
    "travel",
    "weather",
    "luis"
  ],
  "endpoints": [
    {
      "name": "default",
      "protocol": "BotFrameworkV3",
      "description": "Default endpoint for the skill.",
      "endpointUrl": "https://dialogskillbot.contoso.com/api/messages",
      "msAppId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "activities": {
    "bookFlight": {
      "description": "Books a flight (multi turn).",
      "type": "event",
      "name": "BookFlight",
      "value": {
        "$ref": "#/definitions/bookingInfo"
      },
      "resultValue": {
        "$ref": "#/definitions/bookingInfo"
      }
    },
    "getWeather": {
      "description": "Retrieves and returns the weather for the user's location.",
      "type": "event",
      "name": "GetWeather",
      "value": {
        "$ref": "#/definitions/location"
      },
      "resultValue": {
        "$ref": "#/definitions/weatherReport"
      }
    },
    "passthroughMessage": {
      "type": "message",
      "description": "Receives the user's utterance and attempts to resolve it using the skill's LUIS models.",
      "value": {
        "type": "object"
      }
    }
  },
  "definitions": {
    "bookingInfo": {
      "type": "object",
      "required": [
        "origin"
      ],
      "properties": {
        "origin": {
          "type": "string",
          "description": "This is the origin city for the flight."
        },
        "destination": {
          "type": "string",
          "description": "This is the destination city for the flight."
        },
        "travelDate": {
          "type": "string",
          "description": "The date for the flight in YYYY-MM-DD format."
        }
      }
    },
    "weatherReport": {
      "type": "array",
      "description": "Array of forecasts for the next week.",
      "items": [
        {
          "type": "string"
        }
      ]
    },
    "location": {
      "type": "object",
      "description": "Location metadata.",
      "properties": {
        "latitude": {
          "type": "number",
          "title": "Latitude"
        },
        "longitude": {
          "type": "number",
          "title": "Longitude"
        },
        "postalCode": {
          "type": "string",
          "title": "Postal code"
        }
      }
    }
  }
}

dialog-skill-bot\webapp\manifest\dialogchildbot-manifest-1.0.json

{
  "$schema": "https://schemas.botframework.com/schemas/skills/skill-manifest-2.0.0.json",
  "$id": "DialogSkillBot",
  "name": "Skill bot with dialogs",
  "version": "1.0",
  "description": "This is a sample skill definition for multiple activity types.",
  "publisherName": "Microsoft",
  "privacyUrl": "https://dialogskillbot.contoso.com/privacy.html",
  "copyright": "Copyright (c) Microsoft Corporation. All rights reserved.",
  "license": "",
  "iconUrl": "https://dialogskillbot.contoso.com/icon.png",
  "tags": [
    "sample",
    "travel",
    "weather",
    "luis"
  ],
  "endpoints": [
    {
      "name": "default",
      "protocol": "BotFrameworkV3",
      "description": "Default endpoint for the skill.",
      "endpointUrl": "https://dialogskillbot.contoso.com/api/messages",
      "msAppId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "activities": {
    "bookFlight": {
      "description": "Books a flight (multi turn).",
      "type": "event",
      "name": "BookFlight",
      "value": {
        "$ref": "#/definitions/bookingInfo"
      },
      "resultValue": {
        "$ref": "#/definitions/bookingInfo"
      }
    },
    "getWeather": {
      "description": "Retrieves and returns the weather for the user's location.",
      "type": "event",
      "name": "GetWeather",
      "value": {
        "$ref": "#/definitions/location"
      },
      "resultValue": {
        "$ref": "#/definitions/weatherReport"
      }
    },
    "passthroughMessage": {
      "type": "message",
      "description": "Receives the user's utterance and attempts to resolve it using the skill's LUIS models.",
      "value": {
        "type": "object"
      }
    }
  },
  "definitions": {
    "bookingInfo": {
      "type": "object",
      "required": [
        "origin"
      ],
      "properties": {
        "origin": {
          "type": "string",
          "description": "This is the origin city for the flight."
        },
        "destination": {
          "type": "string",
          "description": "This is the destination city for the flight."
        },
        "travelDate": {
          "type": "string",
          "description": "The date for the flight in YYYY-MM-DD format."
        }
      }
    },
    "weatherReport": {
      "type": "array",
      "description": "Array of forecasts for the next week.",
      "items": [
        {
          "type": "string"
        }
      ]
    },
    "location": {
      "type": "object",
      "description": "Location metadata.",
      "properties": {
        "latitude": {
          "type": "number",
          "title": "Latitude"
        },
        "longitude": {
          "type": "number",
          "title": "Longitude"
        },
        "postalCode": {
          "type": "string",
          "title": "Postal code"
        }
      }
    }
  }
}

dialog-skill-bot/wwwroot/manifest/dialogchildbot-manifest-1.0.json

{
  "$schema": "https://schemas.botframework.com/schemas/skills/skill-manifest-2.0.0.json",
  "$id": "DialogSkillBot",
  "name": "Skill bot with dialogs",
  "version": "1.0",
  "description": "This is a sample skill definition for multiple activity types.",
  "publisherName": "Microsoft",
  "privacyUrl": "https://dialogskillbot.contoso.com/privacy.html",
  "copyright": "Copyright (c) Microsoft Corporation. All rights reserved.",
  "license": "",
  "iconUrl": "https://dialogskillbot.contoso.com/icon.png",
  "tags": [
    "sample",
    "travel",
    "weather",
    "luis"
  ],
  "endpoints": [
    {
      "name": "default",
      "protocol": "BotFrameworkV3",
      "description": "Default endpoint for the skill.",
      "endpointUrl": "https://dialogskillbot.contoso.com/api/messages",
      "msAppId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "activities": {
    "bookFlight": {
      "description": "Books a flight (multi turn).",
      "type": "event",
      "name": "BookFlight",
      "value": {
        "$ref": "#/definitions/bookingInfo"
      },
      "resultValue": {
        "$ref": "#/definitions/bookingInfo"
      }
    },
    "getWeather": {
      "description": "Retrieves and returns the weather for the user's location.",
      "type": "event",
      "name": "GetWeather",
      "value": {
        "$ref": "#/definitions/location"
      },
      "resultValue": {
        "$ref": "#/definitions/weatherReport"
      }
    },
    "passthroughMessage": {
      "type": "message",
      "description": "Receives the user's utterance and attempts to resolve it using the skill's LUIS models.",
      "value": {
        "type": "object"
      }
    }
  },
  "definitions": {
    "bookingInfo": {
      "type": "object",
      "required": [
        "origin"
      ],
      "properties": {
        "origin": {
          "type": "string",
          "description": "This is the origin city for the flight."
        },
        "destination": {
          "type": "string",
          "description": "This is the destination city for the flight."
        },
        "travelDate": {
          "type": "string",
          "description": "The date for the flight in YYYY-MM-DD format."
        }
      }
    },
    "weatherReport": {
      "type": "array",
      "description": "Array of forecasts for the next week.",
      "items": [
        {
          "type": "string"
        }
      ]
    },
    "location": {
      "type": "object",
      "description": "Location metadata.",
      "properties": {
        "latitude": {
          "type": "number",
          "title": "Latitude"
        },
        "longitude": {
          "type": "number",
          "title": "Longitude"
        },
        "postalCode": {
          "type": "string",
          "title": "Postal code"
        }
      }
    }
  }
}

A képességjegyzék-séma egy JSON-fájl, amely leírja a képességjegyzék sémáját. A legújabb sémaverzió a 2.1-es verzió.

A képességrobot tesztelése

A készséget az Emulátorban tesztelheti a készségfelhasználóval. Ehhez egyszerre kell futtatnia a készség- és készségfelhasználó robotokat is. Megtudhatja, hogyan használhat egy párbeszédpanelt a képesség konfigurálására vonatkozó információkért.

Töltse le és telepítse a legújabb Bot Framework Emulatort.

Futtassa a párbeszédpanel-képességrobotot és a párbeszédpanel gyökérrobotját helyileg a számítógépen. Ha útmutatásra van szüksége, tekintse meg a C#, JavaScript, Java vagy Python mintafájlját.README
Az Emulator használatával tesztelje a robotot.
- Amikor először csatlakozik a beszélgetéshez, a robot üdvözlő üzenetet jelenít meg, és megkérdezi, hogy milyen készséget szeretne meghívni. A minta készségrobotja csak egy képességgel rendelkezik.
- Válassza a DialogSkillBot lehetőséget.
Ezután a robot arra kéri, hogy válasszon egy műveletet a képességhez. Válassza a "BookFlight" lehetőséget.
1. A képesség megkezdi a könyv-repülési tevékenységet; válaszoljon a kérdésekre.
2. Ha a képesség befejeződött, a gyökérrobot megjeleníti a foglalás részleteit, mielőtt újra rákérdez a meghívni kívánt képességre.
Válassza ismét a DialogSkillBot és a "BookFlight" lehetőséget.
1. Válaszoljon az első kérdésre, majd a művelet megszakításához írja be a "mégse" szöveget.
2. A képességrobot a művelet befejezése nélkül ér véget, és a fogyasztó kéri a meghívni kívánt készséget.

További információ a hibakeresésről

Mivel a készségek és a készségfelhasználók közötti forgalom hitelesítése megtörtént, az ilyen robotok hibakereséséhez további lépések is szükségesek.

A készségfelhasználónak és az általa használt összes készségnek közvetlenül vagy közvetve futnia kell.
Ha a robotok helyileg futnak, és bármelyik robot rendelkezik alkalmazásazonosítóval és jelszóval, akkor minden robotnak érvényes azonosítókkal és jelszóval kell rendelkeznie.
Ha a robotok mindegyike üzembe van helyezve, tekintse meg, hogyan végezhet hibakeresést bármely csatornáról az ngrok használatával.
Ha a robotok egy része helyileg fut, és némelyik üzembe van helyezve, akkor megtudhatja, hogyan végezhet hibakeresést egy képesség- vagy képességfelhasználóban.

Ellenkező esetben ugyanúgy hibakeresést végezhet egy képességfelhasználón vagy képességen, mint más robotok. További információ: Robot hibakeresése és hibakeresés a Bot Framework Emulator használatával.

További információk

Egy készséget használó párbeszédpanel használatával megtudhatja, hogyan használhat fel készséget egy készség párbeszédpanel használatával.

Megosztás a következőn keresztül:

Párbeszédpanelek használata egy adott képességen belül

Előfeltételek

A minta ismertetése

Források

Alkalmazáskonfiguráció

Tevékenység-útválasztási logika

A párbeszédpanel inicializálása

Kezdeti tevékenység feldolgozása

Üzenettevékenységek kezelése

Többlépéses művelet indítása

Eredmény visszaadása

Többlépéses művelet megszakítása

Szolgáltatásregisztráció

Készségjegyzék

A képességrobot tesztelése

További információ a hibakeresésről

További információk

További források