Botframework-solutions: [TypeScript] "SkillMiddleware" 클래스는 2개가 아닌 3개의 매개변수를 허용해야 합니다.

@Edwardfelix08님 , 답변이 늦어 죄송합니다.
V4 Bot을 기술로 활성화하기 위한 문서를 검토했으며(문서 구조가 변경됨, 이전 링크에서 404를 반환함) 코드의 일부 변경 사항에 따라 올바르게 업데이트되지 않았음을 깨달았으므로 해당 문서를 업데이트합니다.

재현 단계에 따라 가상 도우미에 대한 일부 정보가 있고 이 정보를 가상 도우미의 SkillContext 에 저장하고 Skill이 메시지를 수신할 때 이 정보를 검색하기를 원한다는 것을 이해합니다. SkillContext . 이 올바른지?

안녕하세요 @dfavretto입니다.
네 맞습니다.

@Edwardfelix08님 , 안녕하세요, 우리는 이 시나리오를 테스트했으며 이 작업을 수행하는 방법에 대한 가이드를 만들었습니다. 것을 고려 샘플 비서가 우리가 이러한 목표를 달성하기 위해 필요한 몇 가지 사소한 수정으로 세 단계를 제공하고, 그래서 준비가 아웃 - 오브 - 박스 사용에이 시나리오가되지 않습니다 :

1. [Virtual Assistant] SkillContext에 정보 저장
2. [botbuilder-skills] SkillContext 정보가 필터링되어 Activity의 SemanticAction에 저장됩니다.
3. [Skill] 활동의 SemanticAction 정보로 SkillState 채우기

[Virtual Assistant] SkillContext에 정보 저장

먼저 원하는 정보를 나중에 검색하기 위해 저장 해야 합니다. 메시지를 Skill에 전달 하기 전에 이 작업을 수행해야 합니다. 바로 직전에 할 필요는 없습니다. 이 정보는 다른 단계에서 저장될 수 있습니다.

1. 내부 mainDialog 당신은 사용할 필요가 skillContextAccessor을 당신의 컨텍스트에 해당하는 SkillContext를 검색 할 수 있습니다. 이것은 다음 줄을 사용하여 수행할 수 있습니다.

   const sc: SkillContext = await this.skillContextAccessor.get(dc.context, new SkillContext());
   const skillContext: SkillContext = Object.assign(new SkillContext(), sc);
   

2. 이제 SkillContext 가 변수에 저장 SkillContext 내의 값은 키-값 쌍

   skillContext.setObj('location', locationObj);
   

3. 이 정보가 userState에 저장되도록 마지막으로, skillContextAccessor를 사용하여 SkillContext을 설정합니다 :

   await this.skillContextAccessor.set(dc.context, skillContext);
   

[botbuilder-skills] SkillContext 정보가 필터링되어 Activity의 SemanticAction에 저장됩니다.

SkillContext의 정보를 저장 한 후, 그것의 벌금 스킬에 메시지를 전달 만하는 메시지는 스킬의에 도달하기 전에 SkillDialog 내부 botbuilder-skills 동안 SkillContext을 처리 할 onBeginDialog 방법 에만 한 번 실행됩니다, 스킬이 처음으로 호출됩니다.

이 방법은 자동으로 다음 단계를 수행합니다.

1. 첫 번째 단계에서 수행 한 것과 동일한 방식으로
2. SkillManifest 는 슬롯을 가져오는 데 사용되며 이 정보는 matchSkillContextToSlots 메서드로 전송됩니다.
3. matchSkillContextToSlots 방법 내부에서 SkillContext는 슬롯 키 일치하는 모든 키를 찾기 위해 평가된다. 일치하는 각 키는 해당 SkillContext 의 키-값 쌍을 SemanticAction 에 저장하는 데 사용됩니다.
4. SemanticAction 이 있는 활동 ( Slots 와 일치하는 SkillContext 에서 검색된 정보)은 해당 Skill로 전달됩니다.

[Skill] 활동의 SemanticAction 정보로 SkillState 채우기

세 번째이자 마지막 단계는 다음 단계에 따라 가상 도우미에서 보낸 정보로 SkillState 를 채우는 것입니다.

1. Skill의 mainDialog 내부에는 populateStateFromSemanticAction 이라는 메서드
2. SkillState 를 업데이트하고 필요한 속성을 추가해야 합니다.
3. 필요에 따라 populateStateFromSemanticAction 을 수정하여 SemanticAction 에서 모든 속성을 가져와 SkillState에 저장합니다. 지금 이 메서드는 'Location' 속성을 예로 찾고 있으며 액세스하려는 속성으로 변경할 수 있습니다.
   typescript if (semanticAction !== undefined && Object.keys(semanticAction.entities) .find((key: string) => key === "location"))
4. 이제 어디에서나 Skill 내부의 SkillState에 액세스할 수 있습니다.

이 단계가 유용하기를 바랍니다 😊

@lauren-mills 이 접근 방식이 올바른지 확인할 수 있습니까? 😁

감사합니다 @dfavretto 가 작동하는지 확인하려고 합니다.

안녕하세요 @dfavretto 위의 솔루션을 시도했지만 작동하지 않았습니다. 여전히 "CustomSkillAdapter" 클래스에 업데이트 또는 코드 변경이 없는 것으로 표시됩니다.

@Edwardfelix08 당신이 직면한 문제가 정확히 무엇인지 알려 주실 수 있습니까? 또한 다음은 귀하를 도울 수 있는 방법을 더 잘 결정할 수 있는 몇 가지 안내 질문입니다.

1. Virtual Assistant 의 SkillContext 에 정보를 저장할 수 있습니까?
2. SkillManifest 가 필요한 슬롯으로 업데이트되었습니까?
3. Slot 의 키가 SkillContext 정보를 저장하는 데 사용된 키와 일치합니까?
4. 스킬의 populateStateFromSemanticAction 메소드가 주석 처리되지 않았습니까?

또한 CustomSkillAdapter 와 관련하여 이 시나리오에서는 해당 클래스를 변경할 필요가 없었습니다.

안녕하세요 @dfavretto ,
아래는 사용한 코드

1. Virtual Assistant의 SkillContext에 정보를 저장할 수 있습니까?

   VA 메인 다이얼로그.
   const sk: SkillContext = this.skillContextAccessor.get(dc.context, new SkillContext())을 기다립니다.
   const 기술 컨텍스트: SkillContext = Object.assign(new SkillContext(), sk);
   SkillContext.setObj('userState', userProfile);
   this.skillContextAccessor.set(dc.context, SkillContext)를 기다립니다.

2. SkillManifest가 필요한 슬롯으로 업데이트되었습니까?
   버지니아의 Skill.json
   "슬롯": [{
   "이름": "사용자 상태",
   "유형": ["IUserState"]
   }],

   스킬매니페스트
   "슬롯": [{
   "이름": "사용자 상태",
   "유형": ["IUserState"]
   }],

3. 슬롯의 키가 SkillContext에 정보를 저장하는 데 사용된 키와 일치합니까?
   populateStateFromSemanticAction 내부의 코드
   if (skillContext.ContainsKey('userState')) {
   ......
   ......
   }

4. Skill의 populateStateFromSemanticAction 메소드가 주석 처리되지 않았습니까?
   예, botSkill 내부에서 코드 양식 populateStateFromSemanticAction 메소드의 주석 처리를 제거했습니다.

우리가 사용해야 하는 봇 프레임 버전은 무엇입니까?
우리는 아래 패키지를 사용하고 있습니다.

    "botbuilder": "^4.5.3",
    "botbuilder-ai": "^4.5.3",
    "botbuilder-applicationinsights": "^4.5.3",
    "botbuilder-azure": "^4.5.3",
    "botbuilder-core": "^4.5.3",
    "botbuilder-dialogs": "^4.5.3",
    "botbuilder-skills": "^4.4.6",
    "botbuilder-solutions": "^4.4.6",
    "botframework-config": "^4.5.3",
    "botframework-connector": "^4.5.3",
    "botframework-schema": "^4.5.3",

@Edwardfelix08 , populateStateFromSemanticAction 메서드의 skillContext 에서 userState 값을 얻으려고 합니다. Virtual Assistant에 기입한 skillContext 는 더 이상 Skill 에 있는 것과 같지 않습니다.

이 상황을 활용하기 위해 Virtual Assistant의 skillContext 가 활동의 semanticAction 복사됩니다. Activity는 Virtual Assistant 에서 Skill로 전송되는 유일한 요소이며 이 정보를 얻기 위해 평가할 수 있습니다.

여기의 예입니다 populateStateFromSemanticAction 당신 얻을 것이다 userState 활동의에서 값 semanticAction :

protected async populateStateFromSemanticAction(context: TurnContext): Promise<void> {
        // Example of populating local state with data passed through semanticAction out of Activity
        const activity: Activity = context.activity;
        const semanticAction: SemanticAction | undefined = activity.semanticAction;
        if (semanticAction !== undefined && Object.keys(semanticAction.entities).find((key: string) => key === "userState")) {

            const userState: any = semanticAction.entities["userState"];
            const userStateObj = userState.properties["userState"];
            const state: SkillState = await this.stateAccessor.get(context, new SkillState());
            state.userState = userStateObj !== undefined ? userStateObj : userState;
            await this.stateAccessor.set(context, state);
        }
    }

@dfavretto 답변이 늦어 죄송합니다.
나는 같은 것을 시도했지만 여전히 값을 얻을 수 없습니다.
activity.semanticAction 이 정의되지 않았습니다.

@Edwardfelix08님 , 안녕하세요. SemanticAction 는 항상 일부 값으로 기본값이 설정되어 있으므로 일부 유효성 검사를 수행 했지만 시나리오를 재현할 수 없으므로 정의되지 않아야 합니다.

확인을 위해 가상 어시스턴트에서 다음과 같이 스킬을 호출하고 있습니까?

@darrenj - 다른 관점에서 이 문제에 접근할 수 있도록 지원 팀을 추가해야 합니까? TypeScript 구현 자체와 아무 관련이 없는 것 같지만 특정 시나리오에서는 여기에서 구현되고 있습니다.

안녕하세요 @dfavretto ,
답변이 늦어 죄송합니다. 여러분 덕분에 이 작업을 수행할 수 있었습니다. 우리는 프레임워크의 이전 버전을 참조하고 업데이트하고 코드와 교차 확인했으며 "populateStateFromSemanticAction"에 차이가 있었고 제안된 코드로 코드를 업데이트했고 매력처럼 작동하기 시작했습니다.

도와주셔서 감사합니다.

그 말을 들으니 대단해! 도움이 될 수 있어서 기쁩니다 😊