SkillHandler Classe

  • Riferimento
Pacchetto:
com.microsoft.bot.builder.skills
Artefatto Maven:
com.microsoft.bot:bot-builder:4.14.3

public class SkillHandler
extends ChannelServiceHandler

Gestore di Bot Framework per le competenze.

Riepilogo dei campi

Modificatore e tipo Campo e descrizione
static final java.lang.String SKILL_CONVERSATION_REFERENCE_KEY

Riferimento alla conversazione della competenza.

Riepilogo dei costruttori

Costruttore Descrizione
SkillHandler(BotAdapter adapter, Bot bot, SkillConversationIdFactoryBase conversationIdFactory, CredentialProvider credentialProvider, AuthenticationConfiguration authConfig, ChannelProvider channelProvider)

Inizializza una nuova istanza della classe SkillHandler utilizzando un provider di credenziali.

Riepilogo dei metodi

Modificatore e tipo Metodo e descrizione
protected java.util.concurrent.CompletableFuture<java.lang.Void> onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

In'API DeleteActivity().
protected java.util.concurrent.CompletableFuture<ResourceResponse> onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

RispondiAPI ToActivity() per competenza.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

InviareAPI ToConversation() per skill.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

Nell'APIUpdateActivity().

Metodi ereditati da ChannelServiceHandler

getChannelProvider handleCreateConversation handleDeleteActivity handleDeleteConversationMember handleGetActivityMembers handleGetConversationMembers handleGetConversationPagedMembers handleGetConversations handleReplyToActivity handleSendConversationHistory handleSendToConversation handleUpdateActivity handleUploadAttachment onCreateConversation onDeleteActivity onDeleteConversationMember onGetActivityMembers onGetConversationMembers onGetConversationPagedMembers onGetConversations onReplyToActivity onSendConversationHistory onSendToConversation onUpdateActivity onUploadAttachment

Metodi ereditati da java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Dettagli del campo

SKILL_CONVERSATION_REFERENCE_KEY

public static final String SKILL_CONVERSATION_REFERENCE_KEY

Riferimento alla conversazione della competenza.

Dettagli costruttore

SkillHandler

public SkillHandler(BotAdapter adapter, Bot bot, SkillConversationIdFactoryBase conversationIdFactory, CredentialProvider credentialProvider, AuthenticationConfiguration authConfig, ChannelProvider channelProvider)

Inizializza una nuova istanza della classe SkillHandler utilizzando un provider di credenziali.

Parametri:

adapter - Istanza del BotAdapter che gestirà la richiesta.
bot - Istanza di IBot.
conversationIdFactory - Un SkillConversationIdFactoryBase per decomprimere l'ID conversazione ed eseguirne il mapping al bot chiamante.
credentialProvider - Provider di credenziali.
authConfig - Configurazione dell'autenticazione.
channelProvider - Provider di canali. Usare un oggetto MiddlewareSet per aggiungere più componenti middleware nel costruttore. Utilizzare il metodo Use(Middleware ) per aggiungere altri middleware all'adattatore dopo la costruzione.

Dettagli metodo

onDeleteActivity

protected CompletableFuture onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

API OnDeleteActivity(). Eseguire l'override di questo metodo per eliminare un'attività esistente. Alcuni canali consentono di eliminare un'attività esistente e, in caso di esito positivo, questo metodo rimuoverà l'attività specificata.

Override:

SkillHandler.onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

Parametri:

claimsIdentity
conversationId
activityId

onReplyToActivity

protected CompletableFuture onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

API ReplyToActivity() per competenza. Questo metodo consente di rispondere a un'attività. Questo è leggermente diverso da SendToConversation(). * SendToConversation(conversationId): aggiungerà l'attività alla fine della conversazione in base al timestamp o alla semantica del canale. * ReplyToActivity(conversationId,ActivityId): aggiunge l'attività come risposta a un'altra attività, se il canale lo supporta. Se il canale non supporta le risposte annidate, ReplyToActivity esegue il fallback a SendToConversation. Usare ReplyToActivity quando si risponde a un'attività specifica nella conversazione. Usare SendToConversation in tutti gli altri casi.

Override:

SkillHandler.onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

Parametri:

claimsIdentity - claimsIdentity per il bot deve avere AudienceClaim, AppIdClaim e ServiceUrlClaim.
conversationId - ID conversazione.
activityId - activityId la risposta è (FACOLTATIVA).
activity - Attività da inviare.

Restituisce:

attività per una risposta di risorsa.

onSendToConversation

protected CompletableFuture onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

API SendToConversation() per competenza. Questo metodo consente di inviare un'attività alla fine di una conversazione. Questo è leggermente diverso da ReplyToActivity(). * SendToConversation(conversationId): aggiungerà l'attività alla fine della conversazione in base al timestamp o alla semantica del canale. * ReplyToActivity(conversationId,ActivityId): aggiunge l'attività come risposta a un'altra attività, se il canale lo supporta. Se il canale non supporta le risposte annidate, ReplyToActivity esegue il fallback a SendToConversation. Usare ReplyToActivity quando si risponde a un'attività specifica nella conversazione. Usare SendToConversation in tutti gli altri casi.

Override:

SkillHandler.onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

Parametri:

claimsIdentity - claimsIdentity per il bot deve avere AudienceClaim, AppIdClaim e ServiceUrlClaim.
conversationId - conversationId.
activity - Attività da inviare.

Restituisce:

attività per una risposta di risorsa.

onUpdateActivity

protected CompletableFuture onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

API OnUpdateActivity(). Eseguire l'override di questo metodo per modificare un'attività esistente inviata in precedenza. Alcuni canali consentono di modificare un'attività esistente per riflettere il nuovo stato di una conversazione bot. Ad esempio, è possibile rimuovere i pulsanti dopo che un utente ha fatto clic sul pulsante "Approva".

Override:

SkillHandler.onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

Parametri:

claimsIdentity
conversationId
activityId
activity

Si applica a