Azure Logic Apps (önizleme) içinde kullanılacak aracı iş akışları için bilgi bankası oluşturma

Şunlar için geçerlidir: Azure Logic Apps (Standart)

Kuruluşunuz belgeler, elektronik tablolar, API'ler ve iç sistemlerden yapılandırılmamış veriler oluşturur. Azure Logic Apps'teki Hizmet olarak Bilgi Bankası (KBaaS) özelliğini kullanarak bu içeriği, aracı iş akışlarındaki aracı döngülerin görevleri tamamlamak için kullanabileceği, yapılandırılmış ve daha kolay aranabilir bir bilgi bankası haline dönüştürebilirsiniz. Bilgi bankası, belgeler veya belirli bir etki alanıyla ilgili dosyalar gibi ilgili bilgi kaynaklarını düzenleyen mantıksal bir kapsayıcıdır .

Örneğin, İK politikaları ve prosedürleriyle ilgili tüm belgeleri içeren bir bilgi tabanı oluşturabilirsiniz. Bilgi bankası oluşturduğunuzda, KBaaS gerekli Azure Cosmos DB veritabanlarını, kapsayıcıları ve dizin oluşturma ilkelerini otomatik olarak ayarlar. Daha fazla bilgi için bkz. Azure Cosmos DB veritabanları, kapsayıcılar ve öğeler.

Bu kılavuzda bilgi bankası oluşturma, bilgi kaynaklarını karşıya yükleme ve bilgi bankasını aracı döngüsünün Standart aracı iş akışında kullanabileceği bir araç olarak ekleme işlemleri gösterilmektedir.

Limitations

Bu önizleme sürümünde aşağıdaki sınırlamalar vardır:

• Bu önizleme aşağıdaki özellikleri destekler:

  • Bilgi öğeleri için kaynak türü olarak yüklenen dosyalar.
  • Şu biçimlere sahip dosyalar: DOC, DOCX, HTML, MD, PDF, PPT, PPTX, TXT, XLS, XLSX.
  • Resimlerde değil, belgelerde metin tabanlı içerik ayrıştırma.
  • Varsayılan öbekleme ayarları, özel öbekleme değil.

• Bilgi tabanı bağlantınızı oluşturduktan sonra yalnızca bağlantının ve Azure OpenAI modellerinin görünen adlarını düzenleyebilirsiniz. Kimlik doğrulama türü veya uç nokta bilgileri gibi diğer değerleri düzenleyemezsiniz.

• Şu anda bu özellik için yalnızca Azure portalı desteklenmektedir.

Bilgi bankası nasıl çalışır?

KBaaS, veri dönüştürmeyi basitleştirir ve Azure Cosmos DB ile Azure OpenAI üzerinde bir soyutlama katmanı sunarak iş akışlarınızın, özel bir Retrieval-Augmented Generation (RAG) işlem hattı oluşturmadan yapılandırılmış bilgileri daha kolay kullanmasını, işlemesini ve geri getirmesini sağlar.

KBaaS aşağıdaki işlem hatlarına sahiptir:

• Alma işlem hattı: Bilgi bankanıza bir belge veya bilgi kaynağı yüklediğinizde, hizmet içeriği otomatik olarak ayrıştırıyor, öbekler, özetler ve vektörleştiriyor. Hizmet daha sonra sonuçları Azure Cosmos DB olarak depolar.

• Retrieval işlem hattı: Aracı döngüsü bilgi bankanızı sorguladığında, gerekirse hizmet sorguyu yeniden yazar, bir vektör gösterimi oluşturur, Azure Cosmos DB karşı anlamsal bir arama gerçekleştirir ve yanıt oluşturma için büyük dil modeline (LLM) en uygun öbekleri döndürür.

Prerequisites

• ** Bir Azure hesabı ve aboneliği. Ücretsiz bir Azure hesabı edinin.

• Azure OpenAI kaynağı. Daha fazla bilgi için bkz. Azure OpenAI Service kaynağı oluşturma ve dağıtma.

  • Kaynağınız aşağıdaki dağıtılan modellere ihtiyaç duyar:

    • Gpt-4o gibi bir tamamlama modeli.
    • Örneğin text-embedding-3-small gibi bir gömme modeli.

• NoSQL hesabı için bir Azure Cosmos DB.

  • Bilgi bankanızı oluşturmadan önce Cosmos DB hesabınızda vektör aramasını etkinleştirin . Bu işlemin tamamlanması 15 dakika kadar sürebilir.

    Daha fazla bilgi için bakınız:

    • Quickstart: Azure portalını kullanarak NoSQL hesabı için bir Azure Cosmos DB oluşturun
    • NoSQL için Azure Cosmos DB'de vektör araması

• Standart mantıksal uygulama ve aracı iş akışı.

  Daha fazla bilgi için bakınız:

  • Azure Logic Apps'te insan etkileşimi olmadan özerk etmen iş akışları oluşturun
  • Azure Logic Apps'te sohbet etkileşimleriyle konuşmaya dayalı aracılı iş akışları oluşturma

Kimlik Doğrulaması

KBaaS özelliği, managed identity veya API anahtarıyla Microsoft Entra ID kullanarak kimlik doğrulamasını destekler. Mümkünse, en iyi ve üstün güvenlik için yönetilen kimlik ayarlayın ve kullanın . Kimlik bilgilerini, gizli dizileri veya erişim anahtarlarını el ile sağlamanız ve yönetmeniz gerekmez.

API anahtarı kullanıyorsanız, kimlik bilgileri, gizli diziler, erişim anahtarları, bağlantı dizeleri, sertifikalar, parmak izleri ve benzer bilgiler gibi hassas ve kişisel verileri kullanılabilir veya desteklenen en yüksek güvenlik düzeyiyle güvenli hale getirin ve koruyun. Microsoft Entra ID ve Azure Key Vault kullanarak bu tür bilgileri güvenli bir şekilde depolayın. Bu bilgileri sabit kodlamayın, diğer kullanıcılarla paylaşmayın veya başkalarının erişebileceği herhangi bir yerde düz metin olarak kaydetmeyin. Gizli bilgilerin güvenliği tehlikeye girdiğinde bunları döndürmek veya geçersiz kılmak için bir plan oluşturun.

Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:

• Azure Key Vault'ta sırların döndürülmesini otomatikleştir
• Gizlilikleri korumaya yönelik en iyi uygulamalar
• Azure Key Vault'taki gizli bilgiler

1: Bilgi bankası bağlantısını oluşturma

Bilgi tabanı bağlantısını oluşturmak için aşağıdaki adımları izleyerek Cosmos veritabanınızı ve Azure OpenAI kaynak modellerinizi ilişkilendirin:

1a: Cosmos veritabanı bağlantısını ayarlama

1. Azure portalında Standart mantıksal uygulama kaynağınızı açın.

2. Mantıksal uygulama kenar çubuğundaki Aracılar'ın altında Bilgi Bankası'nı seçin.

3. Bilgi bankası sayfasında Ayarla'yı seçin.

4. Kurulum bölmesindeki Temel Bilgiler sekmesinde aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Description
   Görüntü adı	Evet	Bilgi bankası bağlantınız için okunabilir bir ad. Alma eyleminin doğru bağlantıyı ilişkilendirebilmesi için oluşturmayı planladığınız bilgi bankasıyla aynı adı kullanın.
   Kimlik doğrulaması türü	Evet	Anahtar tabanlı veya Yönetilen Hizmet Kimliği
   Subscription	Evet	Azure aboneliğiniz.
   Veritabanı	Evet	Cosmos veritabanınız.
   URL uç noktası	Evet	Veritabanı seçiminiz bu değeri otomatik olarak doldurur.
   Anahtar	Evet	Yalnızca Anahtar tabanlı kimlik doğrulamayı seçerseniz kullanılabilir. Veritabanı seçiminiz bu değeri otomatik olarak doldurur.

5. Bitirdiğinizde İleri'yi seçin.

1b: Azure OpenAI kaynak bağlantısını ayarlama

1. Model sekmesinde aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Description
   Kimlik doğrulaması türü	Evet	URL ve anahtar tabanlı kimlik doğrulaması veya Yönetilen Hizmet Kimliği
   Subscription	Evet	Azure aboneliğiniz.
   Azure OpenAI kaynağı	Evet	Azure OpenAI kaynağınız.
   API uç noktası	Evet	Azure OpenAI kaynak seçiminiz bu değeri otomatik olarak doldurur.
   API anahtarı	Evet	Yalnızca URL'yi ve anahtar tabanlı kimlik doğrulamayı seçerseniz kullanılabilir. Azure OpenAI kaynak seçiminiz bu değeri otomatik olarak doldurur.
   Tamamlanma modeli	Evet	Azure OpenAI kaynağınız için dağıtımı yapılan tamamlama modelinin görünen adını girin.
   Eklemeler modeli	Evet	Azure OpenAI kaynağınızda dağıtılan embedding modelinin görünen adını girin.

2. bitirdiğinizde Oluştur'u seçin.

2: Bilgi öğeleri ekleyin

Bilgi bankası bağlantınızı oluşturduktan sonra, bilgi bankanızda bilgi yapıtları olarak kullanılacak kaynak bilgi dosyalarını ekleyin.

1. Azure portalında Standart mantıksal uygulama kaynağınızı açın.

2. Mantıksal uygulama kenar çubuğundaki Aracılar'ın altında Bilgi Bankası'nı seçin.

3. Dosya eklemeden önce bir grup oluşturmak istiyorsanız , Bilgi bankası sayfa araç çubuğunda Yeni yeni>grup oluştur'u seçin ve ardından istemleri izleyerek grubu oluşturun.

4. Bilgi bankası sayfasında Dosya ekle'yi seçin. Veya sayfa araç çubuğunda YeniDosya ekle'yi> seçin.

5. Dosya ekle bölmesinde aşağıdaki görevleri tamamlayın:

   1. Grup bölümünde aşağıdaki bilgileri girin:

      Parametre	Zorunlu	Description
      İsim	Evet	Bilgi bankanızdaki dosyaları düzenleyen grubun adı. Yeni bir ad girin veya var olan bir grubu seçin.
      Tanım	Hayır	Grup için isteğe bağlı bir açıklama.

   2. Dosya ekle bölümünde yüklemek için göz at seçin veya dosyaları grubunuza sürükleyip bırakın. Her dosya için aşağıdaki bilgileri girin:

      Parametre	Zorunlu	Value	Description
      İsim	Evet	< kaynak-adı>	Bilgi kaynağı olarak dosyanın adı; örneğin, HRPolicyDocument.
      Tanım	Hayır	< kaynak açıklaması>	Bilgi kaynağı olarak dosya için isteğe bağlı bir açıklama.

6. bitirdiğinizde Ekle'yi seçin.

   KBaaS aşağıdaki Cosmos DB kapsayıcılarını oluşturur:

   Container	Purpose
   KnowledgeHubs	Bilgi bankası meta verilerini depolar.
   KnowledgeArtifacts	Kaynak meta verileri ve kaynak belge başvurularını depolar.
   KnowledgeArtifactChunks	Tam metin belge öbeklerini depolar.
   KnowledgeArtifactChunkSummaries	Anlamsal arama için vektör eklemeleri ile özetlenmiş öbekleri depolar.

   KBaaS, karşıya yükleme ilerlemesini izlemek için bir işlem kimliği içeren 202 Accepted yanıtı döndürür.

   Karşıya yükleme işlemi sırasında KBaaS, vektörleştirilmiş içeriği Cosmos DB kapsayıcısında ayrıştırma, öbekleme, özetleme, ekleme ve depolama işlemleri gerçekleştirir. İşlem tamamlandığında, sonuç temelinde kaynak durumu Tamamlandı veya Başarısız olarak değişir.

7. Azure portalında veya işlem kimliğini kullanarak karşıya yükleme durumunu izleyin.

8. KBaaS işlemi tamamlandıktan sonra, bilgi bankasını aracı döngünüzün agentic Standard iş akışınızda kullanabileceği bir araç olarak ekleyebilmek için bir sonraki bölüme geçin.

3: Bilgi bankasını araç olarak ekleme

Artık aracı standart iş akışlarınızda araç olarak kullanmak için bilgi bankasını aracı döngünüze ekleyebilirsiniz. Ajan döngüleri, yüklediğiniz belgelerden anlamsal olarak ilgili bilgileri almak için bilgi tabanını otomatik olarak sorgular.

1. Bilgi bankanızı içeren aynı Standart mantıksal uygulamada tasarımcıda aracı iş akışınızı açın ve istediğiniz aracı döngüsünü seçin.

2. Aracı bilgileri bölmesindeki Bilgi bankası bölümünde Oluştur'u seçin.

3. Bağlantı Oluştur bölmesindeki Kaynaklar listesinden bilgi bankasını seçin.

4. Bilgi tabanınıza daha fazla dosya yüklemek için + Yükle seçeneğini belirleyin.

Bilgi bankalarını ve kaynakları yönetme

Bilgi bankalarını veya kaynakları listelemek, görüntülemek ve silmek için Azure portalını veya REST API'sini kullanın.

Tüm bilgi bankalarını listeleme

1. Azure portalında Standart mantıksal uygulama kaynağınızı açın.

2. Mantıksal uygulama kenar çubuğundaki Aracılar'ın altında Bilgi Bankası'nı seçin.

Alternatif olarak aşağıdaki REST API çağrısını da yapabilirsiniz:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs

Belirli bir bilgi bankasını görüntüleme

Azure portalında, Knowledge base sayfasından bilgi bankası adını seçin.

Alternatif olarak aşağıdaki REST API çağrısını da yapabilirsiniz:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

Yanıt bilgi bankası bilgilerini, ilişkili kaynakları içeren bir listeyi ve bunların karşıya yükleme durumunu içerir.

Bilgi bankasındaki kaynakları listeleme

Azure portalında, kaynaklarını görüntülemek için bilgi bankasını seçin.

Alternatif olarak aşağıdaki REST API çağrısını da yapabilirsiniz:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts

Bilgi kaynağını silme

Bu işlem Cosmos DB'den kaynak meta verileri, tam metin öbeklerini ve vektör eklemelerini kaldırır. Hizmet, silme işleminin ilerleme durumunu izlemek için işlem kimliğine sahip 202 Kabul Edildi yanıtı döndürür.

1. Azure portalında, kaynaklarını görüntülemek için bilgi bankasını seçin.

2. Kaynağı seçin. Araç çubuğunda Sil'i seçin.

Alternatif olarak aşağıdaki REST API çağrısını da yapabilirsiniz:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts/{artifactName}

Bilgi bankasını silme

Bu işlem Cosmos DB'den bilgi bankasını ve ilişkili kaynakları, öbekleri ve özetleri kaldırır.

1. Azure portalında bilgi bankasını seçin.

2. Araç çubuğunda Sil'i seçin.

Alternatif olarak aşağıdaki REST API çağrısını da yapabilirsiniz:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

İlgili içerik

• Azure Logic Apps nedir?
• Azure OpenAI Hizmeti
• Azure Cosmos DB Vektör Arama
• Tümleşik vektör deposu - NoSQL için Azure Cosmos DB