Sdílet prostřednictvím


Klíčové koncepty v Direct Line API 3.0

Komunikaci mezi robotem a vlastní klientskou aplikací můžete povolit pomocí rozhraní API Direct Line. Tento článek představuje klíčové koncepty rozhraní DIRECT Line API 3.0 a poskytuje informace o relevantních vývojářských prostředcích. Klienta můžete sestavit pomocí sady SDK, rozhraní REST API nebo Webový chat.

Ověřování

Požadavky rozhraní DIRECT Line API 3.0 je možné ověřit buď pomocí tajného klíče, který získáte ze stránky konfigurace kanálu Direct Line na webu Azure Portal, nebo pomocí tokenu, který získáte za běhu. Další informace najdete v tématu Ověřování.

Zahájení konverzace

Konverzace direct line jsou explicitně otevřeny klienty a mohou běžet, pokud se robot a klient účastní a mají platné přihlašovací údaje. Další informace najdete v tématu Zahájení konverzace.

Odesílání zpráv

Pomocí rozhraní API Direct Line 3.0 může klient odesílat zprávy do robota vydáváním HTTP POST požadavků. Klient může odeslat jednu zprávu na požadavek. Další informace najdete v tématu Odeslání aktivity robotovi.

Příjem zpráv

Pomocí rozhraní API Direct Line 3.0 může klient přijímat zprávy z robota prostřednictvím WebSocket streamu nebo vydáváním HTTP GET požadavků. Pomocí některé z těchto technik může klient přijímat více zpráv od robota najednou jako součást .ActivitySet Další informace najdete v tématu Příjem aktivit od robota.

Materiály pro vývojáře

Klientské knihovny

Bot Framework poskytuje klientské knihovny, které usnadňují přístup k rozhraní DIRECT Line API 3.0 prostřednictvím jazyka C# a Node.js.

  • Pokud chcete použít klientskou knihovnu .NET v projektu sady Visual Studio, nainstalujte Microsoft.Bot.Connector.DirectLine balíček NuGet.s.

  • Pokud chcete použít Node.js klientskou knihovnu botframework-directlinejs , nainstalujte ji pomocí NPM (nebo stáhněte zdroj).

Ovládací prvek webového chatu

Bot Framework poskytuje ovládací prvek, který umožňuje vložit robota s přímým přístupem do klientské aplikace. Další informace naleznete v ovládacím prvku Microsoft Bot Framework WebChat.