Azure Fundamentals · Pelajaran

API Language dan Vision dalam Praktik

Panggil Computer Vision API untuk menganalisis gambar dan Text Analytics API untuk mengekstrak sentimen serta frasa kunci dari ulasan pelanggan menggunakan permintaan REST.

API Language dan Vision dalam Praktik adalah pelajaran Azure Fundamentals gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Azure Fundamentals, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Azure Fundamentals mencakup 4 pelajaran total.

Memanggil API Computer Vision

Computer Vision API (/vision/v3.2/analyze) menganalisis URL gambar atau aliran biner dan mengembalikan respons JSON lengkap yang berisi objek yang terdeteksi, deskripsi adegan dalam bahasa alami, warna dominan, serta informasi apakah gambar berisi konten dewasa. Anda menentukan fitur visual yang diinginkan—Categories, Description, Objects, Tags, Faces, Color, Adult—untuk mengontrol hal yang dihitung API dan hanya membayar penggunaan Anda.

# 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: Membaca Teks dari Gambar

Read API (/vision/v3.2/read/analyze) adalah titik akhir OCR yang direkomendasikan untuk mengekstrak teks dari gambar dan PDF. Berbeda dari titik akhir lama /ocr, Read API bekerja secara asinkron—Anda mengirimkan gambar, menerima URL operasi, memeriksanya secara berkala hingga selesai, lalu mengambil hasilnya. API ini mendukung teks cetak dan tulisan tangan dalam 164 bahasa, mempertahankan urutan pembacaan blok teks, serta menangani gambar yang diputar atau beresolusi rendah dengan lebih baik daripada titik akhir OCR sinkron.

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

Analisis Sentimen dengan Text Analytics

Titik akhir Analisis Sentimen (/text/analytics/v3.1/sentiment) mengembalikan label sentimen (positif, negatif, netral, atau campuran) dan skor keyakinan antara 0 dan 1 untuk setiap dokumen yang dikirimkan. API ini juga menyediakan penambangan opini (sentimen berbasis aspek) yang mengidentifikasi aspek tertentu dari produk atau layanan yang dikomentari oleh pengulas serta sentimen terhadap setiap aspek—misalnya, mendeteksi bahwa ulasan restoran bernada positif tentang makanan, tetapi negatif tentang layanan.

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

Ekstraksi Frasa Kunci

Ekstraksi frasa kunci mengidentifikasi topik dan konsep utama dalam suatu teks, lalu mengembalikannya sebagai daftar frasa. Untuk email dukungan pelanggan, API ini mungkin mengembalikan frasa seperti keterlambatan pengiriman, konfirmasi pesanan, dan permintaan pengembalian dana. Fitur ini berguna untuk memberi tag pada tiket dukungan secara otomatis, meringkas dokumen untuk pengindeksan pencarian, atau memprioritaskan konten dalam basis pengetahuan. API ini memproses hingga 1.000 dokumen per permintaan dan mendukung lebih dari 10 bahasa.

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

Pengenalan Entitas Bernama

Pengenalan Entitas Bernama (NER) mengidentifikasi dan mengategorikan penyebutan entitas dalam teks—seperti Orang, Organisasi, Location, DateTime, Kuantitas, URL, dan Email. Varian deteksi PII (Informasi Identitas Pribadi) secara khusus menemukan dan dapat menyamarkan data sensitif seperti nomor kartu kredit, nomor jaminan sosial, dan nomor telepon. Deteksi PII berguna untuk menganonimkan data secara otomatis sebelum data disimpan atau diproses untuk analitik.

# 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 dalam Praktik

Translator API (/translate) mengonversi teks antara lebih dari 100 bahasa dalam satu panggilan REST. Anda mengirimkan teks sumber, menentukan satu atau beberapa kode bahasa target, lalu menerima teks terjemahan beserta bahasa sumber yang terdeteksi. API ini juga menyediakan transliterasi (mengubah aksara, misalnya aksara Arab menjadi karakter Latin) dan pencarian kamus untuk alternatif terjemahan tingkat kata. Translator mendukung pemrosesan batch hingga 100 dokumen per permintaan, sehingga efisien untuk pelokalan konten berskala besar.

# 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: Melatih Model Anda Sendiri

Azure AI Custom Vision memungkinkan Anda melatih model klasifikasi gambar atau deteksi objek menggunakan gambar berlabel milik Anda sendiri tanpa menulis kode ML. Di portal Custom Vision, Anda mengunggah gambar, memberi tag, lalu mengeklik Train. Layanan ini melatih model dan mengembalikan metrik kinerja (Precision, Recall, AP). Selanjutnya, Anda menguji model dengan gambar baru dan menerbitkannya sebagai titik akhir prediksi. Model juga dapat diekspor sebagai ONNX atau CoreML untuk inferensi pada perangkat.

# 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) adalah penerus LUIS. Anda menentukan maksud (hal yang diinginkan pengguna, misalnya BookFlight, GetWeather) dan entitas (data yang akan diekstrak, misalnya kota tujuan dan tanggal perjalanan), menyediakan contoh ujaran untuk setiap maksud, melatih model, lalu menyebarkannya. Aplikasi memanggil titik akhir prediksi CLU untuk mengklasifikasikan input pengguna ke dalam maksud yang benar dan mengekstrak entitas. CLU mendukung lapisan pemahaman pada asisten virtual dan chatbot.

Menangani Kesalahan API dan Pembatasan Laju

API Azure AI Services mengembalikan kode status HTTP standar. 400 Bad Request berarti input tidak valid (misalnya dokumen terlalu panjang—Text Analytics mendukung hingga 5.120 karakter per dokumen). 401 Unauthorized berarti kunci API tidak valid atau tidak ada. 429 Too Many Requests berarti Anda telah melampaui kuota layanan—terapkan penundaan eksponensial dengan variasi acak lalu coba lagi. Untuk produksi, pertimbangkan sumber daya khusus (bukan tingkat gratis) dan ajukan peningkatan kuota melalui portal Azure jika memerlukan throughput yang lebih tinggi.

Mengintegrasikan Layanan AI dengan Logic Apps

Azure AI Services dapat diintegrasikan dengan Azure Logic Apps menggunakan konektor bawaan, sehingga memungkinkan alur kerja AI tanpa kode. Contohnya: saat email baru tiba → ekstrak lampiran → panggil Computer Vision Read API untuk melakukan OCR pada teks dari lampiran → panggil Text Analytics untuk mengekstrak frasa kunci → tulis hasil ke daftar SharePoint. Logic Apps menyertakan konektor untuk Cognitive Services (Language, Vision, Translator) yang menangani autentikasi dan panggilan API tanpa perlu menulis kode permintaan REST.

Menggunakan Layanan AI dengan SDK Python

Microsoft menyediakan paket Python resmi untuk setiap Layanan AI. Pasang azure-ai-textanalytics untuk API Bahasa atau azure-cognitiveservices-vision-computervision untuk Visi. SDK secara otomatis menangani autentikasi, serialisasi, dan logika percobaan ulang. Lakukan autentikasi menggunakan AzureKeyCredential atau DefaultAzureCredential (mendukung identitas terkelola). Penggunaan SDK lebih disarankan daripada permintaan HTTP mentah dalam kode produksi karena menyediakan keamanan tipe dan pemutakhiran yang lebih mudah ketika versi API berubah.

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

Pemeriksaan Singkat

Uji pemahaman Anda tentang konsep Microsoft Azure Fundamentals (AZ-900) dari pelajaran ini.

Rangkuman Pelajaran

Dalam pelajaran ini Anda mempelajari bahwa Computer Vision API menganalisis gambar untuk menemukan objek, deskripsi, dan teks OCR (menggunakan Read API asinkron), Text Analytics APIs mengekstrak sentimen, frasa kunci, dan PII dari teks, serta Translator API mengonversi teks antarlebih dari 100 bahasa dalam satu panggilan. Selanjutnya, kita akan mempelajari Azure Machine Learning Studio untuk melatih dan menerapkan model ML khusus.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “API Language dan Vision dalam Praktik” gratis?

Ya — teks lengkap “API Language dan Vision dalam Praktik” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Azure Fundamentals, upgrade ke CoddyKit PRO. Kursus Azure Fundamentals mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “API Language dan Vision dalam Praktik”?

Panggil Computer Vision API untuk menganalisis gambar dan Text Analytics API untuk mengekstrak sentimen serta frasa kunci dari ulasan pelanggan menggunakan permintaan REST. Kamu berlatih Azure Fundamentals dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Azure Fundamentals?

Tidak diperlukan pengalaman sebelumnya. Azure Fundamentals di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.

Berapa lama pelajaran “API Language dan Vision dalam Praktik” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Azure Fundamentals ini?

Ya. Setiap pelajaran Azure Fundamentals menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Azure Fundamentals