3CX AI Temsilcileri Ajantik Araçları
Sohbetteki Ajentik Araçlar
Temsilci Türüne Göre Ajantik Araçlar
Ayrıca Bakınız
Giriş
Ajantik araçlar temsilcilerin PBX sistemi ve arayanlarla etkileşime girerek çağrı aktarma ve bilgi alma gibi işlevleri yerine getirmelerini sağlar. Bu belgede, her temsilci türü için mevcut olan araçları ve bunların işlevlerini listeliyoruz.
Kullanım ve Biçimlendirme Temelleri
3CX AI Agent’ın komut istemleri Mustache sözdizimini kullanır. Bu bölümde sözdizimine genel bir bakış sunulmaktadır. Bu kuralları anlamak, ajantik araçların 3CX AI Temsilci komut istemlerine doğru bir şekilde entegre edilmesini sağlar.
- Değişkenler, tanımlayıcıyı küme parantezleri içine alarak Mustache sözdizimi kullanılarak çağrılır.
- {{...}} veya {{{...}}} -> (#, ^ veya / içermez) bir değişkenin ham içeriğini doğrudan o konuma döndürür (yansıtır) (HTML kaçış karakterleri kullanılmadan).
- Bir blok içine bir komut istemi bölümü yerleştirebiliriz; içerik, yalnızca bir değişken bir testi geçerse son komut istemi metninde görüntülenir.
- Olumlu bir test yapma seçeneğimiz var:
- {{#...}} -> blok, yalnızca değişkenin içeriği varsa veya TRUE ise açılır
- {{/…}} -> blok kapanır
- veya olumsuz bir test:
- {{^...}} -> blok, yalnızca değişken boşsa veya FALSE ise açılır
- {{/…}} -> blok kapanır
- Ajantik araçlar adlarıyla “çağrılabilir”, ancak AI Temsilci bunların gerekli olduğunu belirlediğinde onları kendisi çağırır.
Aşağıda, her ikisi de 3CX AI Temsilcisi’nin Çağrı Yönlendirme sekmesinde tanımladığınız “Konuya Göre Yönlendirme” çağrı yönlendirme hedeflerini kullanan iki örnek yer almaktadır.
Örneklerimizde şunları kullanacağız:
- addressbook_topics değişkeni – bu değişken, yapılandırdığınız tüm Konuya Göre Yönlendirme girişlerini içerir; temsilci her (yeniden) başlatıldığında bu değişken, Konular ile doldurulur; bu, bir sistem değişkeni olarak işlev görür.
- get_addressbook aracı - yapılandırılmış Konu girişlerini talep üzerine getiren bir Ajantik araçtır.
- resolve_handoff_destination aracı - doğal dil isteklerini hedefler (dahili numaralar) olarak çözümleyen bir Ajantik araçtır.
Örnek 1
Ajantik araçları, temel komut satırında, AI Temsilcisine bunların kullanımıyla ilgili rehberlik de eklenerek belirtilebilir; böylece ajan, bu araçları ne zaman kullanacağına serbestçe karar verebilir.
Arayan kişi bir departman sorarsa veya bir sorunla ilgili soru sorarsa, öncelikle get_addressbook işlevini kullanarak soruyla ilgili konular olup olmadığını kontrol et ve hemen resolve_handoff_destination işlevini kullan; önce bilgilendirici bir yanıt verme.
Yukarıdaki örnekte, komut satırına eklenen bu kısım, AI modeline hangi araçların mevcut olduğunu bildirir ve ardından bu araçların çağrılıp çağrılmayacağına modelin karar vermesini sağlar. Yukarıdaki metin, herhangi bir Konu belirlenmiş olsun ya da olmasın, her zaman nihai ve çözümlenmiş komut satırında yer alacaktır.
Örnek 2
Komut isteminin oluşturulmasına temel mantık eklemek ve gerekli olmadığında öğeleri atlamak için Mustache sözdizimini de kullanabilirsiniz; bu, daha kompakt veya daha temiz bir nihai komut istemiyle sonuçlanabilir.
{{#addressbook_topics}}
Arayan kişi bir departman sorarsa veya bir sorunla ilgili soru sorarsa, aşağıdaki listede bu soruyla ilgili konular olup olmadığını kontrol et:
{{addressbook_topics}}
ve hemen resolve_handoff_destination işlevini kullan; önce bilgilendirme amaçlı yanıt verme.
{{/addressbook_topics}}
{{^addressbook_topics}}
Hemen resolve_handoff_destination kullan, önce bilgilendirme amaçlı yanıt verme.
{{/addressbook_topics}}
Bu örnekte:
- Öncelikle, addressbook_topics'in ayarlanmış/mevcut olup olmadığını kontrol ederiz; eğer öyleyse,
- bu Konuların bir listesini komut satırına yazdırırız; böylece AI Temsilci,
- konu listesi (ve Bölümleriniz ile kullanıcı/sistem dahilileri hakkındaki bilgisi) temelinde, resolve_handoff_destination aracını kullanarak arama için en uygun hedefi bulabilir.
- Ardından, addressbook_topics ayarlanmamışsa,
- komut istemini fazladan metin ve boş bir listeyle “karıştırmayız”; bunun yerine,
- resolve_handoff_destination aracını kullanarak, bölümlerimiz ve kullanıcı/sistem dahilileri hakkındaki bilgilerini göz önünde bulundurarak arama için en uygun hedefi bulmasını isteriz.
“Her türlü elektriksel sorun için: 106” şeklinde tek bir konu yapılandırılmış bir PBX sisteminde, yukarıdaki komut tanımı, AI Temsilcisinin izlemesi gereken aşağıdaki nihai komut metnini oluşturur:
Arayan kişi bir bölüm sorarsa veya bir sorunla ilgili soru sorarsa, aşağıdaki listede soruyla ilgili konular olup olmadığını kontrol et:
- Her türlü elektrikle ilgili sorunlar için
ve hemen resolve_handoff_destination kullan; önce bilgilendirme amaçlı cevap verme.
AI temsilcilerinin bu araçlar ve yetenekleri hakkında halihazırda bilgi sahibi oldukları unutulmamalıdır. Varsayılan komut istemlerini kullanan standart bir çağrıda, temsilci açık talimatlar olmaksızın bu araçları kullanabilir. Ancak, temsilcinin davranışını etkilemek veya kesin bir işlem sırasını belirlemek istiyorsanız, yukarıda gösterildiği gibi komut isteminin içinde doğrudan bu araçları çağırması için talimat verebilirsiniz.
Sohbetteki Ajantik Araçlar
AI temsilci istemleri, iletişim kanalı (sesli veya metin/sohbet) ne olursa olsun tüm temsilcilerde ortaktır. Aşağıdaki araç açıklamaları sesli kanala odaklanmıştır ve çoğu durumda sohbet kanalında da aynı şekilde çalışacaktır.
Sesli aramaları yönlendiren bazı araçlar (örneğin, sesli mesaja yönlendirme) elbette metin tabanlı iletişimde çalışmayacaktır; diğer araçlar ise eylemlerini biraz farklı şekilde gerçekleştirecek olsa da, aşağıda verilen teknik özellikler dahilinde çalışacaktır.
Temsilci Türüne Göre Ajantik Araçlar
Araç Adı | Fonksiyon | Role göre Aracın Kullanılabilirliği | ||
Resepsiyonist | Kişisel Asistan | Müşteri Hizmetleri (U10) | ||
classify_request_before_handoff | Kişisel Asistan iş akışlarının araya girme, bildirim ve engelleme senaryolarını birbirinden ayırt etmesini sağlar. Arayan kişi Kişisel Asistan’ın patronu değilse, çağrı sınıflandırması kaydedilir; böylece temsilci nasıl hareket edeceğine karar verebilir. | Hayır | Evet | Hayır |
drop_call | Asistanın konuşmayı sonlandırmasına izin verir | Evet | Evet | Evet |
find_contact_by_extension | Belirli bir dahili hakkında bilgi alır . | Evet | Evet | Evet |
get_addressbook | “Konuya Göre Yönlendir” listesini yükler; böylece AI temsilcisi, bu listenin öğelerini hem sohbet sırasında hem de varış noktalarını seçerken kullanabilir. | Evet | Evet | Evet |
get_current_datetime | Geçerli tarih ve saati hem UTC hem de yerel sistem saati olarak döndürür. | Evet | Evet | Evet |
perform_chat | Bir sohbet mesajı yoluyla ilgili alıcıya bildirimde bulunarak görüşmeyi sonlandırma sürecini başlatır. | Evet | Evet | Evet |
perform_email | İlgili alıcıya bir e-posta yoluyla bildirimde bulunarak aramayı sonlandırma sürecini başlatır. | Evet | Evet | Evet |
perform_transfer | Aramayı uygun hedefe aktararak aramayı sonlandırma işlemini başlatır. | Evet | Evet | Evet |
perform_voicemail | Aramayı uygun alıcının sesli mesaj servisine aktararak aramayı sonlandırma işlemini başlatır. | Evet | Evet | Evet |
resolve_handoff_destination | İzin verilen tüm aktarım uç noktalarında serbest metinli hedef araması yaparak arayanın aktarım talebini yerine getirir. | Evet | Hayır | Evet |
set_detected_language | Asistanın, arayanın dilini algılayıp bunu sonraki etkileşimlerde kullanmasını sağlar. | Evet | Evet | Evet |
spam_detected | Mevcut aramanın spam olarak tanımlandığını kaydeder. | Evet | Evet | Evet |
take_handoff_decision | İstenen devretme türünü ve dahili numarayı kaydeder. | Evet | Evet | Evet |
take_hostility_action | Arayan kişinin düşmanca veya saldırgan bir tavır sergilediğini kaydeder. | Evet | Evet | Evet |
take_not_collaborative_action | Arayan kişinin asistanla işbirliği yapmaya isteksiz olduğunu kaydeder. | Evet | Evet | Evet |
vector_store_search | Asistanın, yapılandırılmış bilgi tabanlarından ve indekslenmiş belgelerden bilgi almasını sağlar. | Evet | Evet | Evet |
Ajantik Araçlar, Girişler ve Çıkışlar
Araç Adı | Giriş | Çıkış | Gereksinimler |
classify_request_before_handoff | Kullanılan sınıflandırmalar:
| Sınıflandırma kayıt onayı | |
drop_call | Yok | Çağrı sonlandırma alt sistemi tarafından döndürülen sonuç. | |
find_contact_by_extension | Dahili numarası, ör. 100. | Çözümleme durumunun önündeki dizin tablosu. | |
Resolution: exact_contact ext|name|department|available|can_receive_email 100|John Smith|Sales|true|true | |||
get_addressbook | Yok | Ayarlanan tün Konuları içeren liste. | |
| |||
get_current_datetime | Yok | Aşağıdakileri içeren bir dize:
| |
perform_chat | Yok (İkincil, açıkta olmayan araçlar aracılığıyla mevcut çağrı bağlamı bilgilerini kullanır). | Sohbet kararının kaydedildiğine dair onay. | KA, bildirim kurallarına uyar; diğerleri ise varsayılan olarak “mevcut” durumuna geçer. |
perform_email | Yok (İkincil, açıkta olmayan araçlar aracılığıyla mevcut çağrı bağlamı bilgilerini kullanır). | Sohbet kararının kaydedildiğine dair onay. | Hedef, e-posta alabilme koşullarını sağlamalıdır. KA, bildirim kurallarına uyar; diğerleri ise varsayılan olarak “mevcut” olarak ayarlanır. |
perform_transfer | Yok (İkincil, açıkta olmayan araçlar aracılığıyla mevcut çağrı bağlamı bilgilerini kullanır). | Transfer kararının kaydedildiğine dair onay. | KA, bildirim kurallarına uyar; diğerleri ise varsayılan olarak “mevcut” seçeneğine ayarlanır. |
perform_voicemail | Yok (İkincil, açıkta olmayan araçlar aracılığıyla mevcut çağrı bağlamı bilgilerini kullanır). | Sesli mesajla ilgili kararın kaydedildiğine dair onay. | KA, bildirim kurallarına uyar; diğerleri ise varsayılan olarak “mevcut” durumuna geçer. |
resolve_handoff_destination | hedef – Arayan tarafından belirtilen serbest metin biçimli hedef. | Döndürebilir: exact_contact, multiple_contacts, no_contact. | Gerekli: allowed_search=True |
Resolution: exact_contact ext|name|department|available|can_receive_email 801|Sales Team|Sales|true|false | |||
set_detected_language | dil – algılanan dilin adı. | Dilin kaydedildiğine dair onay. | Gerekli: switch_language=True |
spam_detected | neden – Aramanın neden spam olarak sınıflandırıldığına dair açıklama. | Spam sinyalinin kaydedildiğine dair onay. | |
take_handoff_decision | tür – aktarma, sesli posta, sohbet, e-posta. hedef – dahili numarası. | Devir kararının kaydedildiğine dair onay. | |
take_hostility_action | neden – tespit edilen düşmanca davranışın açıklaması. | Düşmanlık sinyalinin kaydedildiğinin onayı. | |
take_not_collaborative_action | neden – tespit edilen davranışın açıklaması. | İşbirliği sinyalinin kaydedildiğinin teyidi. | |
vector_store_search | vs_id – vektör deposu tanımlayıcısı . query – arama sorgusu. top_k –döndürülecek maksimum sonuç sayısı. | Relevant results retrieved from the specified vector store. | Bir veya daha fazla yapılandırılmış vektör deposu gerektirir. |
Ayrıca bakınız
Son Güncelleme
Bu belge en son 21 Ağustos 2026’da güncellendi.
https://www.3cx.com/docs/agentic-ai-tools/
