scheyal / botv3v4migration Goto Github PK

View Code? Open in Web Editor NEW

0.0 0.0 1.0 34 KB

Repository for Bot Framework V3V4 Migration

C# 100.00%

botv3v4migration's People

Contributors

Watchers

Forkers

ericdahlvang

botv3v4migration's Issues

Docs: Add guidance for FormFlow usage in V4 vs V3

Help Cortana with V3V4 migration documentation

Migration Estimation Worksheet (JS)

ref: #28

Internal bots migration status

Doc: User State Migration (C#)

Sample: User State Migration (C#)

Doc roadmap plan (how far are we from 100%, what do we need to get to 100%)

Document Business value, what's new for overview page

Follow up on Dialog flow & interruption concepts/best practices from V3 to V4 (AC)

Sample: User State Migration (JS)

V3V4 differences summary similar to dotnet (JS)

Doc: User State Migration (JS)

Stop Portal V3 creations (7/1)

Engage migration of top 5 customers

Add quick reference for scorables to interruptions (cs)

Cognitive Services V3V4 Sample (JS)

Add a sample/snippet for JS IntentDialog Equivalence

What's the equivalent practice of IntentDialog with example

Add Migration Estimation Worksheet to docs (C#)

S.NO	Command /details	V3	V4	Detected Occurrences	Complexity
1	To get the incoming activity	IDialogContext.Activity	ITurnContext.Activity	count	Simple
2	To create and send an activity to the user	activity.CreateReply(“text”) IDialogContext.PostAsync	MessageFactory.Text(“text”) ITurnContext.SendActivityAsync	count	Simple
3	State management	UserData, ConversationData, and PrivateConversationData context.UserData.SetValue context.UserData.TryGetValue botDataStore.LoadAsyn	UserState, ConversationState, and PrivateConversationState With property accessors	context.UserData.SetValue - count context.UserData.TryGetValue - count botDataStore.LoadAsyn - count	Medium to Large (User State solution available)
4	Handle the start of your dialog	Implement IDialog.StartAsync	Make this the first step of a waterfall dialog.	<count	Simple
5	Send an activity	IDialogContext.PostAsync.	Call ITurnContext.SendActivityAsync.	count	Simple
6	Wait for a user's response	Use an IAwaitableparameter and call IDialogContext.Wait	Return await ITurnContext.PromptAsync to begin a prompt dialog. Then retrieve the result in the next step of the waterfall.	count	Medium (depends on flow)
7	Handle continuation of your dialog	IDialogContext.Wait	Add additional steps to a waterfall dialog, or implement Dialog.ContinueDialogAsync	count	Large
8	Signal the end of processing until the user's next message	IDialogContext.Wait	Return Dialog.EndOfTurn.	count	Medium
9	Begin a child dialog	IDialogContext.Call	Return await the step context's BeginDialogAsyncmethod. If the child dialog returns a value, that value is available in the next step of the waterfall via the step context's Resultproperty.	count	Medium
10	Replace the current dialog with a new dialog	IDialogContext.Forward	Return await ITurnContext.ReplaceDialogAsync.	count	Large
11	Signal that the current dialog has completed	IDialogContext.Done	Return await the step context's EndDialogAsync method.	count	Medium
12	Fail out of a dialog.	IDialogContext.Fail	Throw an exception to be caught at another level of the bot, end the step with a status of Cancelled, or call the step or dialog context's CancelAllDialogsAsync.	count	Simple

#28

Ensure coordination of migration with Teams

Add Customer Recognizer sample for JS

Add quick reference for triggerActions to interruptions (js)

Could use the answer here as a starting point: https://stackoverflow.com/questions/57447079/how-to-implement-trigger-action-in-bot-framework-v4

V3 creation/use telemetry & dashboard with pivots on sources, use volume

Need:

requirements design
access to data
assign dev

Add Estimation worksheet to documentation

Something like:

NO	Command /details	V3	V4	Detected Occurrences	Complexity
1	To get the incoming activity	IDialogContext.Activity	ITurnContext.Activity		Simple
2	To create and send an activity to the user	Iactivity.CreateReply(“text”) IDialogContext.PostAsync	MessageFactory.Text(“text”) ITurnContext.SendActivityAsync		Simple
3	State management	UserData, ConversationData, and PrivateConversationData context.UserData.SetValue context.UserData.TryGetValue botDataStore.LoadAsync	UserState, ConversationState, and PrivateConversationState With property accessors	context.UserData.SetValue - context.UserData.TryGetValue - botDataStore.LoadAsyn -	Medium to Large (User State solution available)
4	Handle the start of your dialog	Implement IDialog.StartAsync	Make this the first step of a waterfall dialog.	<count	Simple
5	Send an activity	Call IDialogContext.PostAsync.	Call ITurnContext.SendActivityAsync.		Simple
6	Wait for a user's response	Use an IAwaitableparameter and call IDialogContext.Wait	Return await ITurnContext.PromptAsync to begin a prompt dialog. Then retrieve the result in the next step of the waterfall.		Medium (depends on flow)
7	Handle continuation of your dialog	Call IDialogContext.Wait.	Add additional steps to a waterfall dialog, or implement Dialog.ContinueDialogAsync		Large
8	Signal the end of processing until the user's next message	Call IDialogContext.Wait or IDialogContext.Done	Return Dialog.EndOfTurn.		Medium
9	Begin a child dialog	Call IDialogContext.Call.	Return await the step context's BeginDialogAsync method. If the child dialog returns a value, that value is available in the next step of the waterfall via the step context's Resultproperty.		Medium
10	Replace the current dialog with a new dialog	Call IDialogContext.Forward.	Return await ITurnContext.ReplaceDialogAsync.		Large
11	Signal that the current dialog has completed	Call IDialogContext.Done.	return await the step context's EndDialogAsync method.		Medium
12	Fail out of a dialog.	Call IDialogContext.Fail.	Throw an exception to be caught at another level of the bot, end the step with a status of Cancelled, or call the step or dialog context's CancelAllDialogsAsync.		Simple

Create V3 Skill sample + docs

Maybe a natural extension would be to add a V3 skill head to the V3V4 contoso migration example?

So it’ll roughly look like this:
• Upgrade the example to V4.8 (private for now)
o Contains: install app, reset password, local admin…
• Add Skill head
• Add a V4 front-end
• Add V4 only functionality:
o Contains: view system settings, reboot, virus scan, patch with windows update…
• Add PVA
o Contains: add / remove computer to monitored group, view monitored computers, call V4 skill for specific computer
• (all operations are fake)
• (we can start with the C#)

Additional benefit:
• We get a sample and migration docs (including PVA!).

If agree, do you have an estimate?

Thanks.

scheyal / botv3v4migration Goto Github PK

botv3v4migration's People

Contributors

Watchers

Forkers

botv3v4migration's Issues

Recommend Projects

Recommend Topics

Recommend Org