Udostępnij za pośrednictwem

Wyświetlanie formularza z przyciskiem Prześlij w Copilot Studio

  • Artykuł

Uwaga

Ten artykuł obejmuje tylko klasyczne czatboty. Aby rozszerzyć pomocników utworzonych w Copilot Studio, nie trzeba używać Bot Framework Composer. Wszystkie funkcje opisane w tym artykule są dostępne dla pomocników bezpośrednio w Copilot Studio.

Aby zwiększyć możliwości czatbota, utwórz niestandardowe sesje dialogowe przy użyciu aplikacji Bot Framework Composer, a następnie dodać je do pomocnika stworzonego w Copilot Studio.

W tym przykładzie dowiesz się, jak wyświetlić formularz z przyciskiem Prześlij w Copilot Studio za pomocą Composera.

Ważne

Integracja aplikacji Composer nie jest dostępna dla użytkowników posiadających tylko licencję Teams w usłudze Microsoft Copilot Studio. Wymagana jest licencja wersji próbnej lub pełna licencja usługi Microsoft Copilot Studio.

Wymagania wstępne

Tworzenie nowego wyzwalacza

  1. W Copilot Studio otwórz pomocnika z przykładu 3. Jeśli przykład 3 nie został jeszcze ukończony, zobacz Używanie funkcji Wyszukiwanie Bing jako rezerwowej wyszukiwarki w aplikacji Copilot Studio.

  2. Otwórz bota w aplikacji Composer. Aby uzyskać instrukcje dotyczące tej czynności, zobacz Wprowadzenie do Bot Framework Composer.

  3. W eksploratorze botów przejdź do głównej sesji dialogowej. Wybierz Więcej opcji (...), a następnie wybierz Dodaj nowy wyzwalacz.

  4. W oknie Tworzenie wyzwalacza:

    1. W obszarze Jaki jest typ tego wyzwalacza? wybierz opcję Zamiar rozpoznany.

    2. W obszarze Jak jest nazwa tego wyzwalacza? wprowadź StartTrial.

    3. W obszarze Frazy wyzwalające skopiuj i wklej następujące elementy:

      - start trial
- sign up to try
- register to try service

    4. Wybierz Prześlij.

    Zrzut ekranu okna tworzenia wyzwalacza.

  5. Przejdź do strony Odpowiedzi bota , wybierz usługę Contoso Meal Delivery Service, a następnie wybierz opcję Pokaż kod.

  6. Skopiuj poniższy element i wklej go w widoku kodu:

    # adaptivecardjson_StartTrialForm()
- ```
{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "Register for a meal plan trial:"
        },
        {
            "type": "Input.Text",
            "placeholder": "Please enter your Name",
            "id": "Name"
        },
        {
            "type": "Input.Text",
            "placeholder": "Please enter your Address",
            "id": "Address",
            "isMultiline": true
        },
        {
            "type": "Input.Number",
            "placeholder": "How many weeks",
            "id": "Weeks"
        },
        {
            "type": "ActionSet",
            "actions": [
                {
                    "type": "Action.Submit",
                    "title": "Submit",
                    "style": "positive"
                }
            ]
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.2"
}
```

    Każde pole danych wejściowych na tej karcie adaptacyjnej ma unikatowy identyfikator: Nazwa, Adres i Tygodnie.

  7. Skopiuj poniższy kod i wklej go w tym samym widoku kodu:

    # AdaptiveCard_StartTrialForm()
[Activity
    Attachments = ${json(adaptivecardjson_StartTrialForm())}
]

    Zrzut ekranu przedstawiający działanie dodane do odpowiedzi bota.

Dodawanie logiki konwersacji

  1. W tym celu przejdź do strony Tworzenie i wybierz wyzwalacz StartTrial.

  2. Na kanwie tworzenia wybierz pozycję Dodaj (+), Zadaj pytanie, a następnie Tekst.

  3. W okienku właściwości w sekcji Odpowiedzi bota wybierz pozycję Pokaż kod.

    Ostrzeżenie

    Dodanie w następnym kroku poniższego wyrażenia do edytora response zamiast edytora code spowoduje, że bot odpowie przy użyciu nieprzetworzonych danych JSON zamiast karty adaptacyjnej.

  4. Skopiuj i wklej następujące wyrażenie:

    - ${AdaptiveCard_StartTrialForm()}

  5. Wybierz kartę Dane wejściowych użytkownika w okienku właściwości, a następnie wykonaj następujące czynności:

    1. W obszarze Właściwości wprowadź wartość user.name.
    2. W obszarze Wartość wprowadź wartość =turn.activity.value.Name.

  6. Na kanwie tworzenia wybierz pozycję Dodaj (+), Zarządzaj właściwościami, a następnie Ustaw właściwości.

  7. W okienku właściwości wykonaj następujące czynności:

    1. W obszarze Przypisania wybierz pozycję Dodaj nowy, aby dodać pole Właściwość i pole Wartość.
    2. W obszarze Właściwości wprowadź wartość user.address
    3. W obszarze Wartość wprowadź wartość =turn.activity.value.Address.
    4. Wybierz pozycje Dodaj nowy, aby dodać inną właściwość i wartość.
    5. W obszarze Właściwości wprowadź wartość user.weeks.
    6. W obszarze Wartość wprowadź wartość =turn.activity.value.Weeks.

  8. Na kanwie tworzenia wybierz pozycję Dodaj (+), Zadaj pytanie.

  9. W edytorze odpowiedzi skopiuj i wklej następujący element:

    ${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.

  10. Na kanwie tworzenia wybierz pozycję Dodaj (+), a następnie Rozpocznij temat usługi Microsoft Copilot Studio.

  11. W okienku właściwości w obszarze Nazwa sesji dialogowej wybierz pozycję Koniec konwersacji.

Przetestuj swojego bota

  1. Opublikuj treść w module Composer, aby udostępnić ją w pomocniku Copilot Studio.

    Ważne

    Wybranie pozycji Opublikuj w aplikacji Composer powoduje udostępnienie zmian na potrzeby testowania, ale nie powoduje automatycznego opublikowania bota.

    Opublikuj bota w usłudze Microsoft Copilot Studio w celu zaktualizowania bota we wszystkich kanałach, z którymi jest połączony.

  2. W usłudze Copilot Studio przejdź do strony Tematy, aby zobaczyć nowy temat StartTrial.

  3. Otwórz okienko Testowanie bota i upewnij się, że opcja Śledzenie między tematami została włączona. Wprowadź wiadomość How do I sign up for a trial?, aby rozpocząć rozmowę.