Bu sayfada, etkileşimli bir Google Chat uygulaması oluşturma hakkında genel bilgiler verilmektedir. Etkileşimli Chat uygulamaları, Google Chat'i genişleten Google Workspace eklentileri olarak oluşturulur.
Etkileşimli Chat uygulamaları, kullanıcıların aşağıdakilerden herhangi birini yapmasına olanak tanır:
- Chat uygulamalarını Chat alanlarına veya doğrudan mesajlara ekleyebilirsiniz.
- Metin, kart ve etkileşimli kullanıcı arayüzü öğeleri içeren Chat uygulamalarına mesaj gönderme veya bu uygulamalardan mesaj alma.
- Chat uygulamasıyla bire bir doğrudan mesajların Ana Sayfa sekmesinde Uygulama Ana Sayfası kartını görüntüleme ve bu kartla etkileşim kurma.
- Eğik çizgi komutları, hızlı komutlar veya mesaj işlemleri ile Chat uygulamalarına istem girin.
- Chat mesajlarındaki bağlantıları önizleyebilir ve görüşmeden ayrılmadan işlem yapabilirsiniz.
- Chat uygulamalarına bilgi gönderme (ör. iletişim kutusuna veya kart mesajına metin girme)
- Google Workspace uygulamalarındaki görevleri otomatikleştirme veya gerçekleştirme ve harici araçlara ya da hizmetlere bağlanma.
Kullanıcılar etkileşimli Chat uygulamalarını nasıl keşfeder ve kullanır?
Chat'i genişleten Chat eklentileri, kullanıcılara Google Chat uygulamaları olarak gösterilir. Kullanıcılar, Marketplace'te yayınlanan sohbet uygulamalarını aşağıdaki gibi birçok şekilde keşfedip kullanabilir:
- Google Chat veya Marketplace'ten Chat uygulamalarını arayıp yükleyin.
- Chat alanına eklenmiş bir Chat uygulamasıyla etkileşimde bulunma
- Google Workspace yöneticisi, Chat uygulamasını kullanıcı adına yükledikten sonra kullanıcılar, doğrudan mesajlar panelinde Chat uygulamasını keşfeder.
Google Chat kullanıcıları, Chat uygulamalarını kullanmaya başlamak için Chat uygulamasıyla doğrudan mesajlaşma başlatabilir veya uygulamayı bir alana ekleyebilir. Kullanıcılar, @bahsetme özelliğini kullanarak da Chat uygulamasını ekleyebilir. Daha fazla bilgi için Chat uygulamalarını kullanma başlıklı makaleyi inceleyin.
Aşağıdaki örnekte, bir kullanıcının bir Chat uygulamasını alana eklemek için nasıl @bahsettiği gösterilmektedir:
Başlayın
Etkileşimli bir Chat uygulaması oluşturmaya başlamak için aşağıdaki dokümanlara bakın:
- Google Chat API'yi yapılandırın ve Chat uygulamanız için etkileşimli özellikleri etkinleştirin.
- Tetikleyicileri, etkinlik nesnelerini ve işlemleri kullanarak kullanıcı etkileşimlerini nasıl alıp yanıtlayacağınızı öğrenin.
- Tercih ettiğiniz Google Chat uygulama mimarisi için temel bir Chat uygulaması oluşturmak üzere hızlı başlangıç kılavuzunu deneyin.
Temel bir Chat uygulaması yapılandırma ve oluşturma
Aşağıdaki tabloda, Chat API'yi yapılandırma ve her Google Chat uygulama mimarisi için temel bir etkileşimli Chat uygulaması oluşturma ile ilgili dokümanlar listelenmektedir:
| Mimari veya görev | Kılavuz |
|---|---|
| Chat API'yi yapılandırma | Google Chat API'yi yapılandırma |
| Hızlı başlangıç kılavuzları | |
| Apps Komut Dosyası | Apps Komut Dosyası ile Chat uygulaması oluşturma |
| HTTP hizmeti (Cloud Run işlevleri) | HTTP Chat uygulaması oluşturma |
| Pub/Sub | Pub/Sub ile Chat uygulaması oluşturma |
| Dialogflow CX | Dialogflow CX Chat uygulaması oluşturma |
| Dialogflow ES | Dialogflow ES Chat uygulaması oluşturma |
| Agent Development Kit (ADK) yapay zeka ajanı | ADK yapay zeka ajanı Chat uygulaması oluşturma |
| Agent2Agent (A2A) yapay zeka ajanı | A2A yapay zeka ajanı Chat uygulaması oluşturma |
| A2UI yapay zeka ajanı | A2UI yapay zeka ajanı Chat uygulaması oluşturma |
| Gemini Enterprise yapay zeka ajanı | Gemini Enterprise yapay zeka aracısı sohbet uygulaması oluşturma |
Etkileşimli özellikler oluşturma
Aşağıdaki tabloda, etkileşimli sohbet uygulaması özellikleri oluşturmayla ilgili dokümanlar gösterilmektedir:
| Özellik | Kılavuz |
|---|---|
| Kullanıcı etkileşimlerini alma ve yanıtlama | Kullanıcı etkileşimlerini alma ve yanıtlama |
| Mesaj gönderme (etkileşimlere yanıt verme veya proaktif olarak mesaj gönderme) | Mesajla yanıt verme veya Chat API'yi kullanarak mesaj gönderme |
| Eğik çizgi komutlarına, hızlı komutlara ve mesaj işlemlerine yanıt verme | Komutlara yanıt verme |
| Etkileşimli iletişim kutuları oluşturma | Etkileşimli iletişim kutularını açma |
| Kartlardaki ve iletişim kutularındaki bilgileri toplama ve işleme | Kullanıcıların kartlara girdiği form verilerini okuma |
| Chat mesajlarındaki bağlantıları önizleme | Bağlantıları önizleme |
| Bire bir doğrudan mesajlarda ana sayfa (uygulama ana sayfası) oluşturma | Chat uygulaması için ana sayfa oluşturma |
| Harici sistemlere ve araçlara bağlanma | Bir Chat uygulamasını diğer hizmetlere ve araçlara bağlama |
Google Workspace eklentileriyle ilgili sınırlamalar ve dikkat edilmesi gereken noktalar
Chat uygulamaları, Chat'i genişleten Google Workspace eklentileri olarak oluşturulduğundan aşağıdaki özellik sınırlamalarını göz önünde bulundurun:
- AppSheet Chat uygulaması mimarisi, Google Workspace eklentisi olarak oluşturulurken kullanılamaz. Bunun yerine, HTTP hizmeti, Apps Komut Dosyası, Dialogflow ES, Dialogflow CX veya Pub/Sub kullanarak sohbet uygulaması oluşturun.
- Özel yetkilendirme kartları Chat'te desteklenmez. Chat'ten hizmetinizin kimliğini doğrulamak ve hizmetinize yetki vermek için Chat uygulaması temel yetkilendirme kartı döndürmelidir.
- Chat kenar çubuğundaki eklenti ana sayfaları desteklenmez. Manifest dosyanızda (
addons.common.homepageTrigger) ana sayfa tetikleyicisi yapılandırdıysanız ana sayfa yalnızca eklentinizin kapsamını genişlettiği diğer Google Workspace uygulamalarının kenar çubuğunda görünür. Bunun yerine, Chat uygulamasıyla bire bir doğrudan mesajlaşmalarda Ana Sayfa sekmesinde görünen bir Chat uygulaması ana sayfası oluşturabilirsiniz.
Mevcut bir Google Workspace eklentisini Chat'te çalışacak şekilde genişletiyorsanız Chat uygulamaları için aşağıdaki yapılandırma şartlarını göz önünde bulundurun:
- Google Workspace Marketplace yükleme ayarları, hem bireylerin hem de Google Workspace yöneticilerinin eklentiyi yüklemesine izin vermelidir.
- Eklentinin manifest dosyasındaki (
addons.common) ortak yapılandırma ayarları Chat'te yoksayılır. Eklentinin Chat'te çalışmasını yapılandırmak için Chat API'yi etkinleştirip yapılandırmanız gerekir. Adımlar için Google Chat API'yi yapılandırma başlıklı makaleyi inceleyin. - Chat'te bir eklentiyi dağıtmak ve test etmek için Chat API'nin Görünürlük ayarını kullanmanız gerekir. Google Workspace Marketplace SDK'sında yapılandırdığınız tüm görünürlük veya test ayarları yoksayılır. Eklentinin Chat'te test sürümünü dağıtmak için Google Chat uygulamaları için etkileşimli özellikleri test etme başlıklı makaleyi inceleyin.
- Eklentileriniz Google Workspace Marketplace'te yayınlandıysa Google Chat API yapılandırma ayarlarında yapılan değişikliklerin taslağını kaydedemezsiniz. Chat API yapılandırma ayarlarını güncellediğinizde güncellenen Chat uygulaması, mevcut tüm kullanıcılar tarafından anında kullanılabilir. Pazar yeri listelemenizi güncellemek için değişiklikleri göndermeden önce taslak oluşturabilirsiniz.
İlgili konular
- Google Chat API dokümanlarına genel bakış
- Kullanıcı etkileşimlerini alma ve yanıtlama
- Google Chat uygulaması mimarisi seçme
- Örnek deneyin:
- Google Chat'ten toplantı planlama
- Temel yapay zeka kavramlarını Chat uygulamalarına entegre etme
- Google Workspace'te erişilebilen bir yapay zeka aracısıyla seyahat planlama
- 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
Eklenti olmayan Chat uygulamaları: Etkileşimli bir Google Chat uygulaması oluşturma
Google Workspace eklentisi olmayan Chat uygulamaları, Google Workspace eklenti etkinlik nesneleri (EventObject) ve işlemler yerine Chat API etkileşim etkinlikleri (Event) alan yalnızca Chat uygulamaları olarak oluşturulur.
Eklenti olmayan bir Chat uygulaması kullanıyorsanız:
- Eklenti olmayan Chat uygulamanızı, Google Chat'i genişleten bir Google Workspace eklentisine dönüştürme. Google Chat uygulamasını Google Workspace eklentisine dönüştürme başlıklı makaleyi inceleyin.
- İstek ve yanıt biçimleri için bu doküman setindeki her etkileşimli özellik kılavuzunun alt kısmında bulunan genişletilebilir Eklenti olmayan sohbet uygulamaları bölümlerine bakın.