OpenAI ile entegrasyon

OpenAI ile entegrasyon iki görevi yerine getirir:

1) OpenAI 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) OpenAI servisine analiz için özel istek gönderme; örneğin, müşteri iletisini gönderebilir ve ardından OpenAI'den alınan yanıtı iş süreçlerinde kullanabilirsiniz.

İçerik

Etkinleştirme

Adım 1: OpenAI hesabınıza giriş yapın. Henüz bir hesabınız yoksa, yeni bir hesap oluşturun.

Adım 2: Bir API anahtarı oluşturun (Settings → Organization → API keys → Create new secret key → Create secret key) 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ü → "OpenAI — ChatGPT" entegrasyonu. Etkinleştirmekte olduğunuz entegrasyon için bir ad girin, varsayılan modeli seçin ve 2'nci adımda OpenAI hesabınızın ayarlarından aldığınız API anahtarı değerini girin.

Adım 4 (opsiyonel): OpenAI Assistant işlevselliğini kullanmayı planlıyorsanız, ilgili asistanın ID'sini "Assistant ID" alanına girin, daha fazla bilgi.

Kurallarda OpenAI'nin kullanımı

OpenAI 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 OpenAI'ye standart bir istek gönderir. OpenAI'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 OpenAI'ye standart bir istek gönderir. OpenAI'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:

a) 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 OpenAI'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.

OpenAI'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 OpenAI'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.

OpenAI'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.

Özel isteklerde, OpenAI'nin yanıt oluşturma sürecini belirleyen aşağıdaki ek parametreler kullanılabilir:

• temperature — modelin yaratıcılık seviyesi, 0,1 ile 1 arasında bir değerdir. Kesin yanıtlar için genellikle 0,3−0,5 değeri önerilir; yanıtların hem yararlı hem de ilgi çekici olmasını istiyorsanız, değeri 0,7−0,8'e çıkarmayı deneyebilirsiniz;

• frequency_penalty — tekrarların sınırlandırılma düzeyini belirler, −2 ile 2 arasında bir değerdir. Yanıtlarda sınırlı kelime kullanımını fark ederseniz ya da yanıtların özgünlüğünü artırmak isterseniz bu değeri yükseltin. Talimatlar veya teknik dokümanlar için negatif değerleri deneyebilirsiniz;

• presence_penalty — yeni kelime ve fikirlerin kullanılmasını destekleyen bir parametredir, −2 ile 2 arasında bir değerdir. Değer yükseldikçe AI daha yaratıcı olur; yanıtlarda tekrarlanabilirlik ve tutarlılık gerekiyorsa, negatif değerler tercih edilebilir;

• max_tokens — token cinsinden maksimum yanıt uzunluğu. Değer, kullanılan modele göre değişir: GPT-3.5 Turbo ve GPT-4 Turbo modelleri için limit 4096 tokendir. İstekte bu parametre belirtilmezse, model limite ulaşana veya bir "durdurucu belirteci" (örneğin, cümle sonu) ile karşılaşana kadar metin üretmeye devam eder.

İstek metninde, entegrasyon ayarlarında belirtilenden farklı bir dil modelini kullanabilirsiniz. Özel istekte doğrudan belirtilen dil modeli, entegrasyon ayarlarında seçileninin önüne geçer.

Özel istek metni örneği:

{
  "model": "gpt-4",
  "messages": [
    {
      "role": "system",
      "content": "Metin analisti olarak görev yapıyorsunuz. Yapman gereken, content kapsamında aktarılacak olan kullanıcı mesajındaki iki anahtar kelime öbeğini belirlemektir. Yanıtında yalnızca kelime öbeklerini geri döndür, yorum yapma."
    },
    {
      "role": "user",
      "content": "[last_message]"
    }
  ],
  "temperature": 0.6,
  "frequency_penalty": 0,
  "presence_penalty": 0.1,
  "max_tokens": 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 OpenAI'ye bir istek göndererek yapar ve OpenAI, 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, OpenAI'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 OpenAI'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ı.

OpenAI'ye istek gönderme, OpenAI'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 :)