Bigyan ng WhatsApp na numero ang isang LangChain agent

Paano nilo-load ng LangChain agent ang mga WhatsApp tool?

Sa pamamagitan ng MCPAdapter, ang MCP client ng LangChain, na ibinibigay ang mga tool ng isang MCP server sa create_agent bilang karaniwang LangChain tools. Kailangan nito ang langchain[mcp] na bersyon 1.4.0 o mas bago, at nakamarka itong beta.

Iniaatas sa FastMCP ang authentication. Kapag nilagay ang auth="oauth" sa client, tatakbo ang buong OAuth 2.1 flow: discovery, dynamic client registration, browser redirect at token exchange. Iyon mismo ang inaasahan ng EasyCoexistence MCP server, kaya walang key na gagawin o ipe-paste. Bilang default, nasa memory lang ang mga token at inuulit ng bawat takbo ang hakbang sa browser. Kung gagamit kayo ng FastMCP OAuth provider na may token store, mananatili ang mga ito sa pagitan ng mga takbo.

Pagkatapos ma-load, makikita ng agent ang mga tool kasama ang kanilang paglalarawan: una ang list_numbers, dahil ang bawat ibang tool ay kumukuha ng connection_id mula rito, saka send_message, send_template, list_templates, get_number_health at iba pa.

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)

Paano nakararating sa agent ang papasok na mensahe sa WhatsApp?

Sa pamamagitan ng webhook, dahil hindi ito kayang gawin ng MCP. Request at sagot ang protocol, kaya walang paraan para magising ng isang server ang client kapag sumulat ang customer.

Itakda po ang webhook destination ng numero sa isang route sa sarili ninyong application, na may mahaba at random na secret sa URL path. Sasagutin ng route ang verification GET ng Meta gamit ang raw challenge, tatanggapin ang bawat POST, agad magbabalik ng 200 at ipapasok sa queue ang trabaho. Pagkatapos, kukunin ng isang worker ang nagpadala at ang teksto mula sa payload at i-i-invoke ang agent gamit ang mga ito, na ang numero ng nagpadala ang thread id para manatiling hiwalay ang memory kada customer.

I-check ang secret sa URL sa halip na ang X-Hub-Signature-256 header. Pumipirma ang Meta gamit ang app secret ng Tech Provider, na hindi kailanman ibinabahagi, kaya hindi ito mave-validate ng customer.

Dapat bang magpadala ang agent sa pamamagitan ng MCP o ng Cloud API?

Parehong gumagana, at ang pagkakaiba ay kung sino ang may hawak ng mga patakaran. Dala ng MCP tools ang mga patakaran ng WhatsApp sa kanilang paglalarawan, gaya ng send_message na gumagana lamang sa loob ng 24 oras na window at ng send_template bilang paraan para maabot ang taong hindi pa sumusulat. Karaniwang napipili ng model ang tama kapag binasa ang mga paglalarawang iyon, at nakatutulong ito kapag malayang nagpapasya ang agent.

Mas simple ang sarili ninyong tool na nagpo-post sa messages endpoint ng Cloud API gamit ang token ng numero kapag makitid ang trabaho ng agent, gaya ng laging pagsagot sa taong kasusulat lang. Sa ganitong paraan, nasa code ninyo ang pag-check ng window, na siyang tamang lugar para sa patakarang hindi dapat labagin. Ang free-form text sa labas ng window ay bumabalik na may error 131047, at walang makikita ang customer.

Mga karaniwang pagkakamali

• Pag-asang maghahatid ang MCP ng mga papasok na mensahe. Kung walang webhook route, hindi kailanman makakarinig ang agent mula sa customer.
• Pag-iwan ng mga OAuth token sa memory ng isang server. Bawat restart ay hihingi ng sign-in sa browser; i-persist ang mga ito gamit ang token store.
• Paggamit ng iisang thread para sa lahat ng customer. Gamitin ang numero ng nagpadala bilang key ng memory ng agent.

Mga madalas itanong

Magpatuloy sa pagbabasa