Beri agen LangChain nomor WhatsApp

Bagaimana agen LangChain memuat tool WhatsApp?

Lewat MCPAdapter, klien MCP milik LangChain, yang menyerahkan tool dari sebuah server MCP ke create_agent sebagai tool LangChain biasa. Ia membutuhkan langchain[mcp] versi 1.4.0 atau lebih baru dan masih berstatus beta.

Autentikasi diserahkan ke FastMCP. Dengan auth="oauth" pada klien, alur OAuth 2.1 penuh berjalan: discovery, dynamic client registration, pengalihan browser, dan pertukaran token. Itulah yang diharapkan server MCP EasyCoexistence, jadi tidak ada kunci yang perlu dibuat atau ditempel. Secara default token disimpan di memori dan setiap proses mengulang langkah browser; penyedia OAuth FastMCP dengan token store menyimpannya di antara proses.

Setelah dimuat, agen melihat tool beserta deskripsinya: list_numbers lebih dulu, karena setiap tool lain membutuhkan connection_id darinya, lalu send_message, send_template, list_templates, get_number_health, dan seterusnya.

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)

Bagaimana pesan WhatsApp masuk sampai ke agen?

Lewat webhook, karena MCP tidak bisa melakukannya. Protokolnya berupa permintaan dan respons, sehingga tidak ada cara bagi server untuk membangunkan klien saat pelanggan menulis.

Atur tujuan webhook nomor ke sebuah route di aplikasi Anda sendiri, dengan secret acak yang panjang di path URL. Route menjawab GET verifikasi dari Meta dengan challenge apa adanya, menerima setiap POST, langsung mengembalikan 200, dan memasukkan pekerjaan ke antrean. Worker kemudian mengambil pengirim dan teks dari payload lalu memanggil agen dengan keduanya, memakai nomor pengirim sebagai thread id agar memori tetap per pelanggan.

Periksa secret di URL, bukan header X-Hub-Signature-256. Meta menandatangani dengan app secret milik Tech Provider, yang tidak pernah dibagikan, sehingga pelanggan tidak bisa memvalidasi header itu.

Sebaiknya agen mengirim lewat MCP atau lewat Cloud API?

Keduanya bisa, dan bedanya ada pada siapa yang memegang aturan. Tool MCP membawa aturan WhatsApp dalam deskripsinya, misalnya send_message hanya berfungsi di dalam jendela 24 jam dan send_template adalah cara menjangkau orang yang belum menulis. Model yang membaca deskripsi itu biasanya memilih yang tepat, dan itu berguna saat agen memutuskan secara bebas.

Tool sederhana milik Anda sendiri yang mengirim ke endpoint pesan Cloud API dengan token nomor lebih mudah bila tugas agen sempit, misalnya selalu membalas orang yang baru saja menulis. Pemeriksaan jendela lalu berada di kode Anda, tempat yang tepat untuk aturan yang tidak boleh dilanggar. Teks bebas di luar jendela kembali sebagai kesalahan 131047, dan pelanggan tidak melihat apa pun.

Kesalahan umum

• Mengira MCP akan mengantarkan pesan masuk. Tanpa route webhook, agen tidak pernah mendengar kabar dari pelanggan.
• Membiarkan token OAuth di memori pada server. Setiap restart meminta login browser lagi; simpan dengan token store.
• Memakai satu thread untuk semua pelanggan. Kaitkan memori agen dengan nomor pengirim.

Pertanyaan yang sering diajukan

Lanjut membaca