Outils Azure MCP Server pour les extensions Microsoft Foundry

Azure MCP Server permet de gérer les Extensions Foundry de Microsoft, notamment la création de complétions de conversation et de texte, la génération d’incorporations, la liste de modèles, et l’utilisation d’index de connaissances, avec des invites en langage naturel.

Microsoft Foundry est une plateforme permettant de déployer et de gérer des modèles IA personnalisés dans Azure. Il fournit des outils et des services pour l’apprentissage, le réglage, le déploiement et la surveillance des modèles IA dans les environnements de production.

Les commandes d’index de connaissances nécessitent le point de terminaison de votre projet Microsoft Foundry. Les commandes OpenAI nécessitent le nom de la ressource et le groupe de ressources. La commande get de ressource peut répertorier les ressources sans fournir de nom de ressource.

Note

paramètres Tool : les outils Azure MCP Server définissent des paramètres pour les données dont ils ont besoin pour effectuer des tâches. Certains de ces paramètres sont spécifiques à chaque outil et sont documentés ici. D’autres paramètres sont globaux et partagés par tous les outils. Pour plus d’informations, consultez Paramètres de l’outil.

Connaissances : répertorier les index de connaissances

Obtenez la liste des index de connaissances de Foundry :

  • Recherchez les index de connaissances créés dans les projets Foundry.
  • Utilisez ces index avec des agents IA pour la récupération des connaissances et les applications RAG.
  • La liste est mise à jour lorsque vous créez des index ou mettez à jour des index existants.

Exemple de commande CLI

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Type Required Description
endpoint string Oui URL du point de terminaison du projet ou du service Microsoft Foundry. Le point de terminaison suit ce modèle : https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Connaissances : Obtenir le schéma d’index

Obtenez la configuration détaillée du schéma d’un index de connaissances spécifique à partir de Foundry.

Cette opération vous montre des informations complètes sur la structure et la configuration d’un index de connaissances, notamment les définitions de champs, les types de données, les attributs pouvant faire l’objet d’une recherche et d’autres propriétés de schéma. Utilisez ces informations de schéma pour comprendre comment les structures d’index et l'indexation de vos données sont organisées pour la recherche.

Exemple de commande CLI

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Type Required Description
index string Oui Nom de l’index de connaissances.
endpoint string Oui URL du point de terminaison du projet ou du service Microsoft Foundry. Le point de terminaison suit ce modèle : https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

OpenAI : Créer des complétions de chat

Créez des complétions de conversation à l’aide d’Azure OpenAI dans Foundry. Envoyez des messages à Azure modèles de conversation OpenAI déployés dans votre ressource Foundry et recevez des réponses conversationnelles générées par l’IA. Prend en charge les invites multitours avec l’historique des messages, les instructions système et la personnalisation de la réponse.

Exemple de commande CLI

azmcp foundryextensions openai chat-completions-create \
  --resource-name <resource-name> \
  --deployment <deployment> \
  --message-array <message-array> \
  --resource-group <resource-group> \
  [--max-tokens <max-tokens>] \
  [--temperature <temperature>] \
  [--top-p <top-p>] \
  [--frequency-penalty <frequency-penalty>] \
  [--presence-penalty <presence-penalty>] \
  [--stop <stop>] \
  [--stream <stream>] \
  [--seed <seed>] \
  [--user <user>]
Parameter Type Required Description
resource-name string Oui Nom de la ressource Microsoft Foundry.
deployment string Oui Le nom du déploiement.
message-array string Oui Tableau JSON de messages dans la conversation. Chaque message doit avoir role et content propriétés.
resource-group string Oui Le nom du groupe de ressources Azure.
max-tokens string Non Nombre maximal de jetons à générer pour l'achèvement.
temperature string Non Contrôle l’aléatoire dans la sortie. Les valeurs inférieures le rendent plus déterministe.
top-p string Non Contrôle la diversité via l’échantillonnage du noyau (0,0 à 1,0). La valeur par défaut est 1.0.
frequency-penalty string Non Attribue une pénalité aux nouveaux tokens en fonction de leur fréquence, dans une plage de -2,0 à 2,0. La valeur par défaut est 0.
presence-penalty string Non Pénalise les nouveaux jetons en fonction de la présence (-2.0 à 2.0). La valeur par défaut est 0.
stop string Non Jusqu’à 4 séquences où l’API cesse de générer d’autres jetons.
stream string Non Indique s’il faut renvoyer la progression partielle. La valeur par défaut est false.
seed string Non S’il est spécifié, le système fait un meilleur effort pour échantillonner de façon déterministe.
user string Non Identificateur de l’utilisateur pour le suivi et la surveillance des abus.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ❌ ❌ ✅ ❌ ❌

OpenAI : Créer des incorporations

Créez des incorporations à l’aide de Azure OpenAI dans Foundry. Générez des intégrations vectorielles à partir de texte grâce aux déploiements Azure OpenAI dans votre ressource Foundry pour la recherche sémantique, les comparaisons de similarité, le clustering ou le machine learning.

Exemple de commande CLI

azmcp foundryextensions openai embeddings-create \
  --resource-name <resource-name> \
  --deployment <deployment> \
  --input-text <input-text> \
  --resource-group <resource-group> \
  [--user <user>] \
  [--encoding-format <encoding-format>] \
  [--dimensions <dimensions>]
Parameter Type Required Description
resource-name string Oui Nom de la ressource Microsoft Foundry.
deployment string Oui Le nom du déploiement.
input-text string Oui Texte de saisie pour lequel générer des incorporations.
resource-group string Oui Le nom du groupe de ressources Azure.
user string Non Identificateur de l’utilisateur pour le suivi et la surveillance des abus.
encoding-format string Non Le format dans lequel renvoyer les embeddings (float ou base64).
dimensions string Non Nombre de dimensions pour la sortie d'intégration. Uniquement pris en charge dans certains modèles.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ❌ ❌ ✅ ❌ ❌

OpenAI : Créez des complétions

Créez des saisies semi-automatiques de texte à l’aide de Azure OpenAI dans Foundry. Envoyez une invite ou une question à Azure modèles OpenAI déployés dans votre ressource Foundry et recevez des réponses textuelles générées. Utilisez cette fonctionnalité lorsque vous devez créer des achèvements, obtenir du contenu généré par l’IA, générer des réponses aux questions ou produire des saisies de texte à partir de Azure OpenAI en fonction de n’importe quelle invite d’entrée. Prend en charge la personnalisation avec les paramètres de température et le nombre maximal de jetons.

Exemple de commande CLI

azmcp foundryextensions openai create-completion \
  --deployment <deployment> \
  --prompt-text <prompt-text> \
  --resource-name <resource-name> \
  --resource-group <resource-group> \
  [--max-tokens <max-tokens>] \
  [--temperature <temperature>]
Parameter Type Required Description
deployment string Oui Le nom du déploiement.
prompt-text string Oui Texte d’invite à envoyer au modèle d’achèvement.
resource-name string Oui Nom de la ressource Microsoft Foundry.
resource-group string Oui Le nom du groupe de ressources Azure.
max-tokens string Non Nombre maximal de jetons à générer pour l'achèvement.
temperature string Non Contrôle l’aléatoire dans la sortie. Les valeurs inférieures le rendent plus déterministe.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ❌ ❌ ✅ ❌ ❌

OpenAI : Répertorier les modèles et les déploiements

Lister les déploiements de modèles Azure OpenAI dans une ressource Microsoft Foundry. Cet outil récupère des informations sur les modèles déployés, notamment les noms de modèles, les versions, les fonctionnalités et l’état du déploiement.

Exemple de commande CLI

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter Type Required Description
resource-name string Oui Nom de la ressource Microsoft Foundry.
resource-group string Oui Le nom du groupe de ressources Azure.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Ressources : Obtenir la ressource Foundry

Répertoriez ou récupérez les ressources Microsoft Foundry et renvoyez des détails sur les ressources, tels que l’URL du point de terminaison, l’emplacement, le SKU, le type et l’état de provisionnement. Si vous fournissez un nom de ressource, l’outil retourne cette ressource unique. Sinon, il renvoie l’inventaire des ressources du périmètre. Pour l’inventaire des déploiements de modèles à l’intérieur d’une ressource Foundry, utilisez l’outil de liste des modèles OpenAI.

Exemple de commande CLI

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Type Required Description
resource-name string Non Nom de la ressource Microsoft Foundry.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Contenu connexe

  • Last updated on