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.