Öğretici: Bölüm 1 - İstem akışı SDK'sı ile özel sohbet uygulaması oluşturmak için kaynaklar oluşturma

Bu öğreticide, perakende şirketiniz için Contoso Trek adlı bir sohbet uygulaması oluşturmak, yapılandırmak, değerlendirmek ve dağıtmak için istem akışı SDK'sını (ve diğer kitaplıkları) kullanacaksınız. Perakende şirketiniz açık hava kamp malzemeleri ve giyim konusunda uzmanlaşmıştır. Sohbet uygulaması, ürünleriniz ve hizmetleriniz hakkındaki soruları yanıtlamalıdır. Örneğin, sohbet uygulaması "hangi çadır en su geçirmez?" veya "soğuk hava için en iyi uyku tulumu hangisidir?" gibi soruları yanıtlayabilir.

Bu öğretici, üç bölümden oluşan bir öğreticinin birinci bölümüdür. Birinci bölümde, bir Azure aboneliğinin yöneticisinin öğretici serisinin ikinci ve üçüncü bölümleri için gereken kaynakları nasıl oluşturup yapılandırduğu gösterilir. İkinci ve üç kısım, bir geliştiricinin kaynakları nasıl kullandığını gösterir. Birçok kuruluşta aynı kişi bu rollerin ikisini de üstlenebilir. Birinci bölümde şunların nasıl yapılacağını öğreneceksiniz:

Diğer öğreticileri veya hızlı başlangıçları tamamladıysanız, bu öğretici için gereken kaynaklardan bazılarını zaten oluşturmuş olabilirsiniz. Varsa, bu adımları burada atlayabilirsiniz.

Bu öğretici, üç bölümden oluşan bir öğreticinin birinci bölümüdür.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz bir hesap oluşturun.

Azure AI Studio ve Azure portalı

Bu öğreticide, sohbet uygulamasını oluşturmak için Azure kaynaklarını kullanacaksınız. Bu kaynakları oluşturmak ve yapılandırmak için hem Azure AI Studio'yu hem de Azure portalını kullanacaksınız.

• Yönetici olarak, kaynaklara erişimi yapılandırmak için Azure portalını kullanırsınız.
• Geliştirici olarak, sohbet uygulamasını derlemek, değerlendirmek ve dağıtmak için gereken kaynakları gruplandırmak için Azure AI Studio'yu kullanırsınız. Ayrıca AI Studio'da modellerinizle ve dağıtımlarınızla etkileşim kurabilirsiniz.

Azure AI Studio hub'ı oluşturma

Azure AI Studio'da hub oluşturmak için şu adımları izleyin:

1. Azure AI Studio'da Giriş sayfasına gidin ve Azure hesabınızla oturum açın.

2. Sol bölmede Tüm kaynaklar'ı seçin. Bu seçeneği göremiyorsanız, üst çubukta Tüm kaynaklar ve projeler'i seçin. Ardından + Yeni hub'ı seçin.

   

3. Yeni hub oluştur iletişim kutusunda hub'ınız için bir ad girin (contoso-hub gibi). Kaynak grubunuz yoksa, sağlanan Aboneliğe bağlı olarak yeni bir Kaynak grubu oluşturulur. Varsayılan Azure AI Hizmetlerine Bağlan seçeneğini seçili bırakın.

4. İleri'yi seçin. Mevcut bir kaynak grubunu yeniden kullanmadıysanız, yeni bir kaynak grubu (rg-contoso) oluşturulur. Ayrıca hub için bir Azure AI hizmeti (ai-contoso-hub) oluşturulur.

   

   Not

   Kaynak grubu ve Connect Azure AI Services girişlerinden önce (yeni) öğesini görmüyorsanız mevcut bir kaynak kullanılıyor demektir. Bu öğreticinin amaçları doğrultusunda Yeni kaynak grubu oluştur ve Yeni yapay zeka hizmetleri oluştur aracılığıyla ayrı bir varlık oluşturun. Bu, öğreticiden sonra varlıkları silerek beklenmeyen ücretleri önlemenize olanak sağlar.

5. Bilgileri gözden geçirin ve Oluştur'u seçin.

   

6. Hub oluşturma işleminin ilerleme durumunu sihirbazda görüntüleyebilirsiniz.

   

Bir proje oluştur

Azure AI Studio'da proje oluşturmak için şu adımları izleyin:

1. Azure AI Studio'nun Giriş sayfasına gidin.
2. + Yeni proje'yi seçin.
3. Proje için bir ad girin.
4. Önceki adımda oluşturduğunuz hub'ı seçin.

Proje oluşturulduktan sonra sol gezinti panelinde oyun alanı, araçlar ve diğer varlıklara erişebilirsiniz.

Azure AI Search dizini oluşturma

Bu uygulamanın amacı, özel verilerinizdeki model yanıtlarını temel almaktır. Arama dizini, kullanıcının sorusuna göre ilgili belgeleri almak için kullanılır.

Arama dizini oluşturmak için bir Azure AI Arama hizmeti ve bağlantısına ihtiyacınız vardır.

Azure AI Arama hizmeti oluşturma

Azure AI Arama hizmeti zaten varsa sonraki bölüme geçebilirsiniz.

Aksi takdirde, Azure portalını kullanarak bir Azure yapay zeka Arama hizmeti oluşturabilirsiniz.

1. Azure portalında bir Azure yapay zeka Arama hizmeti oluşturun.
2. Kaynak grubunuzu ve örnek ayrıntılarınızı seçin. Fiyatlandırma ve fiyatlandırma katmanları hakkındaki ayrıntıları bu sayfada görebilirsiniz.
3. Sihirbaz aracılığıyla devam edin ve gözden geçir + ata'yı seçerek kaynağı oluşturun.
4. Tahmini maliyet de dahil olmak üzere Azure yapay zeka Arama hizmeti ayrıntılarını onaylayın.
5. Azure AI Arama hizmeti oluşturmak için Oluştur'u seçin.

Azure AI Arama'yı projenize bağlama

Projenizde zaten bir Azure AI Search bağlantınız varsa Azure AI Arama hizmeti için erişimi yapılandırmaya atlayabilirsiniz.

Azure AI Studio'da Azure AI Search bağlı kaynağını denetleyin.

1. AI Studio'da projenize gidin ve sol bölmeden Ayarlar'ı seçin.
2. Bağlı kaynaklar bölümünde Azure AI Search türünde bir bağlantınız olup olmadığını denetleyin.
3. Azure AI Search bağlantınız varsa, kaynaklara erişimi yapılandırmak için atlayabilirsiniz.
4. Aksi takdirde Yeni bağlantı'yı ve ardından Azure AI Arama'yı seçin.
5. Seçeneklerde Azure AI Arama hizmeti bulun ve Bağlantı ekle'yi seçin.
6. Bağlantıyı oluşturmak için sihirbaz aracılığıyla devam edin. Bağlantı ekleme hakkında daha fazla bilgi için bu nasıl yapılır kılavuzuna bakın.

Kaynaklar için erişimi yapılandırma

Bu bölümde, önceki bölümlerde oluşturduğunuz kaynaklar için gereken çeşitli erişim denetimlerini yapılandırma adımları gösterilmektedir.

API anahtarlarını kullanmak yerine Microsoft Entra Id kullanmanızı öneririz. Bu kimlik doğrulamasını kullanmak için doğru erişim denetimlerini ayarlamanız ve hizmetleriniz için doğru rolleri atamanız gerekir.

Azure AI Hizmetleri için erişimi yapılandırma

AI Services kaynağını bulmak için projeye başlayın:

1. AI Studio'da projenize gidin ve sol bölmeden Ayarlar'ı seçin.
2. Bağlı kaynaklar'ı seçin.
3. Kaynak ayrıntıları sayfasını açmak için bağlı kaynaklar listesindeN AI Hizmetleri'ni veya Azure OpenAI adını seçin. Ardından, Kaynağı Azure portalında açan Bağlantı Ayrıntıları sayfasında kaynak adını yeniden seçin.

Azure portalında erişim denetimini belirtin:

1. Azure portalının sol sayfasında Erişim denetimi (IAM)>+ Rol ataması ekle'yi>seçin.
2. Bilişsel Hizmetler OpenAI Kullanıcısı rolünü arayın ve seçin. Sonra İleri'yi seçin.
3. Kullanıcı, grup veya hizmet sorumlusu'nun seçin. Ardından Üye seç'i seçin.
4. Açılan Üye seç bölmesinde rol atamasını eklemek istediğiniz kullanıcının adını arayın. Kullanıcıyı ve ardından Seç'i seçin.
5. Sihirbaz aracılığıyla devam edin ve rol atamasını eklemek için Gözden Geçir + ata'yı seçin.

Azure AI Search için erişimi yapılandırma

Şimdi AI Studio Ayarları>Bağlı Kaynaklar'a geri dönün. Bu kez bağlı kaynaklar listesinden Azure AI Arama adını seçerek kaynak ayrıntıları sayfasını açın. Ardından, Kaynağı Azure portalında açan Bağlantı Ayrıntıları sayfasında kaynak adını yeniden seçin.

Azure AI Arama hizmeti rol tabanlı erişim denetimini etkinleştirmek için şu adımları izleyin:

1. Azure portalındaki Azure AI Arama hizmeti sol bölmeden Ayarlar > Anahtarları'nı seçin.

2. Hem API anahtarlarının hem de rol tabanlı erişim denetiminin Azure AI Arama hizmeti için etkinleştirildiğinden emin olmak için Her İkisi'ni seçin.

   

Ardından kullanıcı kimliğinize (veya ikinci ve üçüncü bölümleri tamamlayacak geliştiricinin kimliğine) Azure AI Arama hizmeti'nde Arama Dizini Veri Katkıda Bulunanı ve Arama Hizmeti Katkıda Bulunanı rollerini verin. Bu roller, ilişkili kullanıcı kimliği Arama hizmeti Azure yapay zekasını çağırmanızı sağlar.

Hala Azure yapay zeka Arama hizmeti için Azure portalında, Arama Dizini Verilerine Katkıda Bulunan rolünü Azure yapay zeka Arama hizmeti atayın. (Bunlar daha önce Azure OpenAI hizmeti için uyguladığınız adımlarla aynıdır.)

1. Azure portalının sol sayfasında Erişim denetimi (IAM)>+ Rol ataması ekle'yi>seçin.
2. Arama Dizini Veri Katkıda Bulunanı rolünü arayın ve seçin. Sonra İleri'yi seçin.
3. Kullanıcı, grup veya hizmet sorumlusu'nun seçin. Ardından Üye seç'i seçin.
4. Açılan Üye seç bölmesinde rol atamasını eklemek istediğiniz kullanıcının adını arayın. Kullanıcıyı ve ardından Seç'i seçin.
5. Sihirbaz aracılığıyla devam edin ve rol atamasını eklemek için Gözden Geçir + ata'yı seçin.

Arama Hizmeti Katkıda Bulunanı rolünü Azure AI Arama hizmeti eklemek için bu adımları yineleyin.

Artık sohbet uygulamasını oluşturmak için projeyi bir geliştiriciye teslim etmeye hazırsınız. Geliştirici, Contoso Trek adlı perakende şirketiniz için sohbet uygulamasını oluşturmak, yapılandırmak, değerlendirmek ve dağıtmak için istem akışı SDK'sını kullanır.

Kaynakları temizleme

Gereksiz Azure maliyetlerine maruz kalmamak için, artık gerekli değilse bu öğreticide oluşturduğunuz kaynakları silmeniz gerekir. Kaynakları yönetmek için Azure portalını kullanabilirsiniz.

Ancak bu öğretici serisinin sonraki bölümünde bir sohbet uygulaması oluşturmak istiyorsanız bunları henüz silmeyin.

Sonraki adım