Azure Logic Apps'teki iş akışlarından Azure AI hizmetlerine bağlanma
Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)
Kurumsal hizmetleri, sistemleri ve verileri yapay zeka teknolojileriyle tümleştirmek için mantıksal uygulama iş akışlarınız, bu tümleştirme senaryolarında kullandığınız Azure OpenAI ve Azure AI Search kaynaklarına bağlanabilir.
Bu kılavuz, iş akışınızda Azure OpenAI ve Azure AI Search bağlayıcısı işlemlerinin nasıl kullanılacağını gösteren bir genel bakış ve örnekler sağlar.
Azure Logic Apps'i neden yapay zeka hizmetleriyle kullanmalısınız?
Yapay zeka çözümleri oluşturmak için genellikle birkaç temel adım gerekir ve birkaç yapı taşları gerekir. Öncelikle dinamik bir alım işlem hattına ve büyük dil modelleri (LLM'ler) ve vektör veritabanlarıyla iletişim kurabilen bir sohbet arabirimine sahip olmanız gerekir.
İpucu
Daha fazla bilgi edinmek için Azure Copilot'a şu soruları sorabilirsiniz:
- Yapay zekada dinamik alım işlem hattı nedir?
- Yapay zekada vektör veritabanı nedir?
Azure Copilot'u bulmak için Azure portalı araç çubuğunda Copilot'u seçin.
Yalnızca veri alımı gerçekleştirmek için değil, aynı zamanda sohbet arabirimi için sağlam bir arka uç sağlamak için çeşitli bileşenleri bir araya getirebilirsiniz. Bu arka uç istem girmeyi kolaylaştırır ve etkileşimler sırasında güvenilir yanıtlar oluşturur. Ancak, tüm bu öğeleri yönetmek ve denetlemek için kod oluşturmak, çoğu çözüm için de geçerli olan zorluklara neden olabilir.
Azure Logic Apps düşük kod yaklaşımı sunar ve arka uç sürecini kolaylaştırmak için yapı taşları olarak kullandığınız önceden oluşturulmuş bağlayıcılar sağlayarak arka uç yönetimini basitleştirir. Bu yaklaşım, verilerinizin kaynağını belirlemeye ve arama sonuçlarının geçerli ve ilgili bilgiler sağladığını sağlamaya odaklanmanızı sağlar. Bu yapay zeka bağlayıcılarıyla iş akışınız, yapay zeka hizmetleriyle tümleştirmek istediğiniz diğer bileşenler arasında veri aktaran bir düzenleme altyapısı işlevi görür.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
Önkoşullar
Bir Azure hesabı ve aboneliği Azure aboneliğiniz yoksa ücretsiz bir Azure hesabı için kaydolun.
Bağlantı bilgileri de dahil olmak üzere iş akışınızda erişilip kullanılacak Azure AI Search ve Azure OpenAI kaynakları:
Azure OpenAI ve Azure AI Search kaynaklarınıza erişmek istediğiniz mantıksal uygulama iş akışı.
Bu hizmetlerin bağlayıcıları şu anda tetikleyicileri değil yalnızca eylemleri sağlar. Azure AI bağlayıcısı eylemi ekleyebilmeniz için önce iş akışınızın senaryonuz için uygun tetikleyiciyle başladığından emin olun.
Bağlayıcı teknik başvurusu
Tüketim iş akışlarında Azure OpenAI ve Azure AI Search tarafından yönetilen veya "paylaşılan" bağlayıcılar şu anda önizleme aşamasındadır ve Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'na tabidir.
Azure OpenAI
Azure OpenAI Hizmeti, OpenAI'nin GPT-4, GPT-4 Turbo with Vision, GPT-3.5-Turbo ve Embeddings model serisi gibi dil modellerine erişim sağlar. Azure OpenAI bağlayıcısı ile iş akışınız Azure OpenAI Hizmeti'ne bağlanabilir ve verileriniz için OpenAI eklemeleri alabilir veya sohbet tamamlamaları oluşturabilir.
İpucu
Daha fazla bilgi edinmek için Azure Copilot'a şu soruları sorabilirsiniz:
- Yapay zekaya ekleme nedir?
- Yapay zekada sohbet tamamlama nedir?
Azure Copilot'u bulmak için Azure portalı araç çubuğunda Copilot'u seçin.
Azure OpenAI bağlayıcısının mantıksal uygulama türüne ve barındırma modeline göre farklı sürümleri vardır:
| Mantıksal uygulama | Ortam | Bağlayıcı sürümü |
|---|---|---|
| Tüketim | Çok Kiracılı Azure Logic Apps | Yönetilen, Azure tarafından barındırılan bağlayıcı, Çalışma Zamanı>Paylaşılan altındaki bağlayıcı galerisinde görünür. Daha fazla bilgi için bkz . Azure OpenAI yönetilen bağlayıcı başvurusu. |
| Standart | Tek kiracılı Azure Logic Apps, App Service Ortamı v3 (yalnızca Windows planları) veya kendi altyapınız olan karma dağıtım. | Yerleşik bağlayıcı, bağlayıcı galerisinde Uygulama İçi Çalışma Zamanı>altında görünür ve hizmet sağlayıcısı tabanlıdır. Yerleşik bağlayıcı, diğerleri arasında aşağıdaki özelliklere sahiptir: - Birden çok kimlik doğrulama türü desteği - Güvenlik duvarlarının arkasındaki Azure OpenAI için Azure sanal ağlarındaki kaynaklara ve uç noktalara doğrudan erişim. Daha fazla bilgi için bkz . Azure OpenAI yerleşik bağlayıcı başvurusu. |
Azure Yapay Zeka Arama
Azure AI Search, geliştiricilerin büyük dil modellerini kurumsal verilerle birleştirerek zengin arama deneyimleri ve üretken yapay zeka uygulamaları oluşturmalarına yardımcı olan yapay zeka destekli bilgi alma platformudur. Azure AI Search bağlayıcısı ile iş akışınız, belgeleri dizine almak ve verileriniz üzerinde vektör aramaları yapmak için Azure AI Search'e bağlanabilir.
Azure AI Search bağlayıcısının mantıksal uygulama türüne ve barındırma modeline göre farklı sürümleri vardır:
| Mantıksal uygulama | Ortam | Bağlayıcı sürümü |
|---|---|---|
| Tüketim | Çok Kiracılı Azure Logic Apps | Yönetilen, Azure tarafından barındırılan bağlayıcı, Çalışma Zamanı>Paylaşılan altındaki bağlayıcı galerisinde görünür. Daha fazla bilgi için bkz . Azure AI Search yönetilen bağlayıcı başvurusu. |
| Standart | Tek kiracılı Azure Logic Apps, App Service Ortamı v3 (yalnızca Windows planları) veya kendi altyapınız olan karma dağıtım. | Yerleşik bağlayıcı, bağlayıcı galerisinde Uygulama İçi Çalışma Zamanı>altında görünür ve hizmet sağlayıcısı tabanlıdır. Yerleşik bağlayıcı, diğerleri arasında aşağıdaki özelliklere sahiptir: - Birden çok kimlik doğrulama türü desteği - Güvenlik duvarlarının arkasındaki Azure OpenAI için Azure sanal ağlarındaki kaynaklara ve uç noktalara doğrudan erişim. Daha fazla bilgi için bkz . Azure AI Search yerleşik bağlayıcı başvurusu. |
Kimlik Doğrulaması
Yapay zeka ile yönetilen bağlayıcılar, kimlik doğrulaması için bir API anahtarı gerektirir. Ancak yapay zeka yerleşik bağlayıcıları, yapay zeka hizmet uç noktanız için birden çok kimlik doğrulama türünü destekler. Bu seçenekler çoğu müşterinin gereksinimlerini karşılayan güçlü kimlik doğrulaması sağlar. Her iki yerleşik bağlayıcı da sanal ağlar içindeki veya güvenlik duvarlarının arkasındaki Azure OpenAI ve Azure AI Search kaynaklarına doğrudan bağlanabilir.
Aşağıdaki tabloda, yapay zeka hizmet uç noktasının URL'sini sağlamanız gereken yerleşik bağlayıcı kimlik doğrulama seçenekleri açıklanmaktadır:
| Authentication type | Açıklama |
|---|---|
| URL ve anahtar tabanlı kimlik doğrulaması | Yapay zeka hizmeti tarafından oluşturulan API anahtarını veya yöneticiyi sağlayın. |
| Active Directory OAuth (Microsoft Entra Id) | Entra kullanıcısı olarak kimlik doğrulaması yapmak için Entra kiracınız, istemci kimliğiniz ve parolanız gibi bilgileri sağlayın. |
| Yönetilen kimlik | Yapay zeka hizmeti kaynağınızda ve mantıksal uygulama kaynağınızda yönetilen kimlik kimlik doğrulamasını ayarladıktan sonra, bağlayıcıya erişimin kimliğini doğrulamak için bu kimliği kullanabilirsiniz. |
Önemli
En iyi güvenlik için, mümkün olduğunda kimlik doğrulaması için yönetilen kimliklerle Microsoft Entra Id kullanın. Bu yöntem, kimlik bilgileri sağlamak zorunda kalmadan üstün güvenlik sağlar. Azure bu kimliği yönetir ve bu hassas bilgileri kendiniz yönetmek zorunda kalmamak için kimlik doğrulama bilgilerinin güvenli kalmasına yardımcı olur. Azure Logic Apps için yönetilen kimlik ayarlamak için bkz . Azure Logic Apps'te yönetilen kimliklerle Azure kaynaklarına erişim ve bağlantıların kimliğini doğrulama.
Farklı bir kimlik doğrulama türü kullanmanız gerekiyorsa, kullanılabilir bir sonraki en üst düzey güvenlik seçeneğini kullanın. Örneğin, bunun yerine bir bağlantı dizesi kullanarak bağlantı oluşturmanız gerekdiğini varsayalım. bağlantı dizesi, uygulamanızın belirli bir kaynağa, hizmete veya sisteme erişmesi için gereken yetkilendirme bilgilerini içerir. bağlantı dizesi erişim anahtarı, kök parolaya benzer.
Üretim ortamlarında kimlik bilgileri, sertifikalar, parmak izleri, erişim anahtarları ve bağlantı dizesi gibi hassas bilgileri ve gizli dizileri her zaman koruyun. Microsoft Entra Id ve Azure Key Vault kullanarak bu tür bilgileri güvenli bir şekilde depoladığınızdan emin olun. Bu bilgileri sabit kodlamaktan, diğer kullanıcılarla paylaşmaktan veya başkalarının erişebileceği herhangi bir yerde düz metin kaydetmekten kaçının. Bu bilgilerin gizliliğinin tehlikeye girmiş olabileceğini düşünüyorsanız gizli dizilerinizi en kısa sürede döndürün. Daha fazla bilgi için bkz . Azure Key Vault hakkında.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
- Azure AI hizmetlerine yönelik isteklerin kimliğini doğrulama
- Microsoft Entra ID nedir?
- Azure kaynakları için yönetilen kimlikler nelerdir?
- Azure Logic Apps'te yönetilen kimliklerle Azure kaynaklarına erişim ve bağlantı kimliğini doğrulama
İş akışınıza Azure OpenAI veya Azure AI Search eylemi ekleme
Şu anda Azure OpenAI ve Azure AI Search bağlayıcıları tetikleyicileri değil yalnızca eylemleri sağlar. senaryonuza veya gereksinimlerinize uyan herhangi bir tetikleyiciyle iş akışınızı başlatabilirsiniz. Tüketim veya Standart iş akışına bağlı olarak , Azure OpenAI, Azure AI Search ve diğer işlemler için eylemler eklemek için bu genel adımları izleyebilirsiniz.
Senaryolar
Aşağıdaki senaryolarda, iş akışlarınızda yapay zeka bağlayıcısı işlemlerini kullanmanın birçok yolunun yalnızca ikisi açıklanmaktadır:
Kurumsal verileriniz için bilgi bankası oluşturma
Azure Logic Apps, SharePoint, Oracle DB, Salesforce, OneDrive, Dropbox, SAP, IBM gibi neredeyse tüm veri kaynaklarına güvenli bir şekilde bağlanmak üzere iş akışınız için 1.400'den fazla Microsoft tarafından yönetilen bağlayıcı ve yerel olarak çalışan yerleşik bağlayıcılar sağlar. Her bağlayıcı, iş akışınızda kullanmanız için tetikleyiciler, eylemler veya her ikisini de içeren işlemler sağlar.
Örneğin, otomatik iş akışınızın bir zamanlamaya göre veya yeni belgelerin sharePoint sitesine yüklenmesi gibi belirli olaylara göre çalıştırılmasını sağlamak için birçok tetikleyici türü arasından seçim yapabilirsiniz. Seçebileceğiniz bu kadar çok işlemle, Azure AI Search'te bu belgeler için vektör eklemeleri kullanarak bir bilgi bankası oluşturabilir ve kolayca belge alımı işlem hattı oluşturabilirsiniz.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
Tamamlamaları oluşturma
Azure Logic Apps iş akışı girişi kabul ederken, Azure OpenAI Hizmeti tamamlama işlemlerini gerçekleştirebilir. Bu özellikler, iş akışınızın gerçek zamanlı soruları alabildiği, verilerinizle ilgili yanıtlar oluşturabileceği veya Azure OpenAI kullanarak otomatik yanıtlar gönderebileceği anlamına gelir. Yanıtları hemen istemciye veya doğrulama için bir onay iş akışına gönderebilirsiniz.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
Örnek kod içeren örnek senaryo: Verileri alma ve sohbet etkileşimleri oluşturma
Bu Standart iş akışı örneği, verileri alma ve basit sohbet konuşmalarını iki önemli iş akışında yürütmeye yönelik arka uç mantığını bölmek için Azure OpenAI ve Azure AI Search yerleşik bağlayıcılarının nasıl kullanılacağını gösterir. Daha hızlı performans için, varsayılan olarak her çalıştırmanın geçmişini kaydetmeyen ve depolamayen durum bilgisi olmayan iş akışları oluşturun.
Örnek kod
Alınan verileri kullanarak sohbet oluşturma
Diğer önkoşullar
Standart mantıksal uygulama iş akışı
Örnek kod gereksinimlerine bakın.
Aşağıdaki ortamlar arası parametre değerleri , bu örnekteki iş akışı işlemleri tarafından da kullanılır:
Parametre adı Açıklama aisearch_admin_key Azure AI Search için yönetici anahtarı aisearch_endpoint Azure AI Search örneği için uç nokta URL'si aisearch_index_name Azure AI Arama örneği için kullanılacak dizin openapi_api_key Azure OpenAI için API anahtarı openai_deployment_id Azure OpenAI örneğinin dağıtım kimliği openai_endpoint Azure OpenAI örneği için uç nokta URL'si tokenize_function_url Verileri toplu hale getiren ve belirteç haline getiren özel bir Azure işlevinin URL'si. Bu örnekte Azure OpenAI'nin eklemeleri düzgün bir şekilde oluşturması gerekir.
Bu işlev hakkında daha fazla bilgi için "Alınan verileri kullanarak sohbet oluşturma" için örnek koda bakın.
Video: Mantıksal uygulamaları kullanarak yapay zeka uygulamaları oluşturmayı öğrenin
Mantıksal uygulamaları kullanarak yapay zeka uygulamaları oluşturmayı öğrenin
Veri alma iş akışı
Alım işlem hattı oluştururken önemli ölçüde zaman ve çaba kazanmak için herhangi bir veri kaynağıyla aşağıdaki deseni uygulayın. Bu desen, şu anda tek kiracılı Azure Logic Apps'te Standart iş akışları tarafından sunulan tüm avantajları ve avantajları kapsar.
Bu düzendeki her adım, yapay zekanın veri dosyalarınızdaki tüm önemli bilgileri sorunsuz bir şekilde ayıklamasını sağlar. Durum bilgisi olmayan bir iş akışı olarak çalıştırılırsa, bu desen daha hızlı performans da sağlar. Bu yaklaşım yalnızca kodlama yönünü basitleştirir, aynı zamanda iş akışlarınızın etkin kimlik doğrulaması, izleme ve dağıtım süreçlerine sahip olduğunu garanti eder.
| Adımlar | Görev | Temel alınan işlem | Açıklama |
|---|---|---|---|
| 1 | Yeni verileri denetleyin. | HTTP isteği alındığında | Zamanlanmış bir yinelenme temelinde veya sırasıyla belirli olaylara yanıt olarak yeni verilerin gelmesini yoklayan veya bekleyen bir tetikleyici. Böyle bir olay, SharePoint, OneDrive veya Azure Blob Depolama gibi belirli bir depolama sistemine yüklenen yeni bir dosya olabilir. Bu örnekte İstek tetikleyicisi işlemi, başka bir uç noktadan gönderilen bir HTTP veya HTTPS isteğini bekler. İstek, karşıya yüklenen yeni bir belgenin URL'sini içerir. |
| 2 | Verileri alın. | HTTP | Tetikleyici çıkışından dosya URL'sini kullanarak karşıya yüklenen belgeyi alan bir HTTP eylemi. |
| 3 | Belge ayrıntılarını oluşturma. | Compose |
Çeşitli öğeleri birleştirir veri işlemleri eylemi. Bu örnek, belgeyle ilgili anahtar-değer bilgilerini birleştirir. |
| 4 | Belirteç dizesi oluşturun. | Belgeyi ayrıştırma | Oluştur eyleminin çıkışını kullanarak bir belirteç dizesi oluşturan Veri İşlemleri eylemi. |
| 5 | İçerik öbekleri oluşturun. | Öbek metni | İçerik öbekleri başına karakter veya belirteç sayısına göre belirteç dizesini parçalara ayıran Veri İşlemleri eylemi. |
| 6 | Belirteçli verileri JSON'a dönüştürün. | JSON Ayrıştırma | Belirteç dizesi öbeklerini bir JSON dizisine dönüştüren Veri İşlemleri eylemi. |
| 7 | JSON dizi öğeleri'ne tıklayın. | Seç | JSON dizisinden birden çok öğe seçen Veri İşlemleri eylemi. |
| 8 | Eklemeleri oluşturun. | Birden çok ekleme alma | Her JSON dizi öğesi için eklemeler oluşturan bir Azure OpenAI eylemi. |
| 9 | Eklemeleri ve diğer bilgileri seçin. | Seç | Eklemeleri ve diğer belge bilgilerini seçen Veri İşlemleri eylemi. |
| 10 | Verilerin dizinini oluşturun. | Belgeleri dizine oluşturma | Seçilen her eklemeye göre verilerin dizinini oluşturan bir Azure AI Arama eylemi. |
Sohbet iş akışı
Vektör veritabanlarınız verileri almaya devam ederken, kullanıcı soru sorduğunda arka uç Standart mantıksal uygulama iş akışının istemi işleyip güvenilir bir yanıt oluşturabilmesi için verilerin kolayca aranabilir olduğundan emin olun.
Aşağıdaki desen, sohbet iş akışının nasıl görünebileceğini gösteren yalnızca bir örnektir:
| Adımlar | Görev | Temel alınan işlem | Açıklama |
|---|---|---|---|
| 1 | Giriş istemini bekleyin. | HTTP isteği alındığında | Zamanlanmış bir yinelenme temelinde veya sırasıyla belirli olaylara yanıt olarak yeni verilerin gelmesini yoklayan veya bekleyen bir tetikleyici. Bu örnekte İstek tetikleyicisi müşterinin sorusunu bekler ve yakalar. |
| 2 | Model için giriş sistemi iletisi. | Compose | Modeli eğitmek için giriş sağlayan Veri İşlemleri eylemi. |
| 3 | Örnek sorular ve yanıtlar girin. | Compose | Modeli eğitmek için örnek müşteri soruları ve ilişkili roller sağlayan Veri İşlemleri eylemi. |
| 4 | Arama sorgusu için giriş sistemi iletisi. | Compose | Modeli eğitmek için arama sorgusu girişi sağlayan Veri İşlemleri eylemi. |
| 5 | Arama sorgusu oluşturma. | JavaScript Kodu Yürütme | Önceki Oluşturma eylemlerinin çıkışlarını temel alarak vektör deposu için bir arama sorgusu oluşturmak üzere JavaScript kullanan Satır içi Kod eylemi. |
| 6 | Sorguyu eklemeye dönüştürün. | Sohbet tamamlamalarını alma | Sohbet tamamlama API'sine bağlanan ve sohbet konuşmalarında güvenilir yanıtlar sağlayan bir Azure OpenAI eylemi. Bu örnekte eylem, arama sorgularını ve rollerini modele giriş olarak kabul eder ve vektör eklemelerini çıkış olarak döndürür. |
| 7 | Ekleme alın. | Ekleme alma | Tek bir vektör ekleme işlemi alan bir Azure OpenAI eylemi. |
| 8 | Vektör veritabanında arama yapın. | Arama vektörleri | Vektör deposunda arama yürüten bir Azure AI Arama eylemi. |
| 9 | İstem oluşturun. | JavaScript Kodu Yürütme | Komut istemleri oluşturmak için JavaScript kullanan Satır içi Kod eylemi. |
| 10 | Sohbet tamamlama işlemini gerçekleştirin. | Sohbet tamamlamalarını alma | Sohbet tamamlama API'sine bağlanan ve sohbet konuşmalarında güvenilir yanıtlar sağlayan bir Azure OpenAI eylemi. Bu örnekte eylem, istemleri ve rolleri modele giriş olarak kabul eder ve model tarafından oluşturulan yanıtları çıkış olarak döndürür. |
| 11 | Yanıt döndür. | Response | İstek tetikleyicisini kullandığınızda sonuçları çağırana döndüren bir İstek eylemi. |