Udostępnij za pośrednictwem


Tworzenie bota przy użyciu zestawu Bot Framework SDK

DOTYCZY: ZESTAW SDK w wersji 4

W tym artykule opisano sposób tworzenia pierwszego bota przy użyciu zestawu Bot Framework SDK dla języków C#, Java, JavaScript lub Python oraz testowania bota za pomocą emulatora bota Bot Framework.

Utworzenie pierwszego bota nie wymaga subskrypcji platformy Azure ani zasobu usługi Azure AI Bot Service. Ten przewodnik Szybki start koncentruje się na tworzeniu pierwszego bota lokalnie. Jeśli chcesz dowiedzieć się, jak utworzyć bota na platformie Azure, zobacz Tworzenie zasobu usługi Azure Bot.

Uwaga

Aby tworzyć agentów z wybranymi usługami sztucznej inteligencji, orkiestracją i wiedzą, rozważ użycie zestawu SDK agentów platformy Microsoft 365. Zestaw SDK agentów obsługuje języki C#, JavaScript lub Python. Więcej informacji na temat zestawu SDK agentów można uzyskać na stronie aka.ms/agents. Jeśli szukasz platformy agenta opartej na modelu SaaS, rozważ microsoft Copilot Studio. Jeśli masz istniejącego bota utworzonego przy użyciu zestawu Bot Framework SDK, możesz zaktualizować bota do zestawu SDK agentów. Wskazówki dotyczące migracji z Bot Framework SDK do Agents SDK znajdziesz pod Bot Framework SDK to Agents SDK migration guidance, które omawiają podstawowe zmiany i aktualizacje. Zgłoszenia do pomocy technicznej dla zestawu Bot Framework SDK nie będą już obsługiwane od 31 grudnia 2025 r.

Wymagania wstępne

Szablony języka C#

Bieżące przykłady botów używają szablonów platformy .NET Core 3.1.

Aby dodać szablony botów do programu Visual Studio, pobierz i zainstaluj plik Bot Framework v4 SDK Templates for Visual Studio VSIX (Szablony zestawu BOT Framework w wersji 4 dla programu Visual Studio VSIX).

Uwaga

Szablony można zainstalować z poziomu programu Visual Studio.

  1. W menu wybierz pozycję Rozszerzenia, a następnie zarządzaj rozszerzeniami.
  2. W oknie dialogowym Zarządzanie rozszerzeniami wyszukaj i zainstaluj szablony zestawu Bot Framework w wersji 4 zestawu SDK dla programu Visual Studio.

Aby uzyskać informacje na temat wdrażania botów platformy .NET na platformie Azure, zobacz jak aprowizować i publikować bota.

Tworzenie bota

W programie Visual Studio utwórz nowy projekt bota i użyj szablonu Echo Bot (Bot Framework v4 — .NET Core 3.1). Aby wyświetlić tylko szablony botów, wybierz typ projektu Boty sztucznej inteligencji .

Dzięki szablonowi projekt zawiera cały kod niezbędny do utworzenia bota w tym przewodniku Szybki start. Nie potrzebujesz więcej kodu do przetestowania bota.

Uruchamianie bota

W programie Visual Studio:

  1. Otwórz projekt bota.
  2. Uruchom projekt bez debugowania.
  3. Program Visual Studio kompiluje aplikację, wdraża ją na hoście lokalnym i uruchamia przeglądarkę internetową, aby wyświetlić stronę aplikacji default.htm .

W tym momencie bot działa lokalnie na porcie 3978.

Uruchom emulator i połącz bota

  1. Uruchom program Bot Framework Emulator.

  2. Wybierz pozycję Otwórz bota na karcie Powitanie emulatora.

  3. Wprowadź adres URL bota, który jest hostem lokalnym i portem, z /api/messages dodanym do ścieżki. Adres to zwykle: http://localhost:3978/api/messages.

    otwieranie bota

  4. Następnie wybierz pozycję Połącz.

    Wyślij wiadomość do bota, a bot odpowie.

    komunikat echo

Następne kroki

  • Aby uzyskać informacje na temat debugowania przy użyciu programu Visual Studio lub Visual Studio Code i bot Framework Emulator, zobacz Debugowanie bota.
  • Aby uzyskać informacje o devtunnel, zobacz Tunelowanie (devtunnel).