AI Ajanlar

AI ajan, çok adımlı çalışan bir asistandır. Konuşmayı okur, plan yapar, araçları (yapay zeka araçlarınızı, MCP araçlarını ve bilgi tabanı aramasını) çağırır, sonuçlara bakar ve bir yanıta ulaşana kadar modeli yeniden çağırır. Yapay Zeka Sohbet Tamamlama Oluştur düğümü tek bir model çağrısı yapıp yanıt verir; AI Ajan düğümü ise sizin belirlediğiniz sınırlar içinde birden çok model ve araç çağrısıyla çalışmaya devam edip sonra yanıt verebilir.

Bir istek birkaç adım gerektiriyorsa ajan kullanın; örneğin "müşterinin siparişini bul, teslimat durumunu kontrol et ve yeni bir tarih öner". Talimatlardan ve bir bilgi tabanından doğrudan yanıt vermek için AI düğümü daha basit ve daha ucuzdur.

Yapı taşları

Parça	Nedir	Nerede ayarlanır
AI Harness	Ajan döngüsünü çalıştıran motor: MonoChat'in kendi motoru, bir ajan SDK'sı veya barındırılan bir ajan servisi.	Ayarlar › Otomasyon › AI Harness'lar
Modeller	Ajanın düşünürken kullandığı yapay zeka modelleri: bir ana model, isteğe bağlı bir yedek model ve isteğe bağlı bir hızlı model. Barındırılan harness'lar bunun yerine kendi sağlayıcılarının modellerini kullanır.	AI Ajan düğümü
Araçlar	Yapay zeka kapsamları, Yapay Zeka Aracı fonksiyonları ve MCP araçları.	AI Ajan düğümü
Çalışma Bütçesi	Her çalıştırma için model çağrısı, araç çağrısı, token, süre ve yeniden deneme sınırları.	AI Ajan düğümü
Çalıştırma	Ajanın bir kez çalışması. Her çalıştırma AI Ajan Çalıştırmaları bölümüne kaydedilir.	Düğüm veya API tarafından oluşturulur

AI Harness'lar

Ayarlar › Otomasyon › AI Harness'lar bölümü ajanlarınızın çalışabileceği harness'ları listeler: MonoChat'in tüm çalışma alanlarına sunduklarını ve sizin kendi kimlik bilgilerinizle eklediklerinizi.

Harness	Nerede çalışır	Kullandığı modeller	Kim ekler
MonoChat Native	MonoChat içinde	Yapay zeka modelleriniz	MonoChat
OpenAI Agents SDK	MonoChat içinde	Yapay zeka modelleriniz	MonoChat
Claude Agent SDK	MonoChat ajan sunucusunda	Yapay zeka modelleriniz	MonoChat
pi	MonoChat ajan sunucusunda	Yapay zeka modelleriniz	MonoChat
OpenAI Agents API	OpenAI'ın bulutunda	Harness'ın izin verilen modelleri	Siz, OpenAI API anahtarınızla (MonoChat da sunabilir)
Claude Managed Agents	Anthropic'in bulutunda	Harness'ın izin verilen modelleri	Siz, Anthropic API anahtarınızla (MonoChat da sunabilir)
Özel Uç Nokta	Kendi sunucunuzda	Yapay zeka modelleriniz (isteğe bağlı)	Siz, uç noktanız ve gizli anahtarınızla

MonoChat üzerinde çalışan harness'lar MonoChat tarafından sunulur; çalışma alanınız yalnızca kendi kimlik bilgilerini alan harness'ları ekleyebilir. Claude Agent SDK ve pi, MonoChat'in ajan sunucusuna ihtiyaç duyar; bu sunucunun kurulu olmadığı yerde bunlarla yapılan çalıştırma "Bu harness bu sunucuda kullanılamıyor." hatasıyla başarısız olur.

Harness hangisi olursa olsun kontrol MonoChat'tedir: yapay zeka modellerinizi kullanan bir harness'ın her model çağrısı MonoChat üzerinden geçer (bu yüzden faturalandırma ve bütçe geçerlidir), her araç çağrısı çalışma alanınızdaki fonksiyonları, MCP araçlarını ve yapay zeka kapsamlarını çalıştırır ve bütçe her harness'ta uygulanır.

Harness ekleme

1. Ayarlar › Otomasyon › AI Harness'lar bölümüne gidin ve + (Oluştur) düğmesine tıklayın.
2. Bir İsim ve isterseniz Açıklama girin.
3. Harness seçin. Her seçenek nerede çalıştığını belirtir.
4. Kimlik Bilgileri altında harness'ın istediklerini girin:
   • OpenAI Agents API, Claude Managed Agents: API Anahtarı.
   • Özel Uç Nokta: Uç Nokta ve API Anahtarı.
5. Barındırılan bir harness için İzin Verilen Modeller'i doldurun: sağlayıcının model adlarını (örneğin OpenAI veya Anthropic model kimliğini) girin. Model Ekle ile en fazla 10 model ekleyebilirsiniz. Bu harness'taki ajanlar yalnızca bu listeden seçim yapabilir.
6. Kaydet'e tıklayın.

Bir harness'ı düzenlerken Harness tipi değiştirilemez ve anahtar alanı API Anahtarı (kayıtlı anahtarı korumak için boş bırakın) olarak görünür.

Claude Managed Agents

Bu tipteki bir harness ilk kez kullanıldığında MonoChat o Anthropic hesabında bir ajan ve bir ortam oluşturur ve sonraki çalıştırmalarda bunları yeniden kullanır.

Özel Uç Nokta

Özel Uç Nokta harness'ı çalıştırmaları kendi servisinize, örneğin kendi sunucunuzda çalışan bir ajana gönderir. MonoChat her çalıştırma için <Uç Nokta>/runs adresine Authorization: Bearer <API Anahtarı> başlığıyla bir POST isteği gönderir. Gövdede çalıştırma ID'si, talimatlar, girdi, konuşma mesajları, bütçe, model takma adları (agent-main, agent-fallback, agent-fast) ve bu çalıştırmaya özel bir token ile üç adres bulunur:

• düğümün yapay zeka modellerini çağıran ve bütçeyi uygulayan bir model geçidi (OpenAI uyumlu …/v1 ve Anthropic uyumlu temel adresler),
• çalıştırmanın araçlarını sunan bir MCP sunucusu,
• servisinizin sonucu bildirdiği bir olay adresi (result ile completed veya error ile failed).

Çalıştırma bittiğinde token geçersiz olur.

AI Ajan düğümü

Bir akışa ajan eklemek için akış tasarımcısında hibrit düğümler altındaki AI Ajan düğümünü kullanın. Düğüm ekleme ve bağlama için bkz. Akışlar.

Alanlar

Bölüm	Alan	Açıklama
	İsim	Tuvalde görünen düğüm adı.
	AI Harness	Zorunlu. Ajanı çalıştıran harness.
	Talimatlar	Ajanın sistem talimatları: rolü, üslubu, kuralları, neyi yapıp neyi yapamayacağı.
	Görev (ajan talimatlarına eklenir; etiket kullanılabilir)	Bu düğümün ajandan istediği iş. Talimatlardan sonra eklenir ve AI düğümünün isteminde kullanılan etiketleri, örneğin müşteri bilgilerini eklemek için kullanabilir.
Modeller	Ana Model	Ajanın kullandığı model. Özel Uç Nokta dışındaki her harness için zorunludur.
	Yedek Model (esnek limitten sonra)	Ajanın esnek model çağrısı limitine ulaştığında geçtiği model; genellikle daha ucuz veya daha hızlı bir model.
	Hızlı Model (hafif arka plan işleri)	Bir harness'ın hafif arka plan çağrıları için kullanabileceği model.
	Model (harness'ın izin verilen modellerinden biri)	Barındırılan bir harness için yukarıdaki üç alanın yerine gösterilir.
Ajan Oturumu	Oturum	Mevcut ajan oturumuna devam et (varsayılan) veya Yeni ajan oturumu başlat. Bkz. Ajan oturumları.
	Görev Anahtarı (her görev için ayrı ajan oturumu)	İsteğe bağlı. Aynı konuşmada her anahtar için ayrı bir ajan oturumu tutar, örneğin booking ve support.
	Mesaj Geçmişi Sınırı	Ajanın alacağı konuşma mesajı sayısı.
	Yapay Zeka Ses-Metin Modelleri	Transkript özellikli bir model. Konuşmadaki sesli mesajlar ajana metin olarak ulaşır.
Araç Ayarları	Yapay Zeka Kapsamları	Ajanın arayabileceği bilgi tabanları. Ajana bir bilgi tabanı arama aracı olarak sunulur.
	Yapay Zeka Aracı	Ajanın çağırabileceği Yapay Zeka Aracı tipindeki fonksiyonlar.
	Yapay Zeka MCP İçerik Araçlarını Ayarla	MCP araçlarını eklediğiniz paneli açar. Bkz. MCP İstemcileri.
Mesajlar	Ara Mesajları Müşteriye İlet	Varsayılan olarak kapalıdır. Ajanın çalışırken yazdıkları (örneğin "Siparişinizi kontrol ediyorum") açıkken müşteriye gönderilir; kapalıyken oturuma yalnızca ekibinizin gördüğü fısıltı mesajı olarak eklenir.
	Cevap gönder	Varsayılan olarak açıktır. Ajanın son yanıtını müşteriye gönderir. Yanıtı yalnızca akış içinde kullanmak için kapatın.
Çalışma Bütçesi	Maks. Model Çağrısı	Varsayılan 4.
	Esnek Limit: Model Çağrısı	İsteğe bağlı. Bu kadar model çağrısından sonra ajan yedek modele geçer. Maks. Model Çağrısı'ndan küçük olmalı ve bir yedek model gerektirir.
	Araç Çağrısı Limit	Varsayılan 6. 0 olduğunda ajan bir araç çağırmaya çalıştığı anda çalıştırma Bütçe aşıldı ile biter.
	Maks. Toplam Token	Varsayılan 20000. Çalıştırmadaki tüm model çağrılarının girdi ve çıktı token'ları.
	Maks. Süre (Saniye)	Varsayılan 30.
	Maksimum Çağrı Sayısı	Varsayılan 2. Başarısız bir model çağrısının kaç kez yeniden deneneceği.

ipucu

Değişmeyen kuralları Talimatlar'a, bu adımın özel işini Görev'e yazın. Böylece bir akıştaki birden çok AI Ajan düğümü aynı talimatları paylaşıp yalnızca görevleriyle ayrışabilir.

uyarı

Barındırılan harness'lar yedek modele geçemedikleri için esnek limiti desteklemez. Onlar için Esnek Limit: Model Çağrısı alanını boş bırakın.

Akış düğüme ulaştığında ne olur

1. MonoChat bakiyenizi ve düğümün ayarlarını kontrol eder ve bir çalıştırma başlatır. Çalıştırma önce Sırada, sonra Çalışıyor durumundadır. Akış örneği düğümde bekler.
2. Ajan talimatları ve görevi alır; akış bir konuşmaya aitse Mesaj Geçmişi Sınırı kadar konuşma mesajını da alır, sesli mesajlar metne çevrilmiş olarak gelir.
3. Ajan bir yanıta ulaşana veya bir sınıra takılana kadar modelleri ve araçları çağırır. Araç çağrıları arasında yazdığı metinler ara mesaj olarak işlenir.
4. Çalıştırma bittiğinde:
   • Tamamlandı ise ve Cevap gönder açıksa yanıt müşteriye gönderilir. Kanalın sınırını aşan uzun yanıtlar birkaç mesaja bölünür (WhatsApp'ta 4096 karakter);
   • başka bir şekilde bittiyse oturuma ekibiniz için "AI ajan çalışması sona erdi: durum. hata" fısıltı mesajı eklenir.
5. Akış, çalıştırmanın bitiş şekline karşılık gelen çıkıştan devam eder.

Aynı ajan oturumunun çalıştırmaları sırayla, birer birer işlenir.

Çıkışlar

Çıkış	Ne zaman
Tamamlandı	Ajan bir yanıtla bitirdi.
Bütçe Aşıldı	Çalıştırma Maks. Model Çağrısı, Araç Çağrısı Limit veya Maks. Toplam Token sınırını doldurdu.
Süre Doldu	Çalıştırma Maks. Süre (Saniye) sınırına ulaştı.
Nefret, Güvenlik İhlali, Kendine Zarar Verme, Cinsel, Şiddet	Model sağlayıcısının içerik filtresi çalıştırmayı bu kategori nedeniyle durdurdu. AI düğümündeki çıkışların aynısıdır.
Başarısız Olduğunda	Çalıştırma başka bir nedenle başarısız oldu veya iptal edildi. Bu çıkışlar eklenmeden önce kaydedilmiş düğümlerde içerik filtresi durdurmaları da buraya gider; bu çıkışları almak için düğümü açıp kaydedin.

En azından Tamamlandı ve Başarısız Olduğunda çıkışlarını bağlayın. Yaygın bir kullanım, Bütçe Aşıldı, Süre Doldu ve Başarısız Olduğunda çıkışlarını bir ekip arkadaşının devralması için bir Oturum Ata düğümüne bağlamaktır.

Ajan oturumları

Ajan oturumu, ajanın çalıştırmalar arasındaki hafızasıdır. MonoChat her konuşma, harness ve görev anahtarı için bir etkin ajan oturumu tutar.

• Mevcut ajan oturumuna devam et bu oturumu yeniden kullanır; ajan kaldığı yerden devam eder. Barındırılan harness'larda sağlayıcının kendi oturumu da devam eder.
• Yeni ajan oturumu başlat etkin oturumu kapatıp sıfırdan başlar; örneğin yeni bir konunun başında.
• Görev Anahtarı, aynı konuşmada bağımsız oturumları yan yana tutar.

Faturalandırma

• MonoChat'in sunduğu yapay zeka modelleri üzerindeki model çağrıları her zamanki gibi bakiyenizden faturalanır. Kendi modellerinizdeki çağrıları sağlayıcınız faturalar.
• MonoChat'in sunduğu bir harness çalıştırma başına, dakika başına ve araç çağrısı başına kendi ücretlerini, barındırılan bir harness ise sağlayıcısının bildirdiği token'ları ekleyebilir. Bunlar İşlemler sayfasında AI Ajan Çalıştırma, AI Ajan Süresi, AI Ajan Araç Çağrısı ve yapay zeka token kategorileriyle görünür.
• Kendi kimlik bilgilerinizle eklediğiniz bir harness'ın MonoChat ücreti yoktur; sağlayıcısı sizi faturalar.
• Bakiyeniz yetersizse çalıştırma başlamaz.

AI Ajan Çalışması Bitti olayı

AI Ajan Çalışması Bitti bir olay düğümüdür. Bir müşteriye bağlı bir çalıştırma bittiğinde tetiklenir; çalıştırma ister bir akış tarafından ister bir oturumla API üzerinden başlatılmış olsun. Diğer olay düğümleri gibi isteğe bağlı Koşul ve Zaman Aşımı ayarları vardır. Ajan çalıştırmalarından sonra ayrı bir akış başlatmak, örneğin sonuçları kaydetmek veya bir ekibi bilgilendirmek için kullanın.

Ajanı koddan başlatma

Özel fonksiyonlar ve API istemcileri ajanları şu metotlarla çalıştırabilir (yetkiler: Otomasyonda AI ajan çalıştır, Otomasyondaki AI ajan çalışmalarını görüntüle, Otomasyondaki AI ajan çalışmalarını iptal et):

Metot	Ne yapar
business.tenants.automation.ai.aiAgentRuns.create	Bir çalıştırma başlatır. aiAgentRunId ve aiAgentSessionId döndürür.
business.tenants.automation.ai.aiAgentRuns.show	Bir çalıştırmayı (_id) durumu, kullanımı, adımları ve sonucuyla döndürür.
business.tenants.automation.ai.aiAgentRuns.cancel	Sırada bekleyen veya çalışan bir çalıştırmayı (_id) iptal eder.

create; aiHarnessClientId, input (görev), isteğe bağlı olarak sessionId (bir konuşmada çalışmak için), aiAgentSessionId, taskKey ve isNewSession ile düğümdeki ayarların aynısını içeren options alır: instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer ve zorunlu budget. API üzerinden forwardIntermediateMessages ve willSendAnswer varsayılan olarak false olur.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Bu müşterinin açık siparişlerini özetle.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'Mağazamızın sipariş asistanısın.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

Çalıştırma eşzamansızdır: sonucu daha sonra show ile okuyun veya AI Ajan Çalışması Bitti olayıyla karşılık verin. sessionId olmadan her çağrı, önceki bir çağrının döndürdüğü aiAgentSessionId değerini vermediğiniz sürece yeni bir ajan oturumu başlatır; verdiğinizde ajan o oturumun daha önce tamamlanmış çalıştırmalarını geçmiş olarak görür. Bir fonksiyondan metot çağırmak için bkz. Method.

Yetkiler

Yetki	İzin verdiği
Otomasyondaki AI harness'ları görüntüle / güncelle / sil, Otomasyonda AI harness oluştur	AI Harness'lar bölümünü yönetmek
Otomasyondaki AI ajan çalışmalarını görüntüle	AI Agent Çalıştırmaları bölümünü görmek
Otomasyonda AI ajan çalıştır	aiAgentRuns.create çağırmak
Otomasyondaki AI ajan çalışmalarını iptal et	aiAgentRuns.cancel çağırmak

Bkz. Roller.

İlgili sayfalar

• AI Ajan Çalıştırmaları: her çalıştırmanın ne yaptığını görün
• Yapay Zeka Modelleri
• MCP İstemcileri
• Yapay Zeka Kapsamları
• Akışlar