Ana içeriğe geç

Agent Node'u

Agent node'u, bir görevi tamamlamak için araçlar kullanabilen, konuşmayı hatırlayabilen ve birden fazla adım atabilen bir akıl yürüten yapay zekadır. Botun sabit bir senaryoyu takip etmek yerine hangi eylemi gerçekleştireceğine kendi başına karar vermesi gerektiğinde kullanın — bir bilgi tabanında arama yapma, harici bir servisi çağırma veya bir takip sorusu sorma gibi.

Bir akışa ekleme​

Canvas üzerine bir Agent node'u sürükleyin ve önceki node'un çıktısını ona bağlayın. Ardından bir model seçin, bir sistem istemi yazın ve (isteğe bağlı olarak) araçlar ile bellek ekleyin.

Node Ekle paletinde Agent node'u

Girdiler​

ParametreAçıklamaZorunlu
ModelAgent'ın akıl yürütmek ve yanıt vermek için kullandığı yapay zeka modeli. Bir sağlayıcı ve model seçin ve gerekiyorsa bir kimlik bilgisi ekleyin.Evet
MessagesAgent'ın davranışını şekillendiren önceden ayarlanmış mesajlar (System / Assistant / Developer / User) — sistem istemini burada yazarsınız.Hayır
OpenAI Dahili AraçlarYerel OpenAI yetenekleri (Web Araması, Kod Yorumlayıcı, Görüntü Oluşturma). Yalnızca model bir OpenAI modeli olduğunda kullanılabilir.Hayır
AraçlarAgent'ın çalışma zamanında çağırabileceği harici araçlar. Her araç, çalışmadan önce isteğe bağlı olarak insan onayı gerektirebilir.Hayır
Bilgi Tabanı (Doküman Depoları)Agent'a, arama yapabileceği bir veya daha fazla upsert edilmiş doküman deposundan bağlam sağlayın.Hayır
Knowledge (Vector Embeddings)Agent'a, mevcut bir vektör deposu ve gömme modelinden bağlam sağlayın.Hayır
Chat Geçmişi Belleğini EtkinleştirAgent'ın önceki mesajları hatırlaması için konuşma belleğini açın. Varsayılan olarak açık.Hayır
Chat Geçmişi Bellek TürüBelleğin nasıl tutulacağı: Tüm Mesajlar, Pencere Boyutu (son N), Konuşma Özeti veya Konuşma Özeti Tamponu.Hayır
Pencere BoyutuChat Geçmişi Bellek Türü, Pencere Boyutu olduğunda kaç adet son mesajın tutulacağı. Varsayılan 20.Hayır
Maksimum Token SınırıChat Geçmişi Bellek Türü, Konuşma Özeti Tamponu olduğunda özetlemeyi tetikleyen token eşiği. Varsayılan 2000.Hayır
Giriş MesajıAgent yanıt vermeden önce konuşmanın sonuna eklenen fazladan bir kullanıcı mesajı.Hayır
Yanıtı Şu Şekilde DöndürAgent'ın yanıtının bir Kullanıcı Mesajı olarak mı yoksa bir Asistan Mesajı olarak mı kaydedileceği. Varsayılan: Asistan Mesajı.Hayır
Akış DeğişkenleriBu node'un çalışırken güncellediği durum anahtarları, her biri bir değer ve isteğe bağlı bir "block empty updates" koruması ile.Hayır
Çıktıyı Sohbette GösterBu node'un çıktısının sohbet geçmişinde görünüp görünmeyeceği. Varsayılan olarak açık.Hayır

Çıktılar​

Agent node'unun tek bir çıktısı vardır. Agent'ın ürettiği her şey bir sonraki bağlı node'a akar. Yanıtın kendisi, kullandığı araçlar ve güncellediği durum, aşağı akışta ve yürütme izinde kullanılabilir.

Araçlar, bellek ve model​

  • Model — her Agent'ın bir modele ihtiyacı vardır. Bu, ne yapacağına karar veren "beyindir". Bir sağlayıcı seçme, kimlik bilgileri ekleme ve kullanım durumunuz için doğru modeli seçme konusunda bkz. Models.
  • Araçlar — agent'ın gerçekleştirmesine izin verilen eylemleri ekleyin. Agent her aracın açıklamasını okur ve onu ne zaman çağıracağına karar verir. Mevcut her şeye Araçlar kataloğu üzerinden göz atın. Ayrıca hassas bir araç için İnsan Girişi Gerektir'i açarak insan onayı zorunlu kılabilirsiniz.
  • Bellek — Chat Geçmişi Belleğini Etkinleştir açıkken, agent şimdiye kadarki konuşmayı görür. Uzun sohbetler için, maliyeti kontrol etmek amacıyla eski mesajları özetleyen veya pencereleyen bir Chat Geçmişi Bellek Türü seçin. Bkz. Bellek.
  • System prompt — agent'a kim olduğunu, tonunu ve kurallarını söylemek için rolü System olarak ayarlanmış Messages alanını kullanın.

Agent node config paneli — ChatOpenAI modeli ve bir System mesajı

Örnek​

Siparişleri arayabilen ve ürün sorularını yanıtlayabilen bir destek agent'ı:

  • Model: yetenekli bir sohbet modeli (örneğin bir OpenAI veya Gemini modeli)
  • Messages → System: "Sen Acme Store için dostça bir destek asistanısın. Aramadan önce daima sipariş numarasını onayla."
  • Araçlar: sipariş durumunu getiren bir HTTP Request aracı ve bir Google Sheets aracı
  • Bilgi Tabanı (Doküman Depoları): ürün SSS deposu
  • Chat Geçmişi Belleğini Etkinleştir: açık, Chat Geçmişi Bellek Türü "Tüm Mesajlar"

Agent, bir sorunun SSS'ye, sipariş aramasına mı yoksa doğrudan bir yanıta mı ihtiyaç duyduğuna kendi başına karar verir.

Model ve system prompt ile yapılandırılmış bir Agent node'u

İpuçları​

  • "Model is required" hatası görürseniz, model tam olarak ayarlanmamıştır — hem sağlayıcı hem de yapılandırması kaydedilecek şekilde modeli tekrar seçin.
  • Her araca net bir amaç verin. Agent araçları açıklamalarından seçer, bu nedenle belirsiz araçlar yanlış zamanda çağrılır.
  • Agent'ın yanıtının doğrudan müşteriye gönderilmesi gereken akışlar için, Agent'ı o yoldaki son node olarak yerleştirin.
  • Para harcayan veya mesaj gönderen araçlar için İnsan Girişi Gerektir'i açın, böylece bir kişi eylemi önce onaylar.

İlgili​