SkillHandler Klasse

  • Referenz
Paket:
com.microsoft.bot.builder.skills
Maven-Artefakt:
com.microsoft.bot:bot-builder:4.14.3

public class SkillHandler
extends ChannelServiceHandler

Ein Bot Framework-Handler für Fähigkeiten.

Feldzusammenfassung

Modifizierer und Typ Feld und Beschreibung
static final java.lang.String SKILL_CONVERSATION_REFERENCE_KEY

Die Kompetenzunterhaltungsreferenz.

Zusammenfassung zum Konstruktor

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

Initialisiert eine neue Instanz der SkillHandler Klasse mithilfe eines Anmeldeinformationsanbieters.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
protected java.util.concurrent.CompletableFuture<java.lang.Void> onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

AufActivity()-API löschen.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

ReplyToActivity() API for Skill.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

SendToConversation() API for Skill.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

Aktualisieren SieActivity()-API auf.

Geerbte Methoden von 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

Geerbte Methoden von 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

Felddetails

SKILL_CONVERSATION_REFERENCE_KEY

public static final String SKILL_CONVERSATION_REFERENCE_KEY

Die Kompetenzunterhaltungsreferenz.

Details zum Konstruktor

SkillHandler

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

Initialisiert eine neue Instanz der SkillHandler Klasse mithilfe eines Anmeldeinformationsanbieters.

Parameter:

adapter - Eine Instanz der BotAdapter, die die Anforderung verarbeitet.
bot - Die IBot Instanz.
conversationIdFactory - Ein SkillConversationIdFactoryBase, um die Unterhaltungs-ID zu entpacken und dem aufrufenden Bot zuzuordnen.
credentialProvider - Der Anmeldeinformationsanbieter.
authConfig - Die Authentifizierungskonfiguration.
channelProvider - Der Kanalanbieter. Verwenden Sie ein MiddlewareSet Object, um mehrere Middleware-Komponenten im Konstruktor hinzuzufügen. Verwenden Sie die Use(Middleware ) -Methode, um dem Adapter nach der Konstruktion zusätzliche Middleware hinzuzufügen.

Details zur Methode

onDeleteActivity

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

OnDeleteActivity() API. Überschreiben Sie diese Methode, um eine vorhandene Aktivität zu löschen. In einigen Kanälen können Sie eine vorhandene Aktivität löschen, und wenn die Methode erfolgreich verläuft, wird die angegebene Aktivität entfernt.

Überschreibt:

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

Parameter:

claimsIdentity
conversationId
activityId

onReplyToActivity

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

ReplyToActivity() API for Skill. Mit dieser Methode können Sie auf eine Aktivität antworten. Dies unterscheidet sich geringfügig von SendToConversation(). * SendToConversation(conversationId) – fügt die Aktivität entsprechend dem Zeitstempel oder der Semantik des Kanals an das Ende der Unterhaltung an. * ReplyToActivity(conversationId,ActivityId) – fügt die Aktivität als Antwort auf eine andere Aktivität hinzu, wenn der Kanal sie unterstützt. Wenn der Kanal keine geschachtelten Antworten unterstützt, greift ReplyToActivity auf SendToConversation zurück. Verwenden Sie ReplyToActivity, wenn Sie auf eine bestimmte Aktivität in der Unterhaltung antworten. Verwenden Sie SendToConversation in allen anderen Fällen.

Überschreibt:

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

Parameter:

claimsIdentity - claimsIdentity für den Bot sollte "AudienceClaim", "AppIdClaim" und "ServiceUrlClaim" aufweisen.
conversationId - Unterhaltungs-ID.
activityId - activityId, auf die die Antwort lautet (OPTIONAL).
activity - Zu sendende Aktivität.

Gibt zurück:

Vorgang für eine Ressourcenantwort.

onSendToConversation

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

SendToConversation() API for Skill. Mit dieser Methode können Sie eine Aktivität an das Ende einer Unterhaltung senden. Dies unterscheidet sich geringfügig von ReplyToActivity(). * SendToConversation(conversationId) – fügt die Aktivität entsprechend dem Zeitstempel oder der Semantik des Kanals an das Ende der Unterhaltung an. * ReplyToActivity(conversationId,ActivityId) – fügt die Aktivität als Antwort auf eine andere Aktivität hinzu, wenn der Kanal sie unterstützt. Wenn der Kanal keine geschachtelten Antworten unterstützt, greift ReplyToActivity auf SendToConversation zurück. Verwenden Sie ReplyToActivity, wenn Sie auf eine bestimmte Aktivität in der Unterhaltung antworten. Verwenden Sie SendToConversation in allen anderen Fällen.

Überschreibt:

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

Parameter:

claimsIdentity - claimsIdentity für den Bot sollte "AudienceClaim", "AppIdClaim" und "ServiceUrlClaim" aufweisen.
conversationId - conversationId.
activity - Zu sendende Aktivität.

Gibt zurück:

Vorgang für eine Ressourcenantwort.

onUpdateActivity

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

OnUpdateActivity() API. Überschreiben Sie diese Methode, um eine zuvor gesendete vorhandene Aktivität zu bearbeiten. In einigen Kanälen können Sie eine vorhandene Aktivität bearbeiten, um den neuen Status einer Bot-Unterhaltung widerzuspiegeln. Beispielsweise können Sie Schaltflächen entfernen, nachdem jemand auf die Schaltfläche "Genehmigen" geklickt hat.

Überschreibt:

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

Parameter:

claimsIdentity
conversationId
activityId
activity

Gilt für: