ajan için Microsoft Fabric yapılandırma

Bir Fabric API for GraphQL hazırlayın ve ajan entegrasyonunu Fabric sahibi veya çalışma alanı yöneticisi olarak yapılandırın.

Bu kılavuzu Fabric çalışma alanı yöneticisi, API for GraphQL sahibi veya ajan çalışma alanı yöneticisiyseniz kullanın. Yapılandırmayı tamamladıktan sonra bireysel kullanıcıların yalnızca bağlantılarını eklemesi gerekir. Erişim ve yazma işlemi kararları için Erişim ve mutation'lar sayfasına bakın.

Başlamadan önce

Şunlara ihtiyacınız var:

• Fabric, Trial veya Premium kapasiteyle desteklenen bir Fabric çalışma alanı.

Fabric'te API for GraphQL kurma

Fabric çalışma alanı yöneticisi veya API sahibi olarak API'yi ajan için hazırlayın:

Bir API for GraphQL oluşturun

Fabric çalışma alanında bir API for GraphQL öğesi oluşturun.

API'nin veri kaynaklarına nasıl bağlanacağını seçin

Kullanıcıların kaynağa kendi kimlikleriyle erişmesi gerektiğinde Single sign-on (SSO) (önerilen) seçin. Her API çağıranın merkezi yönetilen tek bir kaynak kimliği kullanması gerektiğinde Saved credentials seçin. Her GraphQL API, kaynaklarında tek bir mod kullanır.

Hangi seçeneğin uygun olduğundan emin değilseniz, her kimlik doğrulama modelinin kimlik, izinler ve erişimi nasıl ele aldığını karşılaştırın.

Açığa çıkarılacak verileri seçin

İlgili veri kaynaklarını ekleyin ve dahil edilecek tabloları, görünümleri, saklı yordamları ve sütunları seçin. Kullanıcıların ilgili kayıtları tek sorguda alması gerektiğinde aynı kaynaktaki nesneler arasında ilişkiler tanımlayın. İlişkiler yalnızca aynı kaynaktaki nesneler arasında kullanılabilir.

Şemayı amaçlanan kullanım durumuna odaklı tutmak için yalnızca tüketicilerin ihtiyaç duyduğu nesne ve işlemleri dahil edin.

Introspection'ı etkinleştirin

API Settings öğesini açın, Introspection seçin ve etkinleştirin. Introspection varsayılan olarak kapalıdır. Etkinleştirmek ajan'ın kullanılabilir türleri, alanları, argümanları, sorguları ve mutation'ları keşfetmesine olanak tanır ve bu şema meta verilerini API uç noktasına erişimi olan tüm kullanıcılara görünür kılar.

Erişim verin

Her kullanıcıya GraphQL API öğesinde Run Queries and Mutations verin. İzin iletişim kutusu bu etiketi kullanır; Direct access ve üç nokta menüsü aynı izni Execute olarak özetler ve yönetir.

SSO ile her kullanıcıya her alt kaynakta da gerekli izinleri verin. Saved credentials ile bunun yerine kayıtlı Fabric kimliğine gerekli kaynak izinlerini verin. Bkz. Kimlerin okuyabileceğini veya değiştirebileceğini kontrol etme.

Şemayı yenileyin ve doğrulayın

Kaynak nesneleri ekledikten, kaldırdıktan veya değiştirdikten sonra Update schema seçin ve sonucun en son kaynak şemasını yansıttığını Schema explorer içinde doğrulayın.

Kullanıcıları bağlamadan önce Fabric'te odaklı bir sorgu çalıştırın ve beklenen kaynak nesneleri ile sonuçların kullanılabilir olduğunu onaylayın.

ajan'da entegrasyonu etkinleştirme

ajan çalışma alanı yöneticisi olarak Microsoft Fabric'i etkinleştirin. ajan ardından API'leri bulabilir, şemalarını inceleyebilir, veri sorgulayabilir ve kullanıcıların kimlik veya uç nokta URL'si sağlamasını gerektirmeden mutation kullanabilir. Mutation eylemi yürütmeden önce onay ister.

Yeni etkinleştirilen eylemler Microsoft izinleri eklerse mevcut kullanıcılardan bir kez yeniden bağlanmalarını isteyin.

Kullanıcıları bağlama

Her kullanıcıdan ajan'da Microsoft Fabric'i açmasını, Add connection seçmesini ve erişim verdiğiniz Microsoft hesabıyla oturum açmasını isteyin.

Kullanıcıları üç adımlı kullanıcı kılavuzuna yönlendirin. Bir API ada göre keşfedilemiyorsa Sorun giderme sayfasına bakın.

Kurulumu doğrulama

Dağıtmayı planladığınız erişimi onaylamak için temsili bir iş kullanıcısı kullanın:

1. O kullanıcı olarak Fabric'in GraphQL düzenleyicisinde odaklı bir sorgu çalıştırın.
2. ajan'da aynı veriyi gerektiren bir soru sorun ve sonucu kaynakla karşılaştırın.
3. Mutation açıyorsanız tek kullanımlık bir kayıt kullanın, işlemi ajan'da onaylayın ve değişikliği Fabric'te doğrulayın.

Bir kontrol başarısız olursa keşif, şema veya izinlerden hangisinin dikkat gerektirdiğini belirlemek için Sorun giderme kullanın.