Microsoft Visual Studio Code için Microsoft Copilot Studio uzantısını yükleme

Önkoşullar

Microsoft Visual Studio Code için Microsoft Copilot Studio uzantısını yüklemeden önce aşağıdaki gereksinimleri karşıladığınızdan emin olun:

Sistem gereksinimleri

  • İşletim Sistemi:
    • Windows (x64 mimarisi)
      • Windows 10 sürüm 1809 veya üzeri
      • Windows 11 (herhangi bir sürüm)
    • macOS
  • Visual Studio Code: Sürüm 1.80 veya üzeri (en son kararlı sürüm önerilir)
  • İnternet bağlantısı: Kurulum ve doğrulama için gerekli

Hesap gereksinimleri

  • Microsoft account: Copilot Studio lisansına veya erişimine sahip Etkin Microsoft hesabı
  • Copilot Studio lisansı: Hesabınıza uygun lisans atandı
  • Environment access: En az bir Copilot Studio ortamına erişme izinleri
  • Temsilci izinleri: Düzenlemeyi planladığınız ajanlara okuma ve yazma erişimi

Yükleme adımları

Visual Studio Code'da Copilot Studio uzantısını yüklemenin iki yolu vardır:

  • Visual Studio Code içinden yükleme
  • Visual Studio Code Market web sitesinden yükleme

Yöntem 1: Visual Studio Code'dan yükleme

  1. Etkinlik çubuğunda Extensions simgesini seçin veya tuşuna basın Ctrl+Shift+X. Extensions bölmesi Visual Studio Code'da açılır.

  2. Arama çubuğuna "Copilot Studio" yazın. Sonuçlar listesinde resmi Copilot Studio uzantısını arayın. Yayıncının "Microsoft" olduğunu doğrulayın.

  3. Doğru uzantıyı bulduğunuzda, uzantı detaylar sayfasını açmak için onu seçin.

  4. Kuruluma başlamak için Kurulum'u seçin.

  5. Yüklemenin tamamlanmasını bekleyin. Visual Studio Code yeniden yüklemek için bir istem görebilirsiniz; bu durumda istendiğinde Reload seçeneğini belirleyin.

  6. Kurulumu doğrulayın. Etkinlik çubuğunda Copilot Studio simgesini arayın. Simge, Copilot Studio markasıyla birlikte görünür.

Yöntem 2: Visual Studio Code market web sitesinden yükleme

  1. https://marketplace.visualstudio.com/ gidin ve "Copilot Studio" araması yapın. Doğrudan bağlantıyı da kullanabilirsiniz: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Marketplace sayfasında Install seçeneğini seçin. Tarayıcı istemleriniz, Visual Studio Code açmanızı istemeden önce Visual Studio Code indirmenizi isteyebilir.

  3. Etkinlik çubuğunda uzantı simgesini arayarak tarayıcının Visual Studio Code açmasına ve yüklemeyi onaylamasına izin verin.

İlk yapılandırma

İlk fırlatma

  1. Etkinlik çubuğunda Copilot Studio simgesini seçin. Uzantı bir uygulama paneli olarak açılır. Copilot Studio uzantısının oturum açmanız gerektiğini belirten bir açılır bildirim görüntülenir.

  2. Açılır pencerede Giriş Yap seçeneğini seçin, sonra İzin Ver seçeneğini seçin. Varsayılan tarayıcınız Microsoft kimlik doğrulama sayfasına açılır.

  3. Kimlik doğrulama bilgilerinizi girin ve gerekirse çok faktörlü kimlik doğrulamanızı tamamlayın.

  4. Talep edilen izinleri gözden geçirin:

    • Copilot Studio aracılarını okuma ve yazma
    • Erişim ortamı bilgisi
    • Dosyaları buluta senkronize et

    Kabul et veyaizin ver seçeneğini seç. Tarayıcı, pencereyi kapatıp Visual Studio Code'a geri dönebileceğiniz konusunda sizi bilgilendirir.

  5. Visual Studio Code'a geri dönün. Uzantı paneli, erişebildiğiniz ortamları ve bu ortamlardaki ajanları yükler.

Başarılı kurulumu doğrulayın

Kimlik doğrulamasından sonra, Visual Studio Code'daki Copilot Studio uzantısında Agents bölmesinin altında bir yapı görmeniz gerekir. İç içe ortamlar ve ajanlar içeren bir çevre grupları listesini görmelisiniz; aşağıdaki yapıya benzer:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Yükleme sorunlarını giderme

Aşağıda, Copilot Studio Visual Studio Code uzantısını yüklerken veya yapılandırırken oluşabilecek bazı sorunlar için sorun giderme adımları yer alır.

Uzantı görünmüyor

Problem: etkinlik çubuğunda Copilot Studio simgesi görünmez.

Çözüm:

  1. Visual Studio Code yeniden yükleme
  2. Extensions seçeneğini seçin ve Kurulular listesinde uzantı arayın. Uzantının devre dışı kalmadığından emin olun.
  3. Visual Studio Code en son sürüme güncelleştirin.
  4. Uzantını yeniden yükleyin.

Kimlik doğrulama hataları

Sorun: Kimlik doğrulama başarısız olur veya tekrar tekrar tekrar eder.

Çözüm:

  1. Tarayıcı önbelleğinizi ve çerezlerinizi temizleyin.microsoft.com

  2. Farklı bir tarayıcı ile giriş yapmayı deneyin. Bu tarayıcıyı geçici olarak varsayılan olarak ayarlayın.

  3. Kimlik doğrulamayı engelleyebilecek tarayıcı eklentilerini devre dışı bırakın.

  4. Kurumsal güvenlik duvarı ve proxy ayarlarını kontrol et.

  5. Desteklenen bir hesap türü kullandığınızdan emin olun.

Uzantı Visual Studio Code markette bulunamadı

Problem: Arama yaparken Copilot Studio uzantısı bulunamıyor.

Çözüm:

  1. Web aramasında değil , Uzantılar panelinde arama yaptığınızdan emin olun.

  2. Yazım denetimi: "Copilot Studio."

  3. Kuruluşunuzun market erişimine Visual Studio Code kısıtlaması olup olmadığını görmek için yöneticinize başvurun.

Uzantıyı kaldırma

Uzantıyı kaldırmak için:

  1. Uzantılar panelini açın.

  2. Yüklü uzantılarda Copilot Studio bulun.

  3. Listedeki girişte,Yönet (dişli simgesi) >Kaldır seçeneğini seçin.

  4. İstendiğinde Visual Studio Code yeniden yükleyin.

Uyarı

Uzantı kaldırmak yerel olarak klonlanmış ajan dosyalarını silmez. Bu dosyaları manuel olarak silmeniz gerekiyor.

Sonraki Adımlar

Uzantıyı yükledikten ve Copilot Studio ile kimlik doğrulaması yaptıktan sonra şunları yapmaya hazırsınız:

  • Last updated on