Gemini Enterprise yapay zeka temsilcisiyle Google Chat uygulaması oluşturma

Bu sayfada, Google Chat'te çalışan ve Gemini Enterprise yapay zeka ajanıyla arayüz oluşturan bir Google Workspace eklentisinin nasıl oluşturulacağı açıklanmaktadır.

Not: Google Chat'te eklentiler, kullanıcılara Google Chat uygulamaları olarak gösterilir. Chat uygulamanızı Google Chat API etkileşim etkinliklerini kullanarak da oluşturabilirsiniz. Daha fazla bilgi edinmek için Google Chat'i genişletmeye genel bakış başlıklı makaleyi inceleyin.

Yapay zeka ajanları, tanımlanmış bir hedefe ulaşmak için çevrelerini bağımsız olarak algılar, akıl yürütür ve karmaşık, çok adımlı işlemleri gerçekleştirir. Bu eğiticide, kurumsal kullanıcıların yenilik yapmasına ve sorun çözmesine yardımcı olmak için Google tarafından varsayılan olarak sağlanan Fikir Üretme aracını kullanacaksınız.

Aşağıdaki şemada mimari ve mesajlaşma modeli gösterilmektedir:

Yukarıdaki şemada, Gemini Enterprise yapay zeka aracısı ile uygulanan bir sohbet uygulamasıyla etkileşimde bulunan kullanıcının bilgi akışı şu şekildedir:

1. Bir kullanıcı, bir Chat uygulamasına doğrudan mesaj yoluyla ya da bir Chat alanında mesaj gönderir.
2. Apps Script'te veya HTTP uç noktaları olan bir web sunucusu olarak uygulanan Chat uygulaması mantığı, mesajı alır ve işler.
3. Gemini Enterprise yapay zeka ajanı, etkileşimi alır ve işler.
4. İsteğe bağlı olarak, Chat uygulaması veya yapay zeka aracısı; Takvim ya da E-Tablolar gibi Google Workspace hizmetleriyle veya Google Haritalar ya da YouTube gibi diğer Google hizmetleriyle entegre edilebilir.
5. Chat uygulaması, yapay zeka aracısının ilerleme durumunu bildirmek için Google Chat API'yi kullanarak yanıtları asenkron olarak gönderir.
6. Yanıtlar kullanıcıya iletilir.

Hedefler

• Ortamınızı ayarlayın.
• Chat uygulamasını dağıtın.
• Chat uygulamasını yapılandırın.
• Chat uygulamasını test edin.

Ön koşullar

• Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
• Faturalandırmanın etkin olduğu bir Google Cloud projesi. Mevcut bir projede faturalandırmanın etkinleştirilip etkinleştirilmediğini kontrol etmek için Projelerinizin faturalandırma durumunu doğrulama bölümüne bakın. Proje oluşturma ve faturalandırmayı ayarlama hakkında bilgi edinmek için Google Cloud projesi oluşturma bölümüne bakın.
• Kimlik sağlayıcı olarak Google Identity ile ayarlanmış bir Gemini Enterprise uygulaması.

Ortamınızı ayarlama

Chat API'yi etkinleştirme

Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.

Google Cloud Console'da Google Chat API'yi etkinleştirin.

API'yi etkinleştirme

OAuth izin ekranını yapılandırma

OAuth 2.0 kullanan tüm uygulamalar için izin ekranı yapılandırması gerekir. Uygulamanızın OAuth izin ekranını yapılandırmak, kullanıcılara ve uygulama inceleyicilerine nelerin gösterileceğini tanımlar ve uygulamanızı kaydeder. Böylece, uygulamanızı daha sonra yayınlayabilirsiniz.

1. Google API Console'da Menü > Google Auth platform > Markalama'ya gidin.

   Markalama'ya gidin

2. Google Auth platformunu zaten yapılandırdıysanız Markalama, Kitle ve Veri Erişimi'nde aşağıdaki OAuth izin ekranı ayarlarını yapılandırabilirsiniz. Google Auth platformu henüz yapılandırılmadı mesajını görürseniz Başlayın'ı tıklayın:
1. Uygulama Bilgileri bölümündeki Uygulama adı alanına uygulamanın adını girin.
2. Kullanıcı destek e-postası bölümünde, kullanıcıların rızalarıyla ilgili soruları olduğunda sizinle iletişime geçebileceği bir destek e-posta adresi seçin.
3. İleri'yi tıklayın.
4. Kitle bölümünde Şirket içi'ni seçin.
5. İleri'yi tıklayın.
6. İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirim alabileceğiniz bir e-posta adresi girin.
7. İleri'yi tıklayın.
8. Bitir bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
9. Devam'ı tıklayın.
10. Oluştur'u tıklayın.
3. Şimdilik kapsam eklemeyi atlayabilirsiniz. Gelecekte Google Workspace kuruluşunuzun dışında kullanılacak bir uygulama oluşturduğunuzda Kullanıcı türü'nü Harici olarak değiştirmeniz gerekir. Ardından, uygulamanızın gerektirdiği yetkilendirme kapsamlarını ekleyin. Daha fazla bilgi için OAuth iznini yapılandırma başlıklı kılavuzun tamamını inceleyin.

Google Cloud Console'da hizmet hesabı oluşturma

Aşağıdaki adımları uygulayarak Discovery Engine User rolüne sahip yeni bir hizmet hesabı oluşturun:

Google Cloud Console

1. Google Cloud Console'da Menü > IAM ve Yönetici > Hizmet Hesapları'na gidin.

   Hizmet Hesapları'na gidin

   Geri kalan adımlar Google Cloud Console'da gösterilir.

2. Bir Google Cloud projesi seçin.
3. Hizmet hesabı oluştur'u tıklayın.
4. Google Cloud Console'da gösterilecek bir hizmet hesabı adı girin.
   Not: Google, varsayılan olarak hizmet hesabı adına göre benzersiz bir hizmet hesabı kimliği oluşturur. Kimliği, hizmet hesabı kimliği alanında değiştirebilirsiniz. Kimliği daha sonra değiştiremezsiniz.
5. Erişim denetimlerini şimdi ayarlamak istemiyorsanız hizmet hesabını oluşturmayı tamamlamak için Bitti'yi tıklayın. Erişim denetimlerini hemen ayarlamak için Oluştur ve devam et'i tıklayın ve sonraki adıma geçin.
   Not: Burada erişim denetimi verilmesi yalnızca Google Cloud kaynaklarını etkiler. Google Workspace kaynakları (ör. Google E-Tablolar ve Google Drive) ayrı ayrı paylaşılır ve yapılandırılır.
6. İsteğe bağlı: Google Workspace kaynaklarının yanı sıra Google Cloud projenizin kaynaklarına erişim izni vermek için hizmet hesabınıza roller atayın. Daha fazla bilgi için Projelere, klasörlere ve kuruluşlara erişimi yönetme başlıklı makaleyi inceleyin.
7. Devam'ı tıklayın.
8. İsteğe bağlı: Bu hizmet hesabıyla işlem yapabilecek ve hesabı yönetebilecek kullanıcıları veya grupları girin. Daha fazla bilgi için Hizmet hesabı kimliğine bürünme başlıklı makaleyi inceleyin.
9. Hizmet hesabını oluşturmayı tamamlamak için Bitti'yi tıklayın.

   Hizmet hesabının e-posta adresini not edin.

gcloud CLI

1. Hizmet hesabını oluşturun:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. İsteğe bağlı: Google Workspace kaynaklarının yanı sıra Google Cloud projenizin kaynaklarına erişim izni vermek için hizmet hesabınıza roller atayın. Daha fazla bilgi için Projelere, klasörlere ve kuruluşlara erişimi yönetme başlıklı makaleyi inceleyin.

Hizmet hesabı, hizmet hesabı sayfasında görünür.

Özel anahtar oluşturma

Uyarı: Bu örnekte, basitlik için dışa aktarılmış bir hizmet hesabı anahtarı kullanılmaktadır. Özel anahtarın dışa aktarılması, kaynak kontrolü gibi güvenli olmayan bir konumda depolanmaması gerektiğinden üretimde önerilmez.

Güvenli hizmet hesabı uygulamaları ve en iyi uygulamalar hakkında daha fazla bilgi edinmek için Hizmet hesaplarını ne zaman kullanacağınızı seçme başlıklı makaleyi inceleyin.

Hizmet hesabı için özel anahtar oluşturmak ve indirmek üzere aşağıdaki adımları uygulayın:

1. Google Cloud Console'da Menü > IAM ve Yönetici > Hizmet Hesapları'na gidin.

   Hizmet Hesapları'na gidin

   Geri kalan adımlar Google Cloud Console'da gösterilir.

2. Bir Google Cloud projesi seçin.
3. Anahtar oluşturmak istediğiniz hizmet hesabının e-posta adresini tıklayın.
4. Anahtarlar sekmesini tıklayın.
5. Anahtar ekle açılır menüsünü tıklayın ve Yeni anahtar oluştur'u seçin.
6. Anahtar türü olarak JSON'u seçip Oluştur'u tıklayın.

   Herkese açık/özel yeni anahtar çiftiniz oluşturulur ve makinenize hizmet hesabı anahtar dosyası olarak indirilir. İndirilen JSON dosyasını çalışma dizininize credentials.json olarak kaydedin. Bu dosya, anahtarın tek kopyasıdır. Anahtar dosyasını indirdikten sonra tekrar indiremezsiniz. Anahtarınızı güvenli bir şekilde depolama hakkında bilgi edinmek için Hizmet hesabı anahtarlarını yönetmeyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Hizmet hesapları hakkında daha fazla bilgi için Google Cloud IAM belgelerindeki hizmet hesapları başlıklı makaleyi inceleyin.

Chat uygulaması projesini oluşturma ve yapılandırma

1. Google API Console'da Menü > IAM ve Yönetici > Ayarlar'a gidin.

   IAM ve Yönetici Ayarları'na gitme

2. Proje numarası ve proje kimliği alanlarını not edin.

3. Gemini Enterprise'a gidin:

   Gemini Enterprise'ı açma

4. Uygulamanın konumunu ve kimliğini not edin.

5. GE AI Agent Quickstart Apps Komut Dosyası projesini açmak için aşağıdaki düğmeyi tıklayın.

   Projeyi açın

6. Genel bakış > Kopya oluştur'u tıklayın.

7. Apps Komut Dosyası projenizde, Proje Ayarları > Komut dosyası özelliklerini düzenle > Komut dosyası özelliği ekle'yi tıklayarak aşağıdaki komut dosyası özelliklerini ekleyin:

   1. REASONING_ENGINE_RESOURCE_NAME ile önceki adımlarda belirtilen bilgilerden oluşan Gemini Enterprise uygulama kaynağı.

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID
      

   2. SERVICE_ACCOUNT_KEY ile önceki adımlarda indirilen hizmet hesabının JSON anahtarı (ör. { ... }).

8. Komut dosyası özelliklerini kaydet'i tıklayın.

9. Apps Komut Dosyası projenizde, Proje Ayarları'nı tıklayın.

10. Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.

11. GCP proje numarası bölümüne, önceki adımlarda belirtilen Google Cloud proje numarasını yapıştırın.

12. Projeyi ayarla'yı tıklayın. Cloud projesi ve Apps Komut Dosyası projesi artık bağlı.

Test dağıtımı oluşturma

Bu Apps Komut Dosyası projesi için dağıtım kimliğine ihtiyacınız var. Bu kimliği sonraki adımda kullanabilirsiniz.

Ana dağıtım kimliğini almak için aşağıdakileri yapın:

1. Chat uygulaması Apps Komut Dosyası projesinde, Dağıt > Test dağıtımları'nı tıklayın.
2. Head deployment ID (Baş dağıtım kimliği) bölümünde Kopyala'yı tıklayın.
3. Bitti'yi tıklayın.

Chat uygulamasını yapılandırma

Apps Komut Dosyası dağıtımınızı kullanarak Google Chat uygulamasını test için dağıtmak üzere aşağıdaki adımları uygulayın:

1. API Konsolu'nda Google Chat API araması yapın ve Google Chat API'yi tıklayın.
2. Yönet'i tıklayın.

3. Yapılandırma'yı tıklayın ve Chat uygulamasını ayarlayın:

   1. Uygulama adı alanına GE Quickstart girin.
   2. Avatar URL'si alanına https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png girin.
   3. Açıklama alanına GE Quickstart girin.
   4. İşlevsellik bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.
   5. Bağlantı ayarları bölümünde Apps Komut Dosyası projesi'ni seçin.
   6. Deployment ID (Dağıtım Kimliği) alanına, daha önce kopyaladığınız Head dağıtım kimliğini yapıştırın.
   7. Görünürlük bölümünde Alanınızdaki belirli kişiler ve gruplar'ı seçip e-posta adresinizi girin.

4. Kaydet'i tıklayın.

Chat uygulaması, mesajlara yanıt vermeye hazırdır.

Chat uygulamasını test etme

Chat uygulamanızı test etmek için Chat uygulamasıyla doğrudan mesajlaşma alanı açın ve mesaj gönderin:

1. Kendinizi güvenilir test kullanıcıları arasına eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.

   Google Chat'e gidin.

2. Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.

4. Sonuçlardan Chat uygulamanızı seçin. Doğrudan mesaj açılır.

   Not: Chat uygulamanızı sonuç listesinde görmüyorsanız Google API Konsolu'ndaki Chat API Yapılandırması sayfasının Görünürlük ayarlarında Google Workspace hesabınızı eklediğinizden emin olun.

5. Uygulamayla olan yeni doğrudan mesajda I need to find ideas! yazıp enter tuşuna basın.

   Chat uygulaması, Varsayılan Fikir Üretme aracının yanıtıyla karşılık verir.

Güvenilir test kullanıcıları ekleme ve etkileşimli özellikleri test etme hakkında daha fazla bilgi edinmek için Google Chat uygulamaları için etkileşimli özellikleri test etme başlıklı makaleyi inceleyin.

Sorun giderme

Bir Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir hata oluştu" veya "İsteğiniz işlenemiyor" mesajı gösterilir. Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde hata mesajı gösterilmese de Chat uygulamaları için hata günlüğü kaydı etkinleştirildiğinde hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri kullanılabilir. Hataları görüntüleme, hataları ayıklama ve düzeltme konusunda yardım için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.

Temizleme

Bu eğitimde kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini önlemek istiyorsanız Cloud projesini silmenizi öneririz.

Dikkat: Bir projenin silinmesinin etkileri şunlardır:

• Projedeki her şey silinir. Bu eğitim için mevcut bir proje kullandıysanız projeyi sildiğinizde projede yaptığınız diğer tüm çalışmalar da silinir.
• Özel proje kimlikleri kaybolur. Bu projeyi oluştururken gelecekte kullanmak istediğiniz özel bir proje kimliği oluşturmuş olabilirsiniz. appspot.com'daki bir URL gibi proje kimliğini kullanan URL'leri korumak için projenin tamamını silmek yerine proje içindeki seçili kaynakları silin.

Birden fazla eğiticiden ve hızlı başlangıç kılavuzundan yararlanmayı planlıyorsanız projeleri yeniden kullanarak proje kotası sınırlarını aşmaktan kaçınabilirsiniz.

1. Google API Konsolu'nda Kaynakları yönetin sayfasına gidin. Şunu tıklayın: Menü > IAM & Admin > Kaynakları Yönetin.

   Resource Manager'a gidin

2. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
3. İletişim kutusunda proje kimliğini yazın ve ardından projeyi silmek için Kapat'ı tıklayın.

İlgili konular

• Workspace veri depoları, API'ler ve Chat uygulamalarıyla sıkı bir şekilde entegre olan Gemini Enterprise ajanları oluşturun
• Workspace veri depoları, API'ler ve Chat uygulamalarıyla sıkı bir şekilde entegre olan Vertex AI aracıları oluşturma
• ADK yapay zeka ajanıyla Google Chat uygulaması oluşturma
• A2A tarafından kullanıma sunulan bir ADK yapay zeka temsilcisiyle Google Chat uygulaması oluşturma
• A2UI tarafından kullanıma sunulan bir ADK yapay zeka temsilcisiyle Google Chat uygulaması oluşturma
• ADK yapay zeka aracısı ve Gemini modeliyle ifadelerin doğruluğunu kontrol etme
• Google Workspace'te erişilebilen bir yapay zeka aracısıyla seyahat planlama
• Temel yapay zeka kavramlarını Chat uygulamalarına entegre etme
• Gemini Yapay Zeka Chat uygulamasıyla Chat sohbetlerine dayalı soruları yanıtlama
• Google Chat, Vertex AI, Apps Komut Dosyası ve kullanıcı kimlik doğrulaması ile olaylara yanıt verme
• Google Chat, Vertex AI ve Firestore ile projeleri yönetme