LangChain agent'ına bir WhatsApp numarası verin

LangChain agent'ı WhatsApp araçlarını nasıl yükler?

LangChain'in MCP istemcisi olan MCPAdapter ile. Bu istemci bir MCP sunucusunun araçlarını create_agent'a sıradan LangChain araçları olarak verir. langchain[mcp] paketinin 1.4.0 veya üzeri bir sürümünü gerektirir ve beta olarak işaretlidir.

Kimlik doğrulama FastMCP'ye devredilir. İstemcide auth="oauth" vermek OAuth 2.1 akışının tamamını çalıştırır: keşif, dinamik istemci kaydı, tarayıcı yönlendirmesi ve token değişimi. EasyCoexistence MCP sunucusunun beklediği de budur, bu yüzden oluşturup yapıştıracağınız bir anahtar yoktur. Varsayılan olarak token'lar bellekte durur ve her çalıştırmada tarayıcı adımı yinelenir. Token deposu olan bir FastMCP OAuth sağlayıcısı bunları çalıştırmalar arasında saklar.

Yüklendikten sonra agent araçları açıklamalarıyla görür: önce list_numbers, çünkü diğer tüm araçlar bu araçtan bir connection_id alır. Ardından send_message, send_template, list_templates, get_number_health ve diğerleri gelir.

from fastmcp.client import Client
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

async def build_agent(model: str):
    async with MCPAdapter(Client(URL, auth="oauth")) as adapter:
        tools = await adapter.list_tools()
        return create_agent(model, tools)

Gelen bir WhatsApp mesajı agent'a nasıl ulaşır?

Webhook ile, çünkü MCP bunu yapamaz. Protokol istek ve yanıt temellidir, bu yüzden bir müşteri yazdığında sunucunun istemciyi uyandırmasına izin veren hiçbir şey yoktur.

Numaranın webhook hedefini kendi uygulamanızdaki bir rotaya ayarlayın ve URL yoluna uzun, rastgele bir gizli anahtar koyun. Rota, Meta'nın doğrulama GET isteğine ham challenge değeriyle yanıt verir, her POST isteğini kabul eder, hemen 200 döndürür ve işi kuyruğa alır. Ardından bir worker payload'dan gönderen numarasını ve metni alır, agent'ı bunlarla çalıştırır. Thread id olarak gönderenin numarası kullanılır, böylece bellek müşteri başına ayrı kalır.

Gizli anahtarı X-Hub-Signature-256 başlığı yerine URL'de doğrulayın. Meta, Tech Provider'ın hiç paylaşılmayan uygulama gizli anahtarıyla imzalar, bu yüzden müşteri o başlığı doğrulayamaz.

Agent mesajı MCP üzerinden mi, Cloud API üzerinden mi göndermeli?

İkisi de çalışır, fark kuralları kimin tuttuğundadır. MCP araçları WhatsApp kurallarını açıklamalarında taşır: send_message yalnızca 24 saatlik pencere içinde çalışır, send_template ise yazmamış birine ulaşmanın yoludur. Bu açıklamaları okuyan model çoğu zaman doğru aracı seçer ve agent'ın serbestçe karar verdiği durumlarda bu işe yarar.

Agent'ın işi dardır, örneğin hep az önce yazan kişiye yanıt vermektir, böyle durumlarda numaranın token'ı ile Cloud API mesaj uç noktasına istek gönderen kendi basit aracınız daha kolaydır. O zaman pencere kontrolü kendi kodunuzda olur ve asla bozulmaması gereken bir kuralın yeri de burasıdır. Pencere dışındaki serbest metin 131047 kodlu hatayla geri döner ve müşteri hiçbir şey görmez.

Yaygın hatalar

• MCP'nin gelen mesajları ileteceğini sanmak. Webhook rotası olmadan agent bir müşteriden hiç haber alamaz.
• OAuth token'larını bir sunucuda bellekte bırakmak. Her yeniden başlatma tarayıcıyla yeniden giriş ister, bunları bir token deposunda saklayın.
• Tüm müşteriler için tek bir thread kullanmak. Agent'ın belleğini gönderenin numarasına göre ayırın.

Sık sorulan sorular

Okumaya devam edin