Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Examen de la planification et de l’octroi de licences
Planification
Gestion des licences
- Standard automatique et file d’attente des appels
- Abonnement Azure
Problèmes connus
Aucun.
Vue d’ensemble
Microsoft Foundry est la plateforme d’IA d’entreprise permettant de créer, d’ancrer et de gouverner à grande échelle les applications et les agents IA. Il associe le cycle de vie complet de vos agents à un développement ouvert, à une intelligence intégrée et à des contrôles cohérents de sécurité, de conformité et de stratégie sur chaque agent.
Numérotation directe Les agents vocaux Microsoft Foundry via la téléphonie Microsoft Teams vous permettent de créer des bots IA conversationnels et de les attacher directement à un numéro de téléphone via les comptes de ressources du téléphone Teams. En utilisant ces agents vocaux conversationnels internes, vous pouvez améliorer considérablement vos expériences de réponse vocale interactive actuelles ou mettre à niveau vos flux d’appels actuels.
En frontalant votre flux d’appels avec un agent vocal Microsoft Foundry, vous déverrouillez une automatisation approfondie et des expériences personnalisées. Vous pouvez concevoir des flux de travail personnalisés pour gérer les demandes courantes, telles que la facturation, le status des commandes et les contrôles d’inventaire. L’agent agit comme un premier point de contact intelligent, résolvant les problèmes de manière indépendante avant d’acheminer de manière transparente l’appel vers un représentant humain à l’aide de systèmes de routage téléphonique Teams traditionnels si nécessaire.
Ce que vous allez générer
Conditions préalables
- Accès Azure : abonnement Azure dans lequel vous pouvez créer des ressources Foundry, ACS, une inscription d’application, Azure Bot et Event Grid.
- Administration des équipes : Teams et Microsoft 365 autorisations pour créer, attribuer une licence et affecter un numéro de téléphone à un compte de ressource.
- PowerShell - avec le dernier module MicrosoftTeams. L’option de menu de point de terminaison d’application personnalisée est PowerShell uniquement.
Valeurs à collecter
| Variable | Où l’obtenir | Utilisé ultérieurement pour |
|---|---|---|
<foundry-project> |
Création de projet Foundry | Hébergement du callbot et de la connexion du projet ACS |
<voice-agent> |
Création de l’agent Foundry | L’agent dont l’onglet Canaux reçoit la liaison Teams |
<application-client-id> |
Vue d’ensemble inscriptions d'applications → | ID d’application Microsoft de Bot Azure et ApplicationId du compte de ressource Teams |
<azure-tenant-id> |
Vue d’ensemble inscriptions d'applications → | Configuration à locataire unique de Bot Azure |
<acs-endpoint-host> |
Propriétés ACS / JSON | Connexion Foundry et demande de consentement du serveur ACS |
<acs-immutable-resource-id> |
Propriétés ACS / JSON | Teams resource-account AcsResourceId |
<teams-tenant-id> |
Get-CsTenan | Étendue du consentement du serveur ACS |
<resource-account-object-id> |
Get-CsOnlineApplicationInstance | Liaison téléphonique Foundry, consentement ACS et cible MA ApplicationEndpoint |
<teams-service-number> |
Centre d’administration Microsoft Teams | Attribution de compte-ressource et liaison téléphonique Foundry |
Configuration de l’installation
Étape 1 : Créer et tester le callbot Foundry
- Ouvrez Microsoft Foundry.
- Créez un projet Foundry dans l’abonnement Azure que vous utiliserez pour ACS.
- Créez un agent avec le mode d’interaction : Voix. (Vous ne pourrez pas changer ce choix par la suite.)
- Configurez des instructions téléphoniques concises et un message d’accueil pour démarrer la session.
- Laissez les outils et les connaissances vides pour le premier test de connectivité.
- Exécutez une session vocale dans le navigateur et vérifiez le message d’accueil, la parole bidirectionnelle et l’intervention.
Attendu : L’agent travaille dans le terrain de jeu Foundry avant l’ajout d’une infrastructure Teams.
Étape 2 : Créer Azure Communication Services
Guide de création d’une base de données ACS
- Ouvrez le Portail Azure.
- Créez une ressource ACS dans le même locataire Entra que le projet Foundry.
- Sélectionnez l’emplacement des données qui correspond à l’emplacement des données du locataire Teams.
- Ouvrez les propriétés de la ressource ACS ou la vue JSON.
- hostName ->
<acs-endpoint-host> - immutableResourceId ->
<acs-immutable-resource-id>
Attendu : ACS est approvisionné et vous avez <acs-endpoint-host> et <acs-immutable-resource-id>.
Étape 3 : Créer l’identité d’application et le bot Azure
- Ouvrez le Centre d’administration d’Entra.
- Créer une inscription d’application à locataire unique . Enregistrez son ID client et son ID de locataire.
- Créez une clé secrète client et stockez-la en toute sécurité. Ne le placez pas dans la source, les tickets, les captures d’écran ou le chat.
- Créez un bot Azure à l’aide de l’inscription d’application existante, de la résidence de données globale et de Standard/S1.
- Définissez le point de terminaison Messagerie du bot sur :
https://eventgrid.azure.net - Activez le canal d’appel Microsoft Teams et définissez son webhook d’appel sur la même URL Event Grid.
- Ouvrez le Portail Azure.
- Sur l’abonnement Azure, inscrivez le fournisseur de
Microsoft.EventGridressources.
Attendu : Le bot Azure est lié à , et les deux chemins d’accès d’événement <application-client-id>Teams ciblent Event Grid.
Étape 4 : créer et lier le compte de ressource Teams
Connect-MicrosoftTeams
$appId = [Guid]"<application-client-id>"
$acsId = [Guid]"<acs-immutable-resource-id>"
$resourceAccountUpn = "voice-agent-ra@contoso.onmicrosoft.com"
$ra = New-CsOnlineApplicationInstance `
-UserPrincipalName $resourceAccountUpn `
-ApplicationId $appId `
-DisplayName "Foundry Voice Agent"
# Wait for Teams directory propagation before retrieving the object.
$ra = Get-CsOnlineApplicationInstance -Identity $resourceAccountUpn
Set-CsOnlineApplicationInstance `
-Identity $ra.ObjectId `
-ApplicationId $appId `
-AcsResourceId $acsId `
-DisplayName "Foundry Voice Agent"
Sync-CsOnlineApplicationInstance `
-ObjectId $ra.ObjectId `
-ApplicationId $appId `
-AcsResourceId $acsId
Get-CsOnlineApplicationInstance -Identity $ra.ObjectId |
Format-List DisplayName, UserPrincipalName, ObjectId, ApplicationId, AcsResourceId
Attendu : La sortie contient un ObjectId, l’ID client de l’application et l’ID de ressource immuable ACS. Enregistrez l’ObjectId sous <resource-account-object-id>.
Étape 5 : Octroyer une licence au compte de ressource et satisfaire à l’exigence de numéro du portail
- Ouvrez le Centre d’administration Microsoft 365.
- Attribuer la licence du compte de ressources de téléphonie Microsoft Teams dans le Centre d’administration Microsoft 365.
- Ouvrir le Centre d’administration Teams.
- Choisissez un numéro de service Teams non attribué dont les fonctionnalités incluent
VoiceApplicationAssignment.
Si l’interface utilisateur de Teams est désactivée pour le compte de ressource personnalisé, attribuez le numéro via PowerShell.
$telephoneNumber = "<teams-service-number>"
$number = Get-CsPhoneNumberAssignment -TelephoneNumber $telephoneNumber
$number | Format-List TelephoneNumber, NumberType, PstnAssignmentStatus, Capability, AssignmentBlockedState
Set-CsPhoneNumberAssignment `
-Identity "voice-agent-ra@contoso.onmicrosoft.com" `
-TelephoneNumber $telephoneNumber `
-NumberType $number.NumberType
Attendu : Le compte de ressource est Sous licence et la cible d’affectation du numéro est l’ObjectId du compte de ressource.
Étape 6 : créer la liaison téléphonique Microsoft Teams Foundry
- Ouvrez Microsoft Foundry.
- Ouvrez le callbot cible, puis Canaux → Numéros de téléphone → Ajouter un numéro → Microsoft Teams.
- Sélectionnez Configuration automatique pour sécuriser la remise des appels entrants.
- Sélectionnez la ressource ACS.
- Entrez
<teams-service-number>et<resource-account-object-id>. - Terminez la liaison et attendez qu’elle apparaisse sur la page Canaux.
Important : La liaison est associée à l’onglet Canaux de l’agent Foundry que vous utilisez. Aucun ID d’agent Foundry n’est écrit sur le compte de ressource Teams.
Attendu : Le numéro Microsoft Teams est visible sur la carte de numéros de téléphone de l’agent vocal.
Étape 7 : Accorder le consentement du serveur ACS pour le compte de ressource Teams
Guide d’extensibilité de Teams Phone
ACS doit autoriser la paire exacte de <teams-tenant-id> et <resource-account-object-id>. Un appel direct renvoie généralement l’état Occupé jusqu’à ce que cette opération soit terminée.
Lire la clé ACS localement avec Read-Host -AsSecureString. Ne le collez jamais dans le chat ou ne l’enregistrez jamais dans le script. Faites-le pivoter immédiatement s’il est exposé.
$acsHost = "<acs-endpoint-host>"
$teamsTenantId = "<teams-tenant-id>"
$resourceAccountId = "<resource-account-object-id>"
$apiVersion = "2025-06-30"
$secureKey = Read-Host "Paste the ACS access key" -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secureKey)
try { $accessKey = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr) }
finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr) }
$body = '{"principalType":"teamsResourceAccount"}'
$path = "/access/teamsExtension/tenants/$teamsTenantId/assignments/$resourceAccountId?api-version=$apiVersion"
$date = [DateTime]::UtcNow.ToString("r",[Globalization.CultureInfo]::InvariantCulture)
$bodyBytes = [Text.Encoding]::UTF8.GetBytes($body)
$sha = [Security.Cryptography.SHA256]::Create()
try { $hash = [Convert]::ToBase64String($sha.ComputeHash($bodyBytes)) }
finally { $sha.Dispose() }
$toSign = "PUT`n$path`n$date;$acsHost;$hash"
$hmac = [Security.Cryptography.HMACSHA256]::new([Convert]::FromBase64String($accessKey))
try {
$signature = [Convert]::ToBase64String(
$hmac.ComputeHash([Text.Encoding]::UTF8.GetBytes($toSign)))
} finally { $hmac.Dispose() }
$headers = @{
"x-ms-date" = $date
"x-ms-content-sha256" = $hash
"Authorization" = "HMAC-SHA256 SignedHeaders=x-ms-date;host;x-ms-content-sha256&Signature=$signature"
}
Invoke-RestMethod -Method Put `
-Uri "https://$acsHost$path" `
-Headers $headers `
-Body $body `
-ContentType "application/json"
Attendu : La réponse identifie l’objectId du compte de ressource, l’ID de locataire Teams et le type de principal teamsResourceAccount.
Étape 8 : valider le chemin d’appel complet
- Appelez
<teams-service-number>. Confirmez le message d’accueil de la fonderie, l’audio bidirectionnel et l’intervention d’intervention. - Ouvrez l’onglet Traces de l’agent Microsoft Foundry et confirmez que les sessions apparaissent.