Azure Fundamentals · Lektion

Language- og Vision-API'er i praksis

Kald Computer Vision API for at analysere et billede og Text Analytics API for at udtrække sentiment og nøglefraser fra kundeanmeldelser ved hjælp af REST-anmodninger.

Lektion 2 af 413 trin

Language- og Vision-API'er i praksis er en gratis Azure Fundamentals-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i Azure Fundamentals, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Azure Fundamentals-kurset indeholder 4 lektioner i alt.

Kald til Computer Vision API

Computer Vision API (/vision/v3.2/analyze) analyserer en billed-URL eller en binær datastrøm og returnerer et omfattende JSON-svar med registrerede objekter, en scenebeskrivelse på naturligt sprog, dominerende farver og oplysninger om, hvorvidt billedet indeholder voksenindhold. Du angiver, hvilke visuelle funktioner du ønsker — Categories, Description, Objects, Tags, Faces, Color, Adult — for at styre, hvad API'en beregner, og kun betale for det, du bruger.

# 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: Læsning af tekst fra billeder

Read API (/vision/v3.2/read/analyze) er det anbefalede OCR-endpoint til udtrækning af tekst fra billeder og PDF-filer. I modsætning til det ældre /ocr-endpoint er Read API asynkron — du sender billedet, får en URL til en handling tilbage, forespørger gentagne gange, indtil den er fuldført, og henter derefter resultatet. Den understøtter trykt og håndskrevet tekst på 164 sprog, bevarer læserækkefølgen for tekstblokke og håndterer roterede billeder eller billeder med lav opløsning bedre end det synkrone OCR-endpoint.

# 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>'

Sentimentanalyse med Text Analytics

Endpointet Sentiment Analysis (/text/analytics/v3.1/sentiment) returnerer en sentimentetiket (positiv, negativ, neutral eller blandet) og en sikkerhedsscore mellem 0 og 1 for hvert indsendt dokument. Det leverer også meningsudvinding (aspektbaseret sentimentanalyse), som identificerer, hvilke specifikke aspekter af et produkt eller en tjeneste en anmelder kommenterer på, samt sentimentet for hvert aspekt — f.eks. at registrere, at en restaurantanmeldelse er positiv over for maden, men negativ over for servicen.

# 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."}
    ]
  }'

Udtrækning af nøglefraser

Udtrækning af nøglefraser identificerer de vigtigste emner og begreber i en tekst og returnerer dem som en liste med fraser. I en e-mail til kundesupport kunne den f.eks. returnere fraser som forsinket levering, ordrebekræftelse og anmodning om refundering. Det er nyttigt til automatisk mærkning af supportsager, opsummering af dokumenter til søgeindeksering eller prioritering af indhold i en vidensbase. API'en behandler op til 1.000 dokumenter pr. anmodning og understøtter mere end 10 sprog.

# 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."}
    ]
  }'

Genkendelse af navngivne entiteter

Genkendelse af navngivne entiteter (NER) identificerer og kategoriserer omtaler af entiteter i tekst — f.eks. Person, Organisation, Location, DateTime, Quantity, URL og Email. Varianten PII-detektion (personhenførbare oplysninger) finder specifikt følsomme data som kreditkortnumre, CPR-numre og telefonnumre og kan sløre dem. PII-detektion er nyttig til automatisk anonymisering af data, før de gemmes eller behandles til 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."}
    ]
  }'

Azure AI Translator i praksis

Translator API (/translate) konverterer tekst mellem mere end 100 sprog i ét REST-kald. Du sender kildeteksten, angiver en eller flere målsprogskoder og modtager den oversatte tekst sammen med det registrerede kildesprog. API'en tilbyder også translitteration (konvertering af skriftsystem, f.eks. arabisk til latinske tegn) og opslag i ordbog med alternative oversættelser på ordniveau. Translator understøtter batchbehandling af op til 100 dokumenter pr. anmodning, hvilket gør den effektiv til lokalisering af indhold i stor skala.

# 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: Træn din egen model

Azure AI Custom Vision lader dig træne en model til billedklassifikation eller objektdetektion ved hjælp af dine egne mærkede billeder uden at skrive ML-kode. I Custom Vision-portalen uploader du billeder, mærker dem og klikker på Train. Tjenesten træner en model og returnerer præstationsmålinger (Precision, Recall, AP). Derefter tester du modellen med nye billeder og publicerer den som et forudsigelses-endpoint. Modeller kan også eksporteres som ONNX eller CoreML til inferens på enheden.

# Create a Custom Vision project via CLI
az cognitiveservices account create \
  --name myCustomVision \
  --resource-group myRG \
  --kind CustomVision.Training \
  --sku S0 \
  --location eastus

Language Understanding (CLU)

Conversational Language Understanding (CLU) er efterfølgeren til LUIS. Du definerer hensigter (hvad brugeren ønsker, f.eks. BookFlight og GetWeather) og entiteter (data, der skal udtrækkes, f.eks. destinationsby og rejsedato), angiver eksempeludsagn for hver hensigt, træner modellen og implementerer den. Programmer kalder CLU-forudsigelses-endpointet for at klassificere brugerinput i den korrekte hensigt og udtrække entiteter. CLU driver forståelseslaget i virtuelle assistenter og chatbots.

Håndtering af API-fejl og begrænsning af kald

API'er i Azure AI Services returnerer standardiserede HTTP-statuskoder. 400 Bad Request betyder ugyldigt input (f.eks. et dokument, der er for langt — Text Analytics understøtter op til 5.120 tegn pr. dokument). 401 Unauthorized betyder, at en API-nøgle er ugyldig eller mangler. 429 Too Many Requests betyder, at du har overskredet din tjenestekvote — implementer eksponentiel backoff med jitter, og prøv igen. Til produktion bør du overveje en dedikeret ressource (ikke det gratis niveau) og anmode om højere kvoter via Azure-portalen, hvis du har brug for større gennemløb.

Integration af AI Services med Logic Apps

Azure AI Services kan integreres med Azure Logic Apps ved hjælp af indbyggede forbindelser, så du kan aktivere AI-arbejdsgange uden kode. Eksempel: Når en ny e-mail ankommer → udtræk vedhæftede filer → kald Computer Vision Read API for at udføre OCR på tekst i de vedhæftede filer → kald Text Analytics for at udtrække nøglefraser → skriv resultaterne til en SharePoint-liste. Logic Apps indeholder forbindelser til Cognitive Services (Language, Vision, Translator), som håndterer godkendelse og API-kald uden at skrive kode til REST-anmodninger.

Brug af AI-tjenester med Python SDK

Microsoft udgiver officielle Python-pakker til hver AI-tjeneste. Installér azure-ai-textanalytics til Language-API'er eller azure-cognitiveservices-vision-computervision til Vision. SDK'et håndterer automatisk godkendelse, serialisering og logik til gentagne forsøg. Godkend dig ved hjælp af en AzureKeyCredential eller en DefaultAzureCredential (understøtter administrerede identiteter). Det anbefales at bruge SDK'et frem for rå HTTP-anmodninger i produktionskode, fordi det giver typesikkerhed og gør opgraderinger nemmere, når API-versionerne ændres.

# 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)

Hurtigt tjek

Test din forståelse af begreberne fra Microsoft Azure Fundamentals (AZ-900) i denne lektion.

Opsummering af lektionen

I denne lektion har du lært, at Computer Vision API analyserer billeder for objekter, beskrivelser og OCR-tekst (ved hjælp af den asynkrone Read API), at Text Analytics API'er udtrækker sentiment, nøglefraser og personhenførbare oplysninger fra tekst, og at Translator API konverterer tekst mellem over 100 sprog i et enkelt kald. Nu skal vi se nærmere på Azure Machine Learning Studio til træning og implementering af tilpassede ML-modeller.

Gratis at komme i gang

Lær Azure Fundamentals med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
30
Lektioner
120

Ofte stillede spørgsmål

Er lektionen “Language- og Vision-API'er i praksis” gratis?

Ja — hele teksten til “Language- og Vision-API'er i praksis” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af Azure Fundamentals-kurset, skal du opgradere til CoddyKit PRO. Azure Fundamentals-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Language- og Vision-API'er i praksis”?

Kald Computer Vision API for at analysere et billede og Text Analytics API for at udtrække sentiment og nøglefraser fra kundeanmeldelser ved hjælp af REST-anmodninger. Du øver dig i Azure Fundamentals med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Azure Fundamentals?

Der kræves ingen tidligere erfaring. Azure Fundamentals på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “Language- og Vision-API'er i praksis”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Azure Fundamentals-lektion?

Ja. Alle Azure Fundamentals-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Oversigt over Azure Cognitive Services
  2. Language- og Vision-API'er i praksis
  3. Azure Machine Learning Studio
  4. Azure OpenAI Service
← Tilbage til Azure Fundamentals