Mulai cepat: Buat sumber daya Cognitive Services menggunakan Azure CLI

  • Artikel
  • 7 menit untuk membaca

Gunakan mulai cepat untuk membuat sumber daya Cognitive Services menggunakan perintah Azure Command-Line Interface (CLI). Setelah membuat sumber daya, gunakan kunci dan titik akhir yang dihasilkan untuk mengautentikasi aplikasi Anda.

Azure Cognitive Services adalah layanan berbasis cloud dengan REST API, dan SDK pustaka klien yang tersedia untuk membantu pengembang membangun kecerdasan kognitif ke dalam aplikasi tanpa memiliki kecerdasan buatan (AI), keterampilan, atau pengetahuan ilmu data secara langsung. Azure Cognitive Services memungkinkan pengembang untuk dengan mudah menambahkan fitur kognitif ke dalam aplikasi dengan solusi kognitif yang dapat melihat, mendengar, berbicara, memahami, dan bahkan mulai bernalar.

Jenis sumber daya Cognitive Services

Anda dapat mengakses Azure Cognitive Services melalui dua sumber daya yang berbeda: Sumber daya multilayanan, atau satu layanan.

  • Sumber daya multilayanan:
    • Akses beberapa Azure Cognitive Services dengan satu kunci dan titik akhir.
    • Mengonsolidasi penagihan dari layanan yang Anda gunakan.
  • Sumber daya layanan tunggal:
    • Akses satu Azure Cognitive Services dengan kunci dan titik akhir unik untuk setiap layanan yang dibuat.
    • Gunakan tingkat gratis untuk mencoba layanan.

Prasyarat

  • Langganan Azure yang valid - Buat langganan secara gratis.
  • Azure CLI
  • Akun Azure Anda harus memiliki peran Layanan Cognitive Services yang ditetapkan agar Anda menyetujui persyaratan AI yang bertanggung jawab dan membuat sumber daya. Agar peran ini ditetapkan ke akun Anda, ikuti langkah-langkah dalam dokumentasi Menetapkan peran, atau hubungi administrator Anda.
  • Anda harus membuat sumber daya Wajah, Layanan bahasa, atau Visi Komputer dari portal Microsoft Azure untuk meninjau dan mengonfirmasi syarat dan ketentuan. Anda dapat melakukannya di sini: Wajah, Layanan bahasa, Visi Komputer. Setelah itu, Anda dapat membuat sumber daya berikutnya menggunakan alat penyebaran apa pun (templat SDK, CLI, atau ARM, dll) di bawah langganan Azure yang sama.

Menginstal Azure CLI dan masuk

Instal Azure CLI. Untuk masuk ke penginstalan lokal CLI Anda, jalankan perintah az login:

az login

Anda juga dapat menggunakan tombol Coba yang berwarna hijau untuk menjalankan perintah ini di browser Anda.

Membuat grup sumber daya Azure Cognitive Services baru

Sebelum membuat sumber daya Cognitive Services, Anda harus memiliki grup sumber daya Azure untuk memuat sumber daya. Saat membuat sumber daya baru, terdapat opsi untuk membuat grup sumber daya baru, atau menggunakan sumber daya yang sudah ada. Artikel ini memperlihatkan cara membuat grup sumber daya baru.

Memilih lokasi grup sumber daya Anda

Untuk membuat sumber daya, Anda memerlukan salah satu lokasi Azure yang tersedia untuk langganan Anda. Anda dapat mengambil daftar lokasi yang tersedia dengan perintah az account list-locations. Sebagian besar Cognitive Services dapat diakses dari beberapa lokasi. Pilih salah satu yang paling dekat dengan Anda, atau lihat lokasi mana yang tersedia untuk layanan ini.

Penting

  • Ingat lokasi Azure Anda, karena Anda akan membutuhkannya saat menghubungi Azure Cognitive Services.
  • Ketersediaan beberapa Cognitive Services dapat bervariasi berdasarkan wilayah. Untuk informasi selengkapnya, lihat Produk Azure berdasarkan wilayah.
az account list-locations \
    --query "[].{Region:name}" \
    --out table

Setelah Anda memiliki lokasi Azure Anda, buat grup sumber daya baru di Azure CLI menggunakan perintah az group create.

Dalam contoh di bawah ini, ganti lokasi Azure westus2 dengan salah satu lokasi Azure yang tersedia untuk langganan Anda.

az group create \
    --name cognitive-services-resource-group \
    --location westus2

Membuat sumber daya Cognitive Services

Pilih layanan kognitif dan tingkat harga

Saat membuat sumber daya baru, Anda harus mengetahui "jenis" layanan yang ingin Anda gunakan, serta tingkat harga (atau sku) yang Anda inginkan. Anda akan menggunakan informasi ini dan informasi lain sebagai parameter saat membuat sumber daya.

Anda dapat mengakses Azure Cognitive Services melalui dua sumber daya yang berbeda: Sumber daya multilayanan, atau satu layanan.

  • Sumber daya multilayanan:
    • Akses beberapa Azure Cognitive Services dengan satu kunci dan titik akhir.
    • Mengonsolidasi penagihan dari layanan yang Anda gunakan.
  • Sumber daya layanan tunggal:
    • Akses satu Azure Cognitive Services dengan kunci dan titik akhir unik untuk setiap layanan yang dibuat.
    • Gunakan tingkat gratis untuk mencoba layanan.

Lihat daftar SKU dan informasi harga di bawah ini.

Multi-layanan

Layanan Jenis
Multi layanan. Untuk informasi selengkapnya, lihat halaman harga. CognitiveServices

Penglihatan

Layanan Jenis
Computer Vision ComputerVision
Custom Vision - Prediksi CustomVision.Prediction
Custom Vision - Pelatihan CustomVision.Training
Wajah Face
Form Recognizer FormRecognizer

Ucapan

Layanan Jenis
Layanan Ucapan SpeechServices

Bahasa

Layanan Jenis
LUIS LUIS
QnA Maker QnAMaker
Layanan bahasa TextAnalytics
Terjemahan Teks TextTranslation

Keputusan

Layanan Jenis
Detektor Anomali AnomalyDetector
Moderator Konten ContentModerator
Personalizer Personalizer

Tingkat harga dan tagihan

Tingkat harga (dan jumlah yang ditagihkan kepada Anda) didasarkan pada jumlah transaksi yang Anda kirim menggunakan informasi autentikasi Anda. Setiap tingkat harga menentukan:

  • jumlah maksimum transaksi yang diperbolehkan per detik (TPS).
  • fitur layanan yang diaktifkan dalam tingkat harga.
  • biaya untuk jumlah transaksi yang telah ditentukan sebelumnya. Pergi di atas nomor ini akan menyebabkan biaya tambahan seperti yang ditentukan dalam rincian harga untuk layanan Anda.

Catatan

Banyak dari Cognitive Services memiliki tingkat gratis yang dapat Anda gunakan untuk mencoba layanan ini. Untuk menggunakan tingkat gratis, gunakan F0 sebagai SKU untuk sumber daya Anda.

Anda dapat menemukan daftar "jenis" Cognitive Services yang tersedia dengan perintah az cognitiveservices account list-kinds:

az cognitiveservices account list-kinds

Menambahkan sumber daya baru ke grup sumber daya Anda

Untuk membuat dan berlangganan sumber daya Cognitive Services baru, gunakan perintah az cognitiveservices account create. Perintah ini menambahkan sumber daya baru yang dapat ditagih ke grup sumber daya yang dibuat sebelumnya. Saat membuat sumber daya baru, Anda harus mengetahui "jenis" layanan yang ingin digunakan, sekaligus tingkat harga (atau sku) dan lokasi Azure:

Anda dapat membuat sumber daya F0 (gratis) untuk Anomaly Detector, bernama anomaly-detector-resource dengan perintah di bawah ini.

az cognitiveservices account create \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --kind AnomalyDetector \
    --sku F0 \
    --location westus2 \
    --yes

Tip

Jika langganan Anda tidak memungkinkan Anda membuat sumber daya Cognitive Service, Anda mungkin perlu mengaktifkan kemampuan penyedia sumber daya Azure dengan portal Azure, perintah PowerShell, atau perintah Azure CLI. Jika Anda bukan pemilik langganan, mintalah Pemilik Langganan atau seseorang dengan peran admin untuk menyelesaikan pendaftaran untuk Anda atau minta hak istimewa /register/action diberikan ke akun Anda.

Mendapatkan kunci untuk sumber daya Anda

Untuk masuk ke penginstalan lokal Command-Line Interface (CLI), gunakan perintah az login.

az login

Gunakan perintah az cognitiveservices account keys list guna mendapatkan kunci untuk sumber daya Cognitive Services Anda.

    az cognitiveservices account keys list \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group

Mengonfigurasi variabel lingkungan untuk autentikasi

Aplikasi perlu mengautentikasi akses ke Cognitive Services yang digunakan aplikasi. Untuk mengautentikasi, sebaiknya buat variabel lingkungan untuk menyimpan kunci untuk Sumber Daya Azure Anda.

Setelah Anda memiliki kunci Anda, tulis ke variabel lingkungan baru pada mesin lokal yang menjalankan aplikasi. Untuk mengatur variabel lingkungan, buka jendela konsol, dan ikuti petunjuk untuk sistem operasi Anda. Ganti your-key dengan salah satu kunci untuk sumber daya Anda.

setx COGNITIVE_SERVICE_KEY "your-key"

Setelah Anda menambahkan variabel lingkungan, Anda mungkin perlu memulai ulang program yang sedang berjalan yang perlu membaca variabel lingkungan, termasuk jendela konsol. Misalnya, jika Anda menggunakan Visual Studio sebagai editor, hidupkan ulang Visual Studio sebelum menjalankan contoh.

Tingkat harga dan tagihan

Tingkat harga (dan jumlah yang ditagihkan kepada Anda) didasarkan pada jumlah transaksi yang Anda kirim menggunakan informasi autentikasi Anda. Setiap tingkat harga menentukan:

  • jumlah maksimum transaksi yang diperbolehkan per detik (TPS).
  • fitur layanan yang diaktifkan dalam tingkat harga.
  • Biaya untuk jumlah transaksi yang telah ditentukan sebelumnya. Melebihi jumlah ini akan menyebabkan biaya tambahan seperti yang ditentukan dalam rincian harga untuk layanan Anda.

Mendapatkan penggunaan kuota saat ini untuk sumber daya Anda

Gunakan perintah az cognitiveservices account list-usage untuk mendapatkan penggunaan sumber daya Cognitive Services Anda.

az cognitiveservices account list-usage \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --subscription subscription-name

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Cognitive Services, Anda dapat menghapusnya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya lain yang terkandung dalam grup ini.

Untuk menghapus grup sumber daya dan sumber daya terkait, gunakan perintah az group delete.

az group delete --name cognitive-services-resource-group

Jika Anda perlu memulihkan sumber daya yang dihapus, lihat Memulihkan sumber daya Azure Cognitive Services yang dihapus.

Lihat juga