Gemini ile entegrasyon

Gemini ile entegrasyon iki görevi yerine getirir:

1) Gemini servisi tarafından müşteri iletisinin analizine dayalı olarak veri alanlarının otomatik olarak doldurulması. Standart "Grup" veri alanının ve "Açılır liste" / "Onay kutusu" tipi destek talebi veya müşteri özel veri alanlarının doldurulması mümkündür;

2) Gemini'ye analiz için özel istek gönderme; örneğin, müşteri iletisini gönderebilir ve ardından Gemini'den alınan yanıtı iş süreçlerinde kullanabilirsiniz.

İçerik

Etkinleştirme

Adım 1: Google Cloud hesabınıza giriş yapın. Google Cloud hesabınızda etkin bir GCP projeniz olduğundan emin olun veya yeni bir GCP projesi oluşturun. Bunu nasıl yapacağınızı aşağıdaki görselde açıklıyoruz:

Adım 2: Google AI Studio konsolunda oturum açın. Bir API anahtarı oluşturun (Get API key → Create API key → Search Google Cloud projects → Create API key in existing project) ve değerini kopyalayın.

Adım 3: Deskie yönetici hesabınızla şu adımları takip edin: "Ayarlar" bölümü → "Entegrasyonlar" alt bölümü → "Gemini" entegrasyonu. Etkinleştirmekte olduğunuz entegrasyon için bir ad girin, varsayılan modeli seçin ve 2'nci adımda Google AI Studio konsolundan aldığınız API anahtarı değerini girin.

Kurallarda Gemini'nin kullanımı

Gemini ile entegrasyonu etkinleştirdiğinizde, Deskie'deki otomasyon kurallarında ihtiyaçlarınıza uygun senaryolara göre çalışmanızı yapılandırmaya olanak sağlayan yeni koşullar ve eylemler eklenecektir.

Eylemler

İsteklerin tekrarlanmasını ve bunun sonucunda gereksiz yere token'lerin harcanmasını önlemek için, "— AI ile entegrasyon" kategorisindeki her eylem bir kural kapsamında yalnızca bir kez belirtilebilir.

1) Otomatik olarak belirle "Grup"

Gelen ve güncellenen destek talepleri için türünden kurallarda mevcuttur ve iletinin analiz edilmesi amacıyla Gemini'ye standart bir istek gönderir. Gemini'nin yanıtına dayanarak standart "Grup" veri alanı için en uygun değeri otomatik olarak belirler ve söz konusu değeri destek talebi parametrelerinde ayarlar:

• gelen destek talepleri için türünden kurallarda, analiz için destek talebindeki ilk iletinin metni gönderilir;

• güncellenen destek talepleri için türünden kurallarda, analiz için destek talebindeki son müşteri iletinin metni gönderilir.

Kuralın nasıl çalıştığına dair örnek:

2) Otomatik olarak belirle "Açılır liste" / "Onay kutusu"

Gelen ve güncellenen destek talepleri için türünden kurallarda mevcuttur ve iletinin analiz edilmesi amacıyla Gemini'ye standart bir istek gönderir. Gemini'nin yanıtına dayanarak "Açılır liste" / "Onay kutusu" tipi destek talebi veya müşteri özel veri alanı için en uygun değeri otomatik olarak belirler ve söz konusu değeri destek talebi parametrelerinde ayarlar:

• gelen destek talepleri için türünden kurallarda, analiz için destek talebindeki ilk iletinin metni gönderilir;

• güncellenen destek talepleri için türünden kurallarda, analiz için destek talebindeki son müşteri iletinin metni gönderilir.

Kuralın nasıl çalıştığına dair örnek:

Veri alanlarının yapılandırılması

Yapay zeka aracılığı ile doldurmayı planladığınız veri alanları önceden oluşturulmalı ve "Temsilci hesabında destek talebi parametreleri" adlı forma eklenmiş olmalıdır. Entegrasyonun düzgün çalışması için lütfen aşağıdaki hususlara dikkat edin:

• veri alanları adları ve değerleri tekrarlanmamalıdır;

• birden fazla dilde destek sunuluyorsa, veri alanları adları ve değerleri tüm dillerde belirtilmeli ve benzersiz olmalıdır;

• veri alanları adları ve değerleri boşlukla değil bir karakterle başlamalı ve bitmelidir.

Olası sorunlar

Veri alanlarını yapılandırma ile ilgili önerilere uyulmadığında, aşağıdaki sorunların ortaya çıkma olasılığı artar:

а) AI geçersiz değer döndürüyor

AI'den gelen yanıtta "Açılır liste" tipindeki veri alanı için Deskie tarafında karşılık gelen bir değer yoksa veya "Onay kutusu" tipindeki veri alanı için AI'den gelen yanıttaki değer onay kutusunun durumunu temsil eden sayısal değerlerden ("1/0") farklıysa, veri alanı doldurulmaz ve etkinlik geçmişinde ilgili eylem şu kayıt ile eklenir:

Otomatik olarak belirle "[veri_alanı_adı]": AI yanıtındaki değer, veri alanı ayarlarında tanımlanan değerlerden farklıdır (harcanan token — [n])

b) AI boş değer döndürüyor

AI belirli bir veri alanının işlenmesini göz ardı ederse ve yanıtında bu veri alanı ile ilgili hiçbir bilgi sağlamazsa, veri alanı doldurulmaz ve etkinlik geçmişinde ilgili eylem şu kayıt ile eklenir:

Otomatik olarak belirle "[veri_alanı_adı]": AI, sağlanan verilerin yetersiz olması nedeniyle bir sonuç çıkaramadı (harcanan token — [n])

c) Veri alanı, "Temsilci hesabında destek talebi parametreleri" formunda etkinleştirilmemiş

Veri alanı temsilci hesabındaki destek talebi parametrelerinde görüntülenmek üzere yapılandırılmamışsa, veri alanı değerinin otomatik olarak belirlenmesine ve veri alanı değerinin güncellenmesine dair etkinlik geçmişinde herhangi bir kayıt oluşmaz. Ancak eylem yine de arka planda gerçekleşir ve ileride veri alanını destek talebi sayfasında görüntülenecek şekilde yapılandırırsanız, AI tarafından aktarılan değerle doldurulacak ve etkinlik geçmişinde buna karşılık gelen bir kayıt görüntülenmeye başlayacaktır.

3) AI'ye metin bazlı istek gönder

Tüm kural türlerinde mevcuttur ve Gemini'ye yazdığınız metin isteğini + analiz edilmesi gereken müşteri veya temsilci iletisinin içeriğini gönderir. İlgili ileti değişkenler aracılığıyla belirtilir:

• [case_description] — destek talebindeki ilk ileti;

• [last_message] — destek talebindeki son ileti.

Gemini'den alınan yanıt, Deskie tarafından yalnızca kuralın yürütülmesi süresince [ai_response_by_text_request] değişkeninde geçici olarak tutulur. Bu değişkeni kullanarak AI yanıtını kural aracılığıyla şu eylemlerde değerlendirebilirsiniz:

• müşteriye gönder;

• not olarak ekle;

• "metin alanı" veya "çok satırlı metin" tipindeki destek talebi alanına yaz.

Metin bazlı istek örneği:

Türkçeye çevir:
[case_description]

Kuralın nasıl çalıştığına dair örnek:

4) AI'ye özel istek gönder

Tüm kural türlerinde mevcuttur ve Gemini'ye JSON formatında yazdığınız özel isteği + analiz edilmesi gereken müşteri veya temsilci iletisinin içeriğini gönderir. İlgili ileti değişkenler aracılığıyla belirtilir:

• [case_description] — destek talebindeki ilk ileti;

• [last_message] — destek talebindeki son ileti.

Gemini'den alınan yanıt, Deskie tarafından yalnızca kuralın yürütülmesi süresince [ai_response_by_custom_request] değişkeninde geçici olarak tutulur. Bu değişkeni kullanarak AI yanıtını kural aracılığıyla şu eylemlerde değerlendirebilirsiniz:

• müşteriye gönder;

• not olarak ekle;

• "metin alanı" veya "çok satırlı metin" tipindeki destek talebi alanına yaz.

Gemini'nin yanıt üretimini düzenlemek için özel isteklerde aşağıdaki ek parametreler kullanılabilir:

• responseMimeType — isteğe yanıt olarak Gemini'nin döndürdüğü içerik türü; entegrasyon metin işleme üzerine kurulu olduğundan, istenmeyen formatlarda (örneğin, JSON) yanıt almayı önlemek için "text/plain" değerini belirtmek gerekir;

• maxOutputTokens — token cinsinden maksimum yanıt uzunluğu; bu parametrenin belirtilmesi, üretilen yanıtların uzunluğunun kontrol edilmesine ve dolayısıyla maliyetlerin optimize edilmesine yardımcı olur;

• temperature — yanıtların üretilmesindeki rastgelelik derecesini belirleyen, 0,1 ile 2 arasında değer aralığına sahip parametre. Etkisi özellikle topP ve topK ile birlikte kullanıldığında belirginleşir; bu parametreler birlikte yanıtların çeşitliliği ve yaratıcılığı üzerinde etkilidir. Düşük değerler (0,1'e yakın) yanıtları daha kesin hale getirir, bu da sıkı mantık veya kesin veri gerektiren görevler için uygundur. Yüksek değerler (2'ye yakın) daha fazla yaratıcılık katarak yanıtların daha özgün ve yaratıcı olmasını sağlar;

• topP (çekirdek örnekleme yöntemi) — yalnızca toplam olasılığı belirli bir yüzdeye (P) dahil olanları dikkate alarak yanıt seçeneklerinin seçimini sınırlayan bir parametredir. Örneğin, topP = 0,9 olduğunda, yalnızca olasılığın %90'ını kapsayan seçenekler dikkate alınır. Bu, düşük olasılıklı ancak yine de geçerli seçenekleri dışlayarak rastgelelik ile amaçlılık arasında bir denge kurulmasını sağlar;

• topK — yanıt seçeneklerinin seçiminde yalnızca en olası K seçeneklerin dikkate alınmasını sağlayan bir parametredir. Örneğin, topK = 50 olduğunda, seçim yalnızca en yüksek olasılığa sahip 50 seçenek arasından yapılır. Bu, daha az olası yanıtları hariç tutarak en alakalı yanıtlar üzerinde yoğunlaşmayı sağlar.
  
  Her iki parametre de oluşturulan yanıtların kalitesini ve çeşitliliğini dengelemek için kullanılır: topP, toplam olasılığa odaklanarak daha esnek bir seçim sunarken, topK seçenek sayısını kısıtlayarak daha kontrollü bir sonuç sağlar.

Ek parametreler, kullanım alanları ve uygulama yöntemleri hakkında ayrıntılı bilgiye buradan ulaşabilirsiniz.

Özel istek metni örneği:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Metin analisti olarak görev yapıyorsun. [last_message] içinde iki anahtar kelime öbeğini belirle. Yanıtında yalnızca kelime öbeklerini geri döndür, yorum yapma."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseMimeType": "text/plain",
    "maxOutputTokens": 100
  }
}

Kuralın nasıl çalıştığına dair örnek:

Koşullar

1) Değişiklikleri yapan — AI servisi ile entegrasyon

Güncellenen destek talepleri için türünden kurallarda "Değişiklikleri yapan" koşulu kapsamında bir opsiyon olarak mevcuttur. Bu koşul, gelen destek talepleri için türünden kurallarda yer alan "— AI ile entegrasyon" kategorisindeki eylemler sonucunda destek talebi veri alanlarında yapılan değişiklikleri izlemeye olanak tanır.

a) Kural, "Değişiklikleri yapan — AI servisi ile entegrasyon" koşulunu + veri alanlarından birindeki değerin değişimini izleme koşulunu içeriyorsa, bu koşullar arasında "VE" mantıksal operatörü çalışır — yani kural yalnızca belirtilen değişiklik AI servisi ​​ile olan entegrasyon tarafından yapılmışsa tetiklenir.

Veri alanı değişikliği bir temsilci, müşteri veya başka bir kural tarafından yapay zeka katılımı olmadan yapılırsa, kural ÇALIŞMAYACAKTIR.

Bunu somut bir örnekle açıklayalım. Diyelim ki, güncellenen destek talepleri için türünden bir kuralınız var; bu kuralın koşullarında, "Destek talebi türü" adlı özel veri alanının değeri değiştirildiğinde VE bu değişiklik yalnızca AI servisi ​​ile olan entegrasyon tarafından yapıldığında kuralın çalışması belirtilmiştir.

Ayrıca, gelen destek talepleri için türünden iki kuralınız daha bulunmaktadır; her ikisi de "Destek talebi türü" adlı özel veri alanında değişiklik yapmaktadır. Ancak bu kurallardan biri bunu Gemini'ye bir istek göndererek yapar ve Gemini, bu veri alanı için uygun değeri seçer. Diğeri ise standart bir eylem olan ""[özel veri alanı adı]" veri alanı değerini şu olarak değiştir" eylemiyle veri alanının değerini değiştirir.

İlk durumda, güncellenen destek talepleri için türünden oluşturduğunuz kural çalışacaktır, ikinci durumda ise çalışmayacaktır.

b) Kuralların döngüye girmesini önlemek için, "— AI ile entegrasyon" kategorisinden bir eylem, "Değişiklikleri yapan — AI servisi ile entegrasyon" koşulu ile aynı anda kullanılamaz. Ayrıca, kuralın herhangi bir değişikliği değil, belirli bir değişikliği izlemesi için, "— destek taleplerindeki değişiklikler" kategorisinden de bir koşul mutlaka seçilmelidir.

c) "Değişiklikleri yapan — her kimse" koşulu seçildiğinde AI eylemleri seçilemez.

2) İçerikteki / Son müşteri yanıtındaki karakter sayısı

Tüm kural türlerinde mevcuttur ve müşteri iletilerinin boyutunu izlemeye olanak tanır. Bu, Gemini'ye istek gönderen kuralların çalıştırılması gereken durumları tespit etmek için gereklidir. Böylece, örneğin "Merhaba" veya "Bir sorum olacak" gibi anlamlı içerik taşımayan iletilerin Gemini'ye gereksiz yere gönderilmesi önlenebilir.

Karakter sayımını yalnızca düz metne göre ya da HTML etiketleri dahil edilerek yapmayı tercih edebilirsiniz.

• Gelen destek talepleri için türünden kurallarda, koşul müşterinin ilk iletisinin uzunluğunu kontrol eder ve bu nedenle " İçerikteki karakter sayısı — şundan daha fazla / şundan daha az / eşit" şeklinde adlandırılmıştır:
  
  

  

• Güncellenen ve cari destek talepleri için türünden kurallarda, koşul müşterinin son iletisinin uzunluğunu kontrol eder ve bu nedenle "Son müşteri yanıtındaki karakter sayısı — şundan daha fazla / şundan daha az / eşit" şeklinde adlandırılmıştır:
  
  

  

Destek talebi etkinlik geçmişinde eylemlere ilişkin kayıtlar

"— AI ile entegrasyon" kategorisindeki eylemleri içeren bir otomasyon kuralının çalıştırılmasının tamamlanması zaman alır. Sürenin uzunluğu birkaç faktöre bağlıdır:

• kuraldaki eylem sayısı;

• aktarılan veri hacmi;

• harici servislerin yanıt hızı;

• kuralın aynı anda çalıştığı destek talebi sayısı.

Gemini'ye istek gönderme, Gemini'den yanıt alma, ilgili destek taleplerinde değişiklik yapma gibi işlemler arka planda gerçekleştirilir. Bu nedenle, AI eylemleri ile ilgili etkinlik geçmişi kayıtları da aşamalı olarak (eylemler gerçekleştikçe) destek talebine eklenirler.

AI eylemlerinin gerçekleştirilmesine ilişkin etkinlik geçmişi kayıtlarında, istek yürütülme aşamasındayken eylemin durumu gösterilir, tamamlandıktan sonra ise tükettiği token sayısı görüntülenir.

Entegrasyonun devre dışı bırakılması ve silinmesi

Yönetici hesabında birden fazla etkin AI entegrasyonu varsa, entegrasyon devre dışı bırakıldığında veya silindiğinde, yöneticiye şu seçenekler sunulur:

a) devre dışı bırakılan AI entegrasyonunu kurallarda etkin kalanlardan biriyle değiştirmek:

b) devre dışı bırakılan AI entegrasyonuyla ilişkili tüm kural eylemlerini silmek:

---

Çalışmalarınızda AI entegrasyonunu nasıl kullandığınızı bizimle paylaşın. Başkaları için de yararlı olabilecek ise, bunu mutlaka duyururuz :)