İçeriğe geç
OmniChannels.ai

Yapay zekâ asistanları ve ajanları

LangChain + OmniChannels.ai: ajanlarınız için mesajlaşma araçları

MCP ile bağlanınAPI ve webhook'larla bağlanınGüncelleme

Kısaca

LangChain ajanları OmniChannels.ai'yi uzak MCP sunucumuz üzerinden kullanır. langchain-mcp-adapters ile streamable_http taşımasını, https://mcp.broadnet.me/mcp URL'sini ve bir Authorization başlığını içeren bir MultiServerMCPClient girdisi; gönderim, şablon ve iletim raporu araçlarımızı ajanınıza yükler. Alternatif olarak, tam alanlar için OpenAPI 3.1 şemamızı kullanarak belirli REST API çağrılarını kendi araçlarınız olarak sarabilirsiniz.

Neler yapabilirsiniz?

  • Yalnızca okuma araçlı iletim destek ajanı

    Yalnızca okuma araçlarını yükleyin; ajan iletim sorularını yanıtlayabilir ama hiçbir şey gönderemez.

    Şunu sormayı deneyin

    “Yalnızca okuma araçlarını kullanarak iletim sorularını yanıtlayan ve mesaj gönderme taleplerini reddeden bir ajan oluştur.”

  • İnsan onaylı bildirim ajanı

    Gönderim aracı çağrılarından önce bir LangGraph interrupt kullanın; böylece her mesajı veya toplu gönderimi bir kişi onaylar.

    Şunu sormayı deneyin

    “WhatsApp sipariş bildirimlerinin taslağını hazırlayan ve herhangi bir gönderim aracını çağırmadan önce insan onayı için duran bir LangGraph ajanı oluştur.”

  • Şablon farkındalıklı gönderici

    Ajan onaylı WhatsApp şablonlarını listeler ve değişkenleri doldurur; böylece 24 saatlik pencere dışındaki, işletme tarafından başlatılan mesajlar onaylı bir şablon kullanır.

    Şunu sormayı deneyin

    “Teslimat gecikmesi için doğru onaylı Arapça WhatsApp şablonunu seçip yeni tarihle 966500000000 numarasına gönderen bir ajan yaz.”

  • MCP yerine dar kapsamlı REST araçları

    Alanlar, doğrulama ve günlükleme üzerinde tam denetim istediğinizde bir veya iki REST işlemini @tool fonksiyonu olarak sarın.

    Şunu sormayı deneyin

    “POST /sms/sendSms ile tekil SMS gönderen, numara biçimini doğrulayan ve BROADNET_TOKEN değerini ortamdan okuyan bir LangChain aracı yaz.”

  • Hata ayıklama ve sınıflandırma

    Ajan iletim raporlarını okur, hataları nedene göre gruplar ve hatalar rehberimizden çözüm önerir.

    Şunu sormayı deneyin

    “Dünkü iletim raporlarını okuyan, FAILED ve REJECTED mesajları nedene göre gruplayan ve operasyon kanalı için kısa bir özet yazan bir ajan oluştur.”

Nasıl bağlanır?

MCP ile bağlanınAPI ve webhook'larla bağlanın

langchain-mcp-adapters, MCP araçlarını LangChain araçlarına dönüştürür. transport değeri streamable_http, URL'si https://mcp.broadnet.me/mcp olan ve headers içinde ortamdan okunan jetonunuzla Authorization: Bearer bulunan bir sunucu girdisiyle bir MultiServerMCPClient yapılandırın, ardından get_tools çağırıp sonucu ajanınıza verin. Yeni LangChain sürümleri MCP desteğini ana pakette de sunar; önerilen içe aktarma için LangChain'in güncel dokümantasyonunu kontrol edin.

Modele hangi araçların ulaşacağını siz seçersiniz: listeyi ada göre filtreleyerek bir destek ajanının yalnızca okuma araçlarını almasını sağlayın ve her gönderimden önce bir onay adımı ekleyin. MCP kullanmak istemezseniz REST API'mizi Bearer jetonuyla çağıran kendi araçlarınızı yazın; tekil SMS JSON'dur, toplu ve diğer kanalların çoğu multipart/form-data kullanır.

  • MCP: MultiServerMCPClient, transport streamable_http, Authorization başlığı
  • Her ajana asgari yetki vermek için araçları ada göre filtreleyin
  • Gönderim araçlarından önce insan onayı ekleyin; örneğin LangGraph interrupt ile
  • REST alternatifi: OpenAPI 3.1 şemasından oluşturduğunuz kendi araçlarınız

Kurulum

  1. 1

    API erişimi talep edin

    Test erişimi talep edin ve bir API jetonu alın. Test gönderimleri yalnızca doğrulanmış kendi numaralarınıza gider.

  2. 2

    Geçici anahtar alın

    Yönetim portalında Integrations, ardından MCP Integration bölümünü açın, Get temporary key'i seçin ve BROADNET_TOKEN olarak tanımlayın.

    Rehber: MCP server for AI agents
  3. 3

    Adaptörleri kurun

    LangChain'in güncel dokümantasyonunu izleyerek langchain-mcp-adapters'ı veya sürümünüz sunuyorsa LangChain'in MCP ek paketini kurun.

  4. 4

    Araçları yükleyin

    transport değeri streamable_http olan, URL'mizi ve Authorization başlığını içeren bir MultiServerMCPClient girdisi oluşturun, ardından get_tools çağırın.

    Rehber: MCP server for AI agents
  5. 5

    Kısıtlayın ve onay ekleyin

    Yalnızca ajanın ihtiyaç duyduğu araçları verin ve gönderim yapan her aracın önüne bir insan onayı adımı koyun.

  6. 6

    Kendi numaranızda test edin

    Erişimi genişletmeden önce ajanı doğrulanmış numaranıza karşı çalıştırın ve iletim raporunu kontrol edin.

Üretici belgeleri

LangChain, sahibinin ticari markasıdır. OmniChannels.ai, LangChain ile bağlantılı değildir ve LangChain tarafından onaylanmamıştır; bu sayfa, LangChain'in kendi MCP, HTTP veya webhook özellikleriyle kurulan bir bağlantıyı açıklar.

Örnek iş akışı

Tipik bir isteğin LangChain üzerinden müşterinize ve geri nasıl ilerlediği.

  1. 01

    LangChain ajanınız

    MCP ile yüklenen araçlara sahip Python veya JS ajanı

  2. 02

    OmniChannels.ai MCP sunucusu

    Gönderim, şablon ve iletim raporu araçları

  3. 03

    Müşterinin telefonu

    WhatsApp, SMS veya RCS mesajı iletildi

  4. 04

    İletim raporu

    Ajan tarafından geri okunur veya webhook'unuza iletilir

1. LangChain ajanınız: MCP ile yüklenen araçlara sahip Python veya JS ajanı 2. OmniChannels.ai MCP sunucusu: Gönderim, şablon ve iletim raporu araçları 3. Müşterinin telefonu: WhatsApp, SMS veya RCS mesajı iletildi 4. İletim raporu: Ajan tarafından geri okunur veya webhook'unuza iletilir

Sorular

LangChain için resmi bir OmniChannels.ai paketi var mı?

Hayır. LangChain, genel MCP adaptörleri üzerinden herkese açık uç noktamız ve API jetonunuzla ya da REST API'mize karşı kendiniz yazdığınız araçlar üzerinden bağlanır.

MCP araçlarını mı yoksa kendi REST araçlarımı mı kullanmalıyım?

MCP, ajana tüm araç setimizi az kodla verir. Kendi REST araçlarınız alanlar, doğrulama ve günlükleme üzerinde daha sıkı denetim sağlar. Birçok ekip MCP ile başlar ve güvendiği araçları dar kapsamlı REST araçlarıyla değiştirir.

Ajanın yanlışlıkla mesaj göndermesini nasıl önlerim?

Yalnızca ihtiyaç duyduğu araçları verin, yalnızca soru yanıtlayan ajanlardan gönderim araçlarını çıkarın ve her gönderimden önce insan onayı isteyin. Test sırasında geçici bir anahtar ve kendi numaralarınızı kullanın.

Ajan bu sunucu üzerinden CRM'imi veya sipariş verilerimi okuyabilir mi?

Hayır. Sunucumuz yalnızca mesajlaşmayı, şablonları ve iletim raporlarını kapsar. CRM veya mağaza verilerinizi kendi LangChain araçlarıyla ya da MCP sunucusuyla yükleyin; ajan bunları birleştirir.

API ve MCP erişimi alın

Kanallarınızı, ülkelerinizi ve kullanım senaryonuzu bize söyleyin. Bir mühendis test kimlik bilgilerini verir ve test numaralarınızı doğrular.