Fonctionnement de l’outil Créer un fichier de connexion au service IA

L’outil Créer un fichier de connexion au service IA crée un fichier de connexion au service IA (.ais) dans lequel sont stockées les informations de connexion pour un service IA externe. Plusieurs paquetages de Deep Learning utilisent des modèles IA tiers et requièrent l’accès à des services IA hébergés. Pour pouvoir utiliser ces services, chaque fournisseur a besoin de détails, tels qu’un point de terminaison, un nom de modèle ou une clé d’API.

Au lieu de saisir à chaque fois ces détails sous forme d’arguments du modèle, vous pouvez utiliser un fichier .ais contenant les paramètres de configuration. Ainsi, vous vous assurez également que les valeurs des paramètres ne sont pas exposées dans la fenêtre Historique et qu’elles sont stockées de façon sécurisée grâce à la sécurité du système d’exploitation. Le fichier .ais ne peut pas être partagé entre des machines ou des utilisateurs car l’outil stocke en interne les informations d’identification sensibles dans le gestionnaire d’informations d’identification Windows et les associe au système local et au compte d’utilisateur.

Cette approche permet de réduire le temps nécessaire à la configuration, d’éviter les erreurs et d’intégrer de façon sécurisée et cohérente des services IA externes à des processus SIG.

Fournisseurs de services et configuration

L’outil Créer un fichier de connexion au service IA prend en charge plusieurs fournisseurs de services IA et chaque fournisseur nécessite des détails de configuration spécifiques. Il peut s’agir d’informations générales telles que le nom du modèle ou le point de terminaison, ainsi que d’informations sensibles telles que des clés d’API ou des jetons.

L’outil fournit un ensemble de paramètres de connexion requis pour chaque fournisseur de services, qui sont spécifiés à l’aide du paramètre Paramètres de connexion. Les valeurs sensibles, telles que les clés d’API ou les jetons, sont spécifiées à l’aide du paramètre Valeur de paramètre secrète. Toute valeur saisie dans le paramètre Valeur de paramètre secrète est traitée comme une information sensible et enregistrée dans le gestionnaire d’informations d’identification Windows, tandis que les informations non sensibles sont stockées dans le fichier .ais.

Les sections suivantes présentent les fournisseurs de services pris en charge et leurs paramètres de connexion respectifs :

Remarque :

Chaque fournisseur de services possède un ensemble de paramètres de connexion par défaut, mais vous pouvez ajouter des paramètres supplémentaires selon les besoins de chaque modèle ou processus.

AWS

AWS fournit des modèles IA via Bedrock et les services associés. Cette option inclut les paramètres de connexion suivants :

• Clé d’accès : identifiant unique associé à votre compte AWS, utilisé pour authentifier les demandes, par exemple : IAMAWSTESTKEY.
• ID de modèle : identifiant du modèle hébergé spécifique à utiliser, par exemple : amazon.titan-text-premier-v1:0
• Nom de la région : région AWS dans laquelle le service est déployé, par exemple : us-east-1

Anthropic

Anthropic fournit la famille de modèles Claude pour les tâches relatives au texte et au raisonnement. Cette option inclut le paramètre de connexion Model, qui indique le nom du modèle Anthropic, par exemple : claude-3-opus.

Azure

Azure fournit des modèles OpenAI hébergés par l’entreprise avec des déploiements et des versions configurables. Cette option inclut les paramètres de connexion suivants :

• Endpoint URI : URL de base du service Azure, par exemple : https://mytestazureopenai.openai.azure.com/
• Deployment Name : nom du déploiement de modèle que vous avez créé dans Azure, par exemple : gpt-4o
• API Version : version de l’API Azure OpenAI que vous ciblez, par exemple : 2024-05-01

Hugging Face

Hugging Face héberge des milliers de modèles open source pour l’IA textuelle, de vision et multimodale. Cette option inclut le paramètre de connexion Model ID, qui indique l’identifiant du modèle à utiliser depuis Hugging Face Hub, par exemple : facebook/detr-resnet-50.

OpenAI

OpenAI fournit des modèles pour les tâches relatives aux langues, au raisonnement et multimodales. Cette option inclut le paramètre de connexion Model, qui indique le nom du modèle à utiliser, par exemple : gpt-4o-mini.

Google

La plateforme Vertex AI de Google Cloud fournit des modèles de fondation pour les tâches relatives au texte, aux discussions et à la vision. Cette option inclut les paramètres de connexion suivants :

• Project ID : identifiant du projet Google Cloud, par exemple : my-gcp-project
• Region : emplacement auquel le service est hébergé, par exemple : us-central1
• Model Name : identifiant du modèle spécifique à utiliser, par exemple : text-bison

Autres

L’option Others prend en charge les connexions à d’autres fournisseurs. Définissez vos propres noms et valeurs de paramètre en fonction des exigences de l’API du fournisseur.

• Custom endpoint : point de terminaison personnalisé, par exemple : https://example.ai/api
• Model : nom du modèle, par exemple : my-custom-model

Fichier AIS et gestion des informations d’identification

Un fichier .ais contient des détails de connexion, tels que des noms de modèle, des points de terminaison et des régions. Ces valeurs sont incluses dans le fichier .ais dans un format structuré.

Voici un exemple de fichier .ais :

{
  "version": "1.0",
  "serviceProvider": "AWS",
  "protocol": "",
  "host": "",
  "authenticationScheme": "accessToken",
  "authenticationProperties": {
    "parameterType": "header",
    "parameterName": "aws_secret_key"
  },
  "authenticationSecrets": {
    "token": "test1234api567key89"
  },
  "serviceProviderProperties": {
    "aws_access_key": " IAMAWSTESTKEY ",
    "model_id": " amazon.titan-text-premier-v1:0",
    "aws_region_name": "us-west-2"
  }
}

Les informations d’identification sensibles, telles que les clés d’API ou les jetons, ne sont pas écrites directement dans le fichier .ais. À la place, le fichier stocke uniquement une référence via la clé authenticationSecrets, tandis que les valeurs réelles sont conservées de manière sécurisée dans le gestionnaire d’informations d’identification Windows. Ainsi, les informations sensibles ne sont jamais divulguées en-dehors de la machine locale et ne peuvent pas être exposées lors de l’ouverture du fichier .ais.

Étant donné qu’il référence des entrées d’information d’identification propres à la machine, un fichier .ais ne peut pas être partagé entre des utilisateurs ou des ordinateurs. S’il est copié sur une autre machine, il ne fonctionne pas sauf si les mêmes informations d’identification sont saisies à nouveau et enregistrées localement à l’aide de l’outil Créer un fichier de connexion au service IA.

Utiliser le fichier .ais

Le fichier .ais enregistré peut être fourni en tant qu’entrée dans des modèles IA tiers par le biais d’un argument de modèle. Le modèle lit le fichier .ais, extrait les détails de configuration requis (comme les paramètres de connexion et les informations d’identification) et les utilise pour établir une connexion au fournisseur de services hébergé.

Chaque modèle tiers qui prend en charge les fichiers .ais attend un ensemble défini de paramètres de connexion. Si les paramètres figurant dans le fichier .ais ne correspondent pas aux exigences du modèle, la connexion échoue et il est possible que le modèle ne fonctionne pas comme prévu.