Azure Becerilerini yükleme ve yapılandırma

Bu makalede, Azure Becerileri'ni yükleme, Azure hesabınızda kimlik doğrulaması ve yüklemeyi doğrulama gösterilmektedir. Kurulumdan sonra Azure kaynaklarını sohbet arabiriminizden yönetebilirsiniz.

Önkoşullar

Şu durumlara sahip olduğunuzdan emin olun:

• Node.js Uzun Süreli Destek (LTS):nodejs.org'dan indirin veya nvm gibi bir sürüm yöneticisi kullanın.
• Azure hesabı: Ücretsiz bir hesap oluşturun eğer yoksa.
• Bir yapay zeka yardımcısı: GitHub Copilot CLI, Claude Code veya başka bir uyumlu platform.
• Azure CLI (yerel geliştirme için önerilir): Kimlik doğrulamasını basitleştirir. Azure CLI yükleyin. Ortam değişkenleri veya yönetilen kimlik, CI/CD işlem hatlarında alternatif olarak kullanılabilir.

Uyarı

Azure Becerileri, Azure MCP Server ile aynı kimlik doğrulamasını kullanır. Azure MCP Sunucusu için zaten kimlik doğrulaması aldıysanız, Azure Becerileri bu kimlik bilgilerini kullanır.

Azure kimlik doğrulaması

Azure Becerileri, Azure kaynaklarınıza erişmek için kimlik bilgilerine ihtiyaç duyar. Kullanım örneğinize uyan yöntemi seçin.

Azure CLI (önerilir)

Bu yöntem, yerel geliştirme ve test için en kolay yöntemdir.

1. Azure CLI'yi yükleme:

   • Azure CLI yükleme kılavuzunu ziyaret edin.
   • Veya bir paket yöneticisi kullanın: brew install azure-cli (macOS), apt-get install azure-cli (Linux).

2. Azure'a giriş yapın:

   az login
   

   Bir tarayıcı penceresi açılır. Azure hesabı kimlik bilgilerinizi kullanarak oturum açın.

3. Kimlik doğrulamayı doğrulayın:

   az account show
   

   Abonelik ayrıntılarınızı terminalde görürsünüz. Azure Becerileri bu kimlik doğrulamayı algılar.

Ortam değişkenleri

Azure CLI'nin kullanılamadığı durumlarda betik veya pipeline'lar için ortam değişkenlerini kullanın. Önce bir hizmet sorumlusu oluşturun.

Bash veya Zsh:

export AZURE_TENANT_ID="your-tenant-id"
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"

PowerShell:

$env:AZURE_TENANT_ID = "your-tenant-id"
$env:AZURE_CLIENT_ID = "your-client-id"
$env:AZURE_CLIENT_SECRET = "your-client-secret"

Windows Komut İstemi:

set AZURE_TENANT_ID=your-tenant-id
set AZURE_CLIENT_ID=your-client-id
set AZURE_CLIENT_SECRET=your-client-secret

Azure Becerileri bu ortam değişkenlerini otomatik olarak algılar.

Yönetilen kimlik

Azure üzerinde çalışan bir kaynağınızda (sanal makine, Container Apps veya Azure Functions) Azure Yetenekleri çalıştırırsanız, yönetilen kimlik, kimlik doğrulamayı elle kurulum gerektirmeden işler.

Daha fazla bilgi için bkz. Azure yönetilen kimlikler.

Azure Becerileri Yükleme

Yapay zeka yardımcınız için yükleme yöntemini seçin.

GitHub Copilot CLI

Marketi ekleyin (yalnızca ilk kez):

/plugin marketplace add microsoft/azure-skills

Eklentiyi yükleyin:

/plugin install azure@azure-skills

Eklentiyi güncelleştirin:

/plugin update azure@azure-skills

Visual Studio Code

Visual Studio Market'ten Azure MCP uzantısını yükleyin:

👉 Azure MCP Uzantısı

Azure MCP uzantısı, Azure Skills adı verilen özellikleri Visual Studio Code'a getiren bir yardımcı uzantı yükler. Birlikte Azure MCP Sunucusunu ve tam beceri katmanını yapılandırırlar.

Uyarı

Beceri uzantısı, git CLI'nin makinenize yüklenmesini gerektirir.

Claude Code

Marketi ekleyin (yalnızca ilk kez):

/plugin marketplace add microsoft/azure-skills

Eklentiyi yükleyin:

/plugin install azure@azure-skills

Güncelleştirme:

/plugin marketplace update azure-skills

İmleç

Azure eklentisini İmleç Marketi'nden veya doğrudan İmleç ayarlarından yükleyin:

1. Ayarlar>Eklentileri'ne gidin.

2. Azure'da arama.

3. Yüklemek için Azure eklentisini seçin.

   

Eklenti, Azure MCP Sunucusu, Foundry MCP ve tam beceri katmanını otomatik olarak yapılandırıyor.

Azure Skills'ı IntelliJ IDEA'ya yüklemeden önce şunları yaptığınızdan emin olun:

• Node.js 18'den fazla sürümü sisteminizde yüklüdür ve npx PATH'inizde kullanılabilir.
• Git yüklendi ve komut satırından erişilebilir.

Şu önkoşulları çalıştırarak doğrulayabilirsiniz:

npx --version
git --version

1. Adım: GitHub Copilot eklentisini yükleme

1. IntelliJ IDEA'sı açın.
2. Dosya>Ayarları 'na (Windows/Linux'ta) veya IntelliJ IDEA>Tercihleri'ne (macOS'ta) gidin.
3. Sol kenar çubuğunda Eklentiler'e gidin.
4. Market sekmesinde GitHub Copilot araması yapın.
5. GitHub Copilot eklentisini yükleyin (sürüm 1.5.64-242 veya üzeri gerektirir).
6. İstendiğinde IntelliJ IDEA'sı yeniden başlatın.

2. Adım: GitHub Copilot için becerileri etkinleştirme

1. IntelliJ IDEA ayarlarını veya tercihlerini yeniden açın.

2. Araçlar>GitHub Copilot>Sohbet konumuna gidin.

3. Becerileri Etkinleştir onay kutusunu seçin.

4. Uygula ve Tamam’ı seçin.

   

3. Adım: Azure Becerileri'ni yükleme

Seçenek 1: IntelliJ için Azure Toolkit

1. JetBrains Market'ten IntelliJ için Azure Toolkit eklentisini yükleyin.

2. Eklenti yüklemesini tamamlamak için IntelliJ IDEA'yı yeniden başlatın.

3. Yeniden başlatıldıktan sonra Azure Becerileri'ni yüklemeyi teklif eden bir bildirim görüntülenir. Azure becerilerini ortamınıza eklemek için Yükle'yi seçin.

   

4. GitHub Copilot sohbet penceresini açıp yazarak /skill:azureyüklemeyi doğrulayın. Bu komut tüm kullanılabilir Azure becerilerini görüntüler.

   

Seçenek 2: El ile yükleme

1. Bir terminal veya komut istemi açın.

2. GitHub Copilot için Azure Becerileri'ni genel olarak yüklemek için aşağıdaki komutu çalıştırın:

   npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
   

3. Yüklemenin tamamlanmasını bekleyin. Azure becerileri başarıyla eklendiğinde bir onay iletisi görüntülenir.

Desteklenen konakların ve yükleme seçeneklerinin tam listesi için bkz. Azure Skills deposu.

Yüklemeyi doğrulama

Yüklemeden sonra Azure Becerilerin kullanıma hazır olduğunu onaylayın.

1. Yüklü eklentileri listeleyin:

   /plugin list
   

   Çıkış azure@azure-skills ve kullanılabilir beceriler içerir.

2. Hızlı bir komutla test edin:

   /ask List my Azure subscriptions
   

   Yapay zeka yardımcınız Azure hesabınızı sorgular ve aboneliklerinizi görüntüler.

Azure Becerileri Deneyin

Azure Becerileri'ni yükleyip doğruladıktan sonra yapay zeka yardımcınızın sohbet penceresinde şu istemleri deneyin:

Projeniz için bir dağıtım planı hazırlayın:

Analyze my project structure and prepare a deployment plan for deploying to Azure. What infrastructure do I need and how should I set it up?

Beklenen yanıt: Yardımcı, kod tabanınızı analiz eder ve kod olarak altyapı şablonları oluşturur. adresinde .azure/plan.md bir dağıtım planı oluşturur ve onayınızı ister.

Azure kaynak durumu sorununu tanılama:

I'm getting errors from my Azure App Service. What's wrong and how do I fix it?

Beklenen yanıt: Yardımcı, uygulama hizmetinizi inceler, günlükleri denetler ve son dağıtımları gözden geçirir. Sorunları tanımlar ve düzeltme adımları sağlar.

İzleme ve gözlemlenebilirliği ayarlama:

Configure monitoring and alerting for my application. Which Application Insights features should I enable? What metrics should I track?

Beklenen yanıt: Yardımcı bir izleme stratejisi önerir ve izleme kodu oluşturur. Uygulama yığınınıza uyarlanmış kritik ölçümler için Azure Uyarıları yapılandırıyor.

Desteklenen yapay zeka yardımcıları

Azure Becerileri'ni şu platformlarda kullanabilirsiniz:

• GitHub Copilot CLI: GitHub Copilot araçlarıyla tam tümleştirme
• Claude Code: Model Bağlam Protokolü (MCP) aracılığıyla
• Diğer MCP uyumlu yapay zeka yardımcıları: MCP'i destekleyen herhangi bir araç

Azure tümleştirmesini destekleyen araçların tam listesi için bkz. Azure MCP Server tarafından desteklenen araçlar.

Yapılandırma seçenekleri

Telemetri

Varsayılan olarak, Azure Becerileri hizmeti geliştirmek için kullanım telemetrisini toplar.

Telemetriyi devre dışı bırakmak için:

export AZURE_MCP_COLLECT_TELEMETRY=false

Sorun giderme

"Kimlik doğrulama başarısız" hatası

Problem: Yapay zeka yardımcınız Azure için kimlik doğrulaması yapamaz.

Çözümler:

• Azure CLI:az login yeniden çalıştırın ve kimliğinizin doğrulanmış olduğundan emin olun.
• Ortam değişkenleri: , AZURE_TENANT_IDve AZURE_CLIENT_ID ayarlarının doğru olduğunu doğrulayınAZURE_CLIENT_SECRET.
• Yönetilen kimlik: Azure kaynağınızın atanmış bir yönetilen kimliği olduğunu onaylayın.

"Eklenti bulunamadı" hatası

Problem: Azure Becerileri eklentisi yüklenmez veya tanınmaz.

Çözümler:

• Pazaryerini kaydetmek için komut çalıştırın /plugin marketplace add microsoft/azure-skills.
• Eklentiyi yüklemek için komutunu çalıştırın /plugin install azure@azure-skills.
• Yapay zeka yardımcınızı yeniden başlatın.
• Node.js yüklendiğini doğrulayın.

"Yetersiz izinler" hatası

Problem: Azure hesabınızın gerekli izinleri yok.

Çözümler:

• Azure rol tabanlı erişim denetimi (RBAC) rol atamalarınızı denetleyin.
• Azure yöneticinizden daha fazla rol isteyin.
• Daha yüksek izinlere sahip olduğunuz farklı bir abonelik kullanın.

"Geçersiz abonelik" hatası

Problem: Azure Becerileri belirtilen aboneliğinizi bulamıyor veya erişemiyor.

Çözümler:

• Kullanılabilir abonelikleri görmek için komutunu çalıştırın az account list.
• Abonelik kimliğinin veya adının doğru olduğunu doğrulayın.
• Kimlik bilgilerinizin aboneliğe erişimi olup olmadığını denetleyin.

İlgili içerik

• Azure Skills
• Azure Becerilerine Genel Bakış
• Azure için GitHub Copilot
• Azure MCP Server kullanmaya başlama kılavuzu