Partager via

Référence de l’API REST du service Azure AI Foundry Agent Service

L’API REST du service d’agent Azure AI Foundry fournit des points de terminaison pour la création, la configuration et l’exécution d’agents d’IA. Ces agents sont des services hébergés dans le cloud qui associent des modèles de langage volumineux (LLM) à des outils permettant de lire des données, d’appeler des fonctions et d’exécuter de la logique en votre nom. Le service est entièrement géré par Azure, ce qui vous permet de vous concentrer sur la création de flux de travail intelligents sans gérer l’infrastructure.

L’API suit le même protocole que l’API Azure OpenAI Assistants. Cela vous permet d’utiliser des outils et des SDK existants compatibles avec OpenAI avec des modifications de configuration minimales.

Pour plus d’informations sur le service, consultez la documentation du service Azure AI Agent.

Groupes d’opérations REST

Les opérations d’API sont regroupées par concepts de base. Utilisez la table des matières sur la gauche pour parcourir les points de terminaison disponibles. Les principaux groupes d’opérations sont les suivants :

  • Agents : créez, récupérez, mettez à jour ou supprimez une définition d’agent. Un agent comprend le modèle, les instructions et la configuration de l’outil.
  • Fils de discussion – Créez ou répertoriez des fils de conversation. Un fil de discussion représente l’historique des messages d’une interaction.
  • Messages – Ajoutez ou récupérez des messages dans un fil de discussion. Les messages peuvent provenir de l’utilisateur ou de l’agent.
  • Exécutions : démarrez l’exécution d’un agent sur un thread. Une exécution traite le thread et peut appeler des outils pendant l’exécution.
  • Étapes d’exécution : inspectez les actions individuelles effectuées au cours d’une exécution, telles que les appels d’outils ou les appels de modèle.
  • Outils – Enregistrez et gérez des outils personnalisés définis par les spécifications OpenAPI.

Authentification

Le service prend en charge les jetons d’ID Microsoft Entra et les clés de ressource Azure.

  • Utilisez Microsoft Entra ID pour des déploiements de production sécurisés.
  • Utilisez une clé de ressource pour les tests locaux ou les services backend approuvés.

L’accès est contrôlé par le contrôle d’accès en fonction du rôle (RBAC) Azure. Pour plus d’informations, consultez Qu’est-ce que le contrôle d’accès en fonction du rôle Azure (Azure RBAC) ?

Voir aussi