Freigeben über


Verbinden von Azure Communication Services mit Foundry-Tools

Azure Communication Services Call Automation APIs ermöglichen es Entwicklern, Anrufe über Azure Communication Services zu steuern und zu kontrollieren, einschließlich Telefonie, VoIP und WebRTC. Diese APIs verwenden Echtzeitereignistrigger, die Aktionen basierend auf benutzerdefinierter Geschäftslogik aktivieren, die spezifisch für die Domäne jedes Entwicklers ist. Mit Anrufautomatisierungs-APIs können Entwickler einfache KI-basierte Features verwenden. So können sie beispielsweise personalisierte Begrüßungen spielen, gesprochene Antworten erkennen, um Informationen von Kunden zu sammeln und die Stimmung zu analysieren, um den Service zu verbessern. Diese gezielten APIs werden über Microsoft Foundry verwaltet, wodurch Entwickler KI-Modelle anpassen können. Wichtig: Entwickler müssen sich nicht mit Mediendatenströmen befassen oder sie für diese KI-Funktionen an Azure zurücksenden – die Verarbeitung erfolgt nahtlos.

All diese Funktionalität ist mit nur einem Klick möglich, sodass Unternehmen auf eine sichere Lösung zugreifen und ihre Modelle über das Portal verknüpfen können. Darüber hinaus müssen Fachkräfte in der Entwicklung und Unternehmen keine Anmeldeinformationen verwalten. Wenn Sie Ihre Foundry Tools verbinden, werden verwaltete Identitäten verwendet, um auf benutzereigene Ressourcen zuzugreifen. Fachkräfte in der Entwicklung können verwalteten Identitäten verwenden, um Ressourcen, die die Microsoft Entra-Authentifizierung unterstützen, zu authentifizieren.

Foundry Tools können ganz einfach in jede Anwendung integriert werden, unabhängig von der Programmiersprache. Aktivieren Sie beim Erstellen einer Azure-Ressource im Azure-Portal die Option und geben Sie die URL zu den Foundry Tools an. Mit dieser einfachen Erfahrung können Entwickler ihre Anforderungen erfüllen, skalieren und vermeiden, Zeit und Ressourcen in das Entwerfen und Verwalten einer benutzerdefinierten Lösung zu investieren.

Hinweis

Diese Integration unterstützt nur die Multi-Service-Ressource von Cognitive Services. Wir empfehlen Ihnen, beim Erstellen einer neuen Azure KI Services-Ressource eine Multi-Service-Ressource von Cognitive Services zu erstellen oder beim Verbinden einer bestehenden Ressource zu bestätigen, dass es sich um eine Multi-Service-Ressource von Cognitive Services handelt.

Gängige Anwendungsfälle

Erstellen von Anwendungen, die Sprache wiedergeben und erkennen können

Mit der Möglichkeit, Ihre Foundry Tools mit Azure Communication Services zu verbinden. Sie können benutzerdefinierte Wiedergabefunktionen mithilfe der Sprachsynthese- und Speech Synthesis Markup Language (SSML)-Konfiguration aktivieren, um den Benutzern und Benutzerinnen eine angepasste und natürlich klingende Audiowiedergabe zu ermöglichen. Über die Verbindung "Foundry Tools" können Sie auch den Sprach-To-Text-Dienst verwenden, um die Erkennung von Sprachantworten zu integrieren, die über die Geschäftslogik in der Anwendung in umsetzbare Aufgaben konvertiert werden können. Diese Funktionen können innerhalb von Foundry Tools weiter verbessert werden, indem:

  • Erstellen von benutzerdefinierten Modellen, die auf Ihre Domäne und Region zugeschnitten sind
  • Auswählen, welche Sprachen gesprochen und erkannt werden
  • Entwerfen von benutzerdefinierten Stimmen
  • Erstellen zusätzlicher Modelle basierend auf Ihrer Erfahrung

Laufzeitflow

Screenshot des Integration Runtime-Flows.

Azure-Portal-Benutzeroberfläche

Sie müssen Ihre Azure Communication Services-Ressource über das Azure-Portal mit der Azure AI-Ressource verbinden. Es gibt zwei Möglichkeiten, diesen Schritt zu vollziehen:

  • Durch die Schritte in der Registerkarte "Cognitive Services" in Azure Communication Services navigieren (empfohlen).
  • Manuelles Hinzufügen der verwalteten Identität zu Ihrer Azure Communication Services-Ressource. Dieser Schritt ist fortgeschrittener und erfordert etwas mehr Aufwand, um Ihre Azure Communication Services mit Ihren Foundry Tools zu verbinden.

Voraussetzungen

Herstellen einer Verbindung über das Azure-Portal

  1. Öffnen Sie Ihre Azure Communication Services-Ressource, und klicken Sie auf die Registerkarte „Cognitive Services“.

  2. Wenn die vom System zugewiesene verwaltete Identität nicht aktiviert ist, müssen Sie sie aktivieren.

  3. Klicken Sie auf der Registerkarte „Cognitive Services“ auf die Schaltfläche „Verwaltete Identität aktivieren“.

    Screenshot der Schaltfläche „Aktivieren der verwalteten Identität“.

  4. Aktivieren Sie systemseitig zugewiesene Identitäten. Mit dieser Aktion wird die Erstellung der Identität eingeleitet. Eine Popupbenachrichtigung informiert Sie darüber, dass die Anforderung verarbeitet wird. Screenshot: Aktivierung der verwalteten Identität.

  5. Sobald die Identität aktiviert ist, sollten Sie etwas Ähnliches sehen. Screenshot der aktivierten Identität.

  6. Wenn verwaltete Identität aktiviert ist, sollte auf der Registerkarte "Cognitive Service" eine Schaltfläche "Kognitiver Dienst verbinden" angezeigt werden, um die beiden Dienste zu verbinden. Screenshot: Schaltfläche „Cognitive Services verbinden“.

  7. Klicken Sie auf „Cognitive Service verbinden“, wählen Sie das Abonnement, die Ressourcengruppe und die Ressource aus, und klicken Sie in dem Kontextbereich, der daraufhin geöffnet wird, auf „Verbinden“. Screenshot der Bereiche „Abonnement“, „Ressourcengruppe“ und „Ressource“.

  8. Wenn die Verbindung erfolgreich hergestellt wurde, sollte ein grünes Banner angezeigt werden, das die erfolgreiche Verbindung bestätigt.

    Screenshot der erfolgreichen Verbindung.

  9. Jetzt sollten Ihre verbundenen Dienste auf der Registerkarte „Cognitive Service“ angezeigt werden. Screenshot des verbundenen Cognitive Services auf der Hauptseite.

Erweiterte Option: Manuelles Hinzufügen von verwalteter Identität zur Azure Communication Services-Ressource

Wenn Sie Ihre Ressourcen manuell verbinden möchten, können Sie auch die folgenden Schritte ausführen.

Aktivieren systemseitig zugewiesener Identitäten

  1. Navigieren Sie im Azure-Portal zu Ihrer Azure Communication Services-Ressource.
  2. Wählen Sie die Registerkarte „Identität“ aus.
  3. Aktivieren Sie systemseitig zugewiesene Identitäten. Diese Aktion beginnt mit der Erstellung der Identität. Es erscheint eine Popupbenachrichtigung, die Sie darüber informiert, dass die Anforderung verarbeitet wird. Screenshot der Aktivierung der Systemidentität.

Option 1: Hinzufügen einer Rolle aus Azure Cognitive Services im Azure-Portal

  1. Navigieren Sie zu Ihrer Azure Cognitive Services-Ressource.
  2. Wählen Sie die Registerkarte „Zugriffssteuerung (IAM)“ aus.
  3. Klicken Sie auf die Schaltfläche „Hinzufügen“.
  4. Wählen Sie im Menü „Rollenzuweisungen hinzufügen“ aus. Screenshot: Hinzufügen einer Rollenzuweisung.
  5. Wählen Sie die Rolle „Cognitive Services-Benutzer“ aus, die zugewiesen werden soll, und klicken Sie dann auf „Weiter“. Screenshot des Cognitive Services-Benutzers.
  6. Wählen Sie für das Feld „Zugriff zuweisen zu“ den Eintrag „Benutzer, Gruppe oder Dienstprinzipal“ aus.
  7. Klicken Sie auf „+Mitglieder auswählen". Daraufhin wird eine seitliche Registerkarte geöffnet.
  8. Suchen Sie im Textfeld nach dem Namen Ihrer Azure Communication Services-Ressource, und klicken Sie darauf, wenn er angezeigt wird. Klicken Sie anschließend auf „Auswählen“. Screenshot des ressourcenseitigen Bereichs „Azure Communication Services“.
  9. Klicken Sie auf „Überprüfen + zuweisen“. Daraufhin wird die Rolle der verwalteten Identität zugewiesen.

Option 2: Hinzufügen einer Rolle über die Registerkarte „ACS-Dienstidentität“

  1. Navigieren Sie im Azure-Portal zu Ihrer Azure Communication Services-Ressource.
  2. Wählen Sie die Registerkarte „Identität“ aus.
  3. Klicken Sie auf „Azure-Rollenzuweisungen“. Screenshot des Bildschirms „Rollenzuweisung“.
  4. Klicken Sie auf die Schaltfläche „Rollenzuweisung hinzufügen (Vorschau)“, woraufhin die Registerkarte „Rollenzuweisung hinzufügen (Vorschau)“ geöffnet wird.
  5. Wählen Sie „Ressourcengruppe“ als „Bereich“ aus.
  6. Wählen Sie das „Abonnement“ aus.
  7. Wählen Sie die „Ressourcengruppe“ aus, die den Cognitive Service-Dienst enthält.
  8. Wählen Sie die Rolle „Cognitive Services-Benutzer“ aus. Screenshot der Registerkarte „Rollenzuweisung“.
  9. Klicken Sie auf Speichern.

Ihre Azure Communication Service-Instanz ist jetzt mit Ihrer Azure Cognitive Service-Ressource verknüpft.

Unterstützte Foundry Tools-Regionen

Unsere Integration zwischen Azure Communication Services (ACS) und Azure AI ist vollständig auf die regionale Verfügbarkeit von Foundry abgestimmt. Dies bedeutet, dass die Integration von ACS in Azure AI in allen Regionen unterstützt wird, in denen Foundry verfügbar ist.

In der offiziellen Foundry-Dokumentation finden Sie die aktuellste Liste der unterstützten Regionen.

Bekannte Einschränkungen

  • Text-zu-Sprache-Eingabeaufforderungen unterstützen maximal 4000 Zeichen, wenn Ihre Eingabeaufforderung länger als dies ist, empfehlen wir die Verwendung von SSML für Text-zu-Sprache-basierte Wiedergabeaktionen.
  • Sie können in Szenarien, in denen Sie Ihre Kontingentgrenze für den Speech-Dienst überschreiten, eine Erhöhung dieses Grenzwerts anfordern, indem Sie die hier beschriebenen Schritte ausführen.

Nächste Schritte