API de langage et de vision en pratique
Appelez l’API Computer Vision pour analyser une image et l’API Text Analytics pour extraire le sentiment et les expressions clés d’avis clients à l’aide de requêtes REST.
API de langage et de vision en pratique est une leçon Azure Fundamentals gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Azure Fundamentals, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Azure Fundamentals comprend 4 leçons au total.
Appeler l’API Computer Vision
L’API Computer Vision (/vision/v3.2/analyze) analyse l’URL d’une image ou un flux binaire et renvoie une réponse JSON détaillée contenant les objets détectés, une description de la scène en langage naturel, les couleurs dominantes et l’indication de la présence éventuelle de contenu pour adultes. Vous indiquez les fonctionnalités visuelles souhaitées — Categories, Description, Objects, Tags, Faces, Color, Adult — afin de contrôler les calculs effectués par l’API et de ne payer que ce que vous utilisez.
# Analyse an image URL with Computer Vision
curl -X POST 'https://myVision.cognitiveservices.azure.com/vision/v3.2/analyze?visualFeatures=Description,Objects,Tags' \
-H 'Ocp-Apim-Subscription-Key: <key>' \
-H 'Content-Type: application/json' \
-d '{"url": "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/1200px-Cat03.jpg"}'OCR : lire du texte dans des images
L’API Read (/vision/v3.2/read/analyze) est le point de terminaison OCR recommandé pour extraire du texte à partir d’images et de fichiers PDF. Contrairement à l’ancien point de terminaison /ocr, l’API Read fonctionne de manière asynchrone : vous envoyez l’image, récupérez une URL d’opération, l’interrogez jusqu’à son achèvement, puis récupérez le résultat. Elle prend en charge les textes imprimés et manuscrits dans 164 langues, conserve l’ordre de lecture des blocs de texte et gère mieux les images pivotées ou de faible résolution que le point de terminaison OCR synchrone.
# Step 1: Submit image for reading
curl -X POST 'https://myVision.cognitiveservices.azure.com/vision/v3.2/read/analyze' \
-H 'Ocp-Apim-Subscription-Key: <key>' \
-H 'Content-Type: application/json' \
-d '{"url": "https://example.com/invoice.jpg"}'
# Returns: Operation-Location header with result URL
# Step 2: Poll for result
curl 'https://myVision.cognitiveservices.azure.com/vision/v3.2/read/analyzeResults/<operation-id>' \
-H 'Ocp-Apim-Subscription-Key: <key>'Analyse des sentiments avec Analyse de texte
Le point de terminaison d’analyse des sentiments (/text/analytics/v3.1/sentiment) renvoie une étiquette de sentiment (positif, négatif, neutre ou mixte) ainsi qu’un score de confiance compris entre 0 et 1 pour chaque document envoyé. Il fournit également l’extraction des opinions (analyse des sentiments fondée sur les aspects), qui identifie les aspects précis d’un produit ou d’un service commentés par un évaluateur ainsi que le sentiment associé à chacun — par exemple, détecter qu’un avis sur un restaurant est positif concernant la nourriture, mais négatif concernant le service.
# Sentiment analysis request
curl -X POST 'https://myLanguage.cognitiveservices.azure.com/text/analytics/v3.1/sentiment?opinionMining=true' \
-H 'Ocp-Apim-Subscription-Key: <key>' \
-H 'Content-Type: application/json' \
-d '{
"documents": [
{"id": "1", "language": "en", "text": "The food was great but the service was terrible."}
]
}'Extraction de phrases clés
L’extraction de phrases clés identifie les principaux sujets et concepts d’un texte et les renvoie sous forme de liste de phrases. Pour un e-mail d’assistance client, elle peut renvoyer des phrases telles que retard de livraison, confirmation de commande et demande de remboursement. Cette fonctionnalité est utile pour étiqueter automatiquement les tickets d’assistance, résumer des documents afin d’en indexer le contenu pour la recherche ou hiérarchiser le contenu d’une base de connaissances. L’API traite jusqu’à 1 000 documents par requête et prend en charge plus de 10 langues.
# Key phrase extraction
curl -X POST 'https://myLanguage.cognitiveservices.azure.com/text/analytics/v3.1/keyPhrases' \
-H 'Ocp-Apim-Subscription-Key: <key>' \
-H 'Content-Type: application/json' \
-d '{
"documents": [
{"id": "1", "language": "en",
"text": "Azure offers scalable storage, compute, and AI services for enterprises."}
]
}'Reconnaissance d’entités nommées
La reconnaissance d’entités nommées (NER) identifie et catégorise les mentions d’entités dans un texte, telles que Person, Organisation, Location, DateTime, Quantity, URL et Email. La variante de détection des PII (informations personnelles identifiables) recherche précisément les données sensibles, comme les numéros de carte bancaire, les numéros de sécurité sociale et les numéros de téléphone, et peut les masquer. La détection des PII est utile pour anonymiser automatiquement les données avant de les stocker ou de les traiter à des fins d’analyse.
# PII entity recognition
curl -X POST 'https://myLanguage.cognitiveservices.azure.com/text/analytics/v3.1/entities/recognition/pii' \
-H 'Ocp-Apim-Subscription-Key: <key>' \
-H 'Content-Type: application/json' \
-d '{
"documents": [
{"id": "1", "language": "en",
"text": "Please contact John Smith at john@example.com for refund."}
]
}'Traducteur Azure IA en pratique
L’API du Traducteur (/translate) convertit du texte entre plus de 100 langues en un seul appel REST. Vous transmettez le texte source, indiquez un ou plusieurs codes de langue cibles et recevez le texte traduit ainsi que la langue source détectée. L’API fournit également la translittération (conversion d’un système d’écriture, par exemple de l’arabe vers les caractères latins) et la recherche dans le dictionnaire pour obtenir des traductions alternatives au niveau des mots. Le Traducteur prend en charge le traitement par lots de jusqu’à 100 documents par requête, ce qui le rend efficace pour la localisation de contenu à grande échelle.
# Translate English text to French and Spanish
curl -X POST 'https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&to=fr&to=es' \
-H 'Ocp-Apim-Subscription-Key: <key>' \
-H 'Ocp-Apim-Subscription-Region: eastus' \
-H 'Content-Type: application/json' \
-d '[{"text": "Hello, how are you?"}]'Custom Vision : entraîner votre propre modèle
Azure IA Custom Vision vous permet d’entraîner un modèle de classification d’images ou de détection d’objets à l’aide de vos propres images étiquetées, sans écrire de code ML. Dans le portail Custom Vision, vous chargez des images, vous les étiquetez, puis vous cliquez sur Train. Le service entraîne un modèle et renvoie des métriques de performance (Precision, Recall, AP). Vous testez ensuite le modèle avec de nouvelles images et vous le publiez en tant que point de terminaison de prédiction. Les modèles peuvent également être exportés au format ONNX ou CoreML pour effectuer des inférences sur l’appareil.
# Create a Custom Vision project via CLI
az cognitiveservices account create \
--name myCustomVision \
--resource-group myRG \
--kind CustomVision.Training \
--sku S0 \
--location eastusCompréhension du langage (CLU)
La compréhension du langage conversationnel (CLU) est la successeure de LUIS. Vous définissez des intentions (ce que l’utilisateur souhaite, par exemple BookFlight ou GetWeather) et des entités (les données à extraire, par exemple la ville de destination ou la date du voyage), vous fournissez des énoncés d’exemple pour chaque intention, vous entraînez le modèle, puis vous le déployez. Les applications appellent le point de terminaison de prédiction CLU pour classer l’entrée de l’utilisateur dans la bonne intention et extraire les entités. CLU alimente la couche de compréhension des assistants virtuels et des agents conversationnels.
Gérer les erreurs d’API et la limitation du débit
Les API d’Azure IA Services renvoient des codes d’état HTTP standard. 400 Bad Request signifie que l’entrée est mal formée (par exemple, un document trop long — Analyse de texte prend en charge jusqu’à 5 120 caractères par document). 401 Unauthorized signifie qu’une clé API est invalide ou manquante. 429 Too Many Requests signifie que vous avez dépassé le quota de votre service : vous devez mettre en œuvre une temporisation exponentielle avec dispersion aléatoire et réessayer. En production, envisagez une ressource dédiée (plutôt que le niveau gratuit) et demandez une augmentation du quota via le portail Azure si vous avez besoin d’un débit plus élevé.
Intégrer Azure IA Services à Logic Apps
Azure IA Services peut être intégré à Azure Logic Apps au moyen de connecteurs intégrés, ce qui permet de créer des flux de travail d’IA sans code. Par exemple : lorsqu’un nouvel e-mail arrive → extraire les pièces jointes → appeler l’API Read de Computer Vision pour effectuer l’OCR du texte des pièces jointes → appeler Analyse de texte pour extraire les phrases clés → écrire les résultats dans une liste SharePoint. Logic Apps comprend des connecteurs pour Cognitive Services (Langage, Vision, Traducteur) qui gèrent l’authentification et les appels d’API sans avoir à écrire le code des requêtes REST.
Utiliser les services d’IA avec le SDK Python
Microsoft publie des packages Python officiels pour chaque service d’IA. Installez azure-ai-textanalytics pour les API de langage ou azure-cognitiveservices-vision-computervision pour la vision. Le SDK gère automatiquement l’authentification, la sérialisation et la logique de nouvelle tentative. Authentifiez-vous avec un AzureKeyCredential ou un DefaultAzureCredential (compatible avec les identités managées). En production, il est préférable d’utiliser le SDK plutôt que des requêtes HTTP brutes, car il garantit la sécurité des types et facilite les mises à niveau lorsque les versions d’API changent.
# Python — Text Analytics sentiment analysis
from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential
client = TextAnalyticsClient(
endpoint='https://myLanguage.cognitiveservices.azure.com/',
credential=AzureKeyCredential('<key>')
)
docs = ['The product quality exceeded my expectations.']
result = client.analyze_sentiment(docs)
for doc in result:
print(doc.sentiment, doc.confidence_scores)Vérification rapide
Vérifiez votre compréhension des concepts de Microsoft Azure Fundamentals (AZ-900) présentés dans cette leçon.
Récapitulatif de la leçon
Dans cette leçon, vous avez appris que l’API Vision par ordinateur analyse les images pour y détecter des objets et générer des descriptions ainsi que du texte OCR (à l’aide de l’API Read asynchrone), que les API d’analyse de texte extraient le sentiment, les expressions clés et les PII des textes, et que l’API de traduction convertit du texte entre plus de 100 langues en un seul appel. Nous allons maintenant découvrir Azure Machine Learning Studio pour entraîner et déployer des modèles d’apprentissage automatique personnalisés.
Questions Fréquemment Posées
La leçon « API de langage et de vision en pratique » est-elle gratuite ?
Oui — le texte complet de « API de langage et de vision en pratique » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Azure Fundamentals, passe à CoddyKit PRO. Le cours Azure Fundamentals comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « API de langage et de vision en pratique » ?
Appelez l’API Computer Vision pour analyser une image et l’API Text Analytics pour extraire le sentiment et les expressions clés d’avis clients à l’aide de requêtes REST. Tu pratiques Azure Fundamentals avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Azure Fundamentals ?
Aucune expérience préalable n'est requise. Azure Fundamentals sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « API de langage et de vision en pratique » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Azure Fundamentals ?
Oui. Chaque leçon Azure Fundamentals inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Présentation des services cognitifs Azure
- API de langage et de vision en pratique
- Azure Machine Learning Studio
- Azure OpenAI Service