Vercel AI SDK-இல் சமூக ஊடகக் கருவிகள்: Instagram, TikTok மற்றும் பிற
Vercel AI SDK, easyCoexistence-இன் MCP சர்வரிலிருந்து Instagram, TikTok, Facebook, WhatsApp மற்றும் பிற சேனல்களுக்கான சமூக ஊடகக் கருவிகளைப் பெறுகிறது. @ai-sdk/mcp தொகுப்பிலுள்ள createMCPClient, https://easycoexistence.com/api/mcp-க்கு HTTP இணைப்பைத் திறக்கிறது. நீங்கள் எழுதும் OAuthClientProvider உள்நுழைவைக் கவனித்துக்கொள்கிறது. கிளையண்டின் tools() கருவிகள் generateText அல்லது streamText-இல் சேர்க்கப்பட்டு, ஒவ்வொரு நெட்வொர்க்கின் அதிகாரப்பூர்வ API வழியாக வெளியிடவும், திட்டமிடவும், கருத்துகளுக்கும் DM-களுக்கும் பதிலளிக்கவும், நுண்ணறிவுகளைப் படிக்கவும் பயன்படுகின்றன.
@ai-sdk/mcp செயல்பாடு, serverUrl மற்றும் authorizationCode-இலிருந்து OAuth கால்பேக்கை முடிக்கிறது; இருந்தால் callbackState மற்றும் callbackIssuer-உம் சேர்த்து.
generateText-இன் இயல்புநிலை stopWhen: stopWhen கூடுதல் படிகளை அனுமதிக்கும் வரை மாதிரி ஒரு கருவியின் முடிவைப் படிக்காது.
AI SDK உற்பத்திக்குப் பரிந்துரைக்கும் MCP போக்குவரத்து; அதன் stdio போக்குவரத்து உள்ளூர் சர்வர்களுக்கு மட்டுமே.
easyCoexistence MCP அணுகல் டோக்கனின் ஆயுள்; அதன் ரீஃப்ரெஷ் டோக்கன் 60 நாட்கள் நீடிக்கும், ஒவ்வொரு ரீஃப்ரெஷிலும் மாற்றப்படும்.
ஒரு Instagram DM கொண்டுசெல்லக்கூடிய அதிகபட்ச உரை, UTF-8 அளவில் அளக்கப்படுகிறது; எனவே உச்சரிப்புக் குறிகளும் emoji-களும் அதிக இடம் எடுக்கும்.
AI SDK easyCoexistence-இல் எவ்வாறு உள்நுழைகிறது?
AI SDK-இன் auth() செயல்பாடு இயக்கும், நீங்கள் உங்கள் சொந்தச் சேமிப்பகத்தின் மேல் செயல்படுத்தும் OAuthClientProvider வழியாக. முதல் அழைப்பு உங்கள் செயலியை easyCoexistence-இல் பொது கிளையண்டாகப் பதிவு செய்கிறது, PKCE verifier-ஐச் சேமிக்கிறது, redirectToAuthorization வழியாக ஒப்புதல் URL-ஐத் தருகிறது. அது REDIRECT திருப்பும், உங்கள் வழி பயனரை அங்கே அனுப்புகிறது. easyCoexistence ஒரு code உடன் உங்கள் கால்பேக்குக்குத் திருப்பிவிடுகிறது; authorizationCode உடன் இரண்டாவது auth() அழைப்பு அதை டோக்கன்களுக்கு மாற்றுகிறது. டோக்கன்கள் சேமிக்கப்பட்ட பிறகு, auth() பயனரை மீண்டும் அனுப்பாமல் ரீஃப்ரெஷ் டோக்கன் மூலம் புதிய ஜோடியைப் பெறுகிறது. redirectUrl மற்றும் பதிவு செய்யப்பட்ட redirect_uris ஒரே மாதிரி இருக்கட்டும்; easyCoexistence அவற்றை அப்படியே பொருத்துகிறது.
import { auth, type OAuthClientProvider } from "@ai-sdk/mcp";
export const MCP_URL = "https://easycoexistence.com/api/mcp";
const CALLBACK = "https://app.example.com/api/easycoexistence/callback";
// db is your own key-value store (Postgres, Redis, Vercel KV); one set of keys per user
export function easyAuth(userId: string): OAuthClientProvider {
const k = (name: string) => "easycoexistence:" + userId + ":" + name;
return {
get redirectUrl() { return CALLBACK; },
get clientMetadata() {
return {
client_name: "Acme app", // shown on easyCoexistence's consent screen
redirect_uris: [CALLBACK],
grant_types: ["authorization_code", "refresh_token"],
response_types: ["code"],
token_endpoint_auth_method: "none", // easyCoexistence registers public clients
};
},
clientInformation: () => db.get(k("client")),
saveClientInformation: (info) => db.set(k("client"), info),
isClientInformationDynamicallyRegistered: async () => Boolean(await db.get(k("client"))),
tokens: () => db.get(k("tokens")),
saveTokens: (tokens) => db.set(k("tokens"), tokens),
saveCodeVerifier: (verifier) => db.set(k("verifier"), verifier),
codeVerifier: () => db.get(k("verifier")),
redirectToAuthorization: (url) => db.set(k("sign-in"), url.href),
};
}
// GET /api/easycoexistence/connect: send the user to the consent screen
export async function connect(userId: string) {
const result = await auth(easyAuth(userId), { serverUrl: MCP_URL });
if (result === "AUTHORIZED") return new Response("Already connected");
return Response.redirect(await db.get("easycoexistence:" + userId + ":sign-in"));
}
// GET /api/easycoexistence/callback: trade the code for tokens
export async function callback(req: Request, userId: string) {
const code = new URL(req.url).searchParams.get("code");
if (!code) return new Response("Sign-in was cancelled", { status: 400 });
await auth(easyAuth(userId), { serverUrl: MCP_URL, authorizationCode: code });
return Response.redirect("https://app.example.com/settings");
}கருவிகள் generateText-ஐ எவ்வாறு அடைகின்றன?
HTTP போக்குவரத்துடன் createMCPClient-இலிருந்து, easyCoexistence URL மற்றும் ப்ரோவைடர் உடன். tools() சர்வரின் கருவிகளை AI SDK கருவிகளாகத் திருப்புகிறது; வேலைக்குத் தேவையானவற்றை பெயர் வழியாக வைத்திருந்து generateText அல்லது streamText-க்கு அனுப்புங்கள். isStepCount உடன் stopWhen அமைக்கவும், ஏனெனில் இயல்பாக அழைப்பு ஒரு படியில் நின்றுவிடும், reply_to_comment திருப்பியதை மாதிரி ஒருபோதும் படிக்காது. நெட்வொர்க் விதிகளை instructions-இல் வைக்கவும்; தற்போதைய குறிப்பு மாதிரியின் நடத்தைக்குப் பயன்படுத்தும் அளவுரு அது. இணைப்பு எதுவும் திறந்து விடாமல் இருக்க, கிளையண்டை finally தொகுதியில் அல்லது streamText-இன் onEnd கால்பேக்கில் மூடவும்.
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText, isStepCount, type LanguageModel } from "ai";
import { easyAuth, MCP_URL } from "./easycoexistence-auth";
const REPLY_TOOLS = new Set(["list_social_comments", "reply_to_comment", "hide_comment", "send_social_dm"]);
export async function replyToEvent(userId: string, model: LanguageModel, event: unknown) {
const mcp = await createMCPClient({
transport: { type: "http", url: MCP_URL, authProvider: easyAuth(userId) },
});
try {
const tools = Object.fromEntries(
Object.entries(await mcp.tools()).filter(([name]) => REPLY_TOOLS.has(name)),
);
const { text } = await generateText({
model,
tools,
stopWhen: isStepCount(4),
instructions:
"Reply to comments and DMs for Acme on the event's account_id. TikTok replies are public " +
"and need the video ID as post_id. Instagram DMs only go to people who wrote in the last 24 hours.",
prompt: JSON.stringify(event),
});
return text;
} finally {
await mcp.close();
}
}serverless ஹோஸ்டில் டோக்கன்கள் எங்கே இருக்க வேண்டும்?
ஓர் invocation-ஐ விட நீண்டு வாழும் எங்கும்: ஒரு டேட்டாபேஸ் வரிசை, Redis அல்லது key-value சேமிப்பகம், டோக்கன்கள் சேர்ந்த உங்கள் செயலி பயனரின் அடையாளத்துடன். Vercel அல்லது வேறு serverless தளத்தில் ஒரு செயல்பாடு நினைவகத்தில் எதுவும் இல்லாமல் தொடங்குகிறது; எனவே டோக்கன்களை ஒரு மாறியில் வைக்கும் ப்ரோவைடர், cold start-க்குப் பிறகு பயனரை ஒப்புதல் திரைக்கு மீண்டும் அனுப்பும். அணுகல் டோக்கன்கள் ஒரு மணி நேரம் நீடிக்கும், ரீஃப்ரெஷ் டோக்கன்கள் 60 நாட்கள்; ஒவ்வொரு பயன்பாட்டிலும் புதிய ரீஃப்ரெஷ் டோக்கன் கிடைக்கும். எனவே 60 நாட்களுக்குள் ஒருமுறையாவது கருவிகளை அழைக்கும் செயலி உள்நுழைந்தே இருக்கும். கிளையண்ட் பதிவை டோக்கன்களுடன் அருகில் வைக்கவும், ஏனெனில் ஒவ்வொரு இணைப்பிலும் ப்ரோவைடர் இரண்டையும் படிக்கிறது.
கருத்துகளும் DM-களும் செயலியை எவ்வாறு அடைகின்றன?
route handler-க்கு கையொப்பமிடப்பட்ட POST-களாக, அதை set_social_webhook_destination ஒரு கணக்குக்குப் பதிவு செய்கிறது. அதன் பின் Instagram மற்றும் Facebook கருத்துகள், குறிப்புகள், DM-கள் மற்றும் TikTok கருத்துகள் அதை வந்தடைகின்றன. ஒவ்வொரு body-யிலும் platform, account_id, external_id மற்றும் entry உள்ளன; entry என்பது நெட்வொர்க் அனுப்பிய நிகழ்வு அப்படியே. body-யை உரையாகப் படித்து, கணக்கின் கையொப்ப ரகசியத்துடன் X-EC-Signature-ஐச் சரிபார்த்து, விரைவாகப் பதிலளிக்கவும். easyCoexistence route-க்கு 8 வினாடிகள் தருகிறது, ஒவ்வொரு நிகழ்வையும் ஒருமுறை மட்டுமே அனுப்புகிறது, மறுமுயற்சி இல்லை. நிகழ்வை ஒரு வரிசையில் வைத்து, ஒரு வொர்க்கர் அதனுடன் replyToEvent-ஐ அழைக்கட்டும்; அப்போது மாதிரியின் நேரம் 8 வினாடிகளுக்குள் கணக்கில் வராது.
ஒவ்வொரு நெட்வொர்க்கும் மாதிரிக்கு என்ன செய்ய அனுமதிக்கிறது?
கணக்கின் API அனுமதிக்கும் அளவுக்கு; அதை instructions விரிவாகக் கூற வேண்டும்:
- Instagram: JPEG படங்களுடன் பதிவுகள், Reels மற்றும் Stories; DM பதில்கள் கடைசி 24 மணி நேரத்தில் எழுதியவர்களுக்கு மட்டுமே, அதிகபட்சம் 1,000 பைட்.
- Facebook: அதே 24 மணி நேரத்திற்குள் Page பதிவுகள், கருத்துப் பதில்கள் மற்றும் Messenger பதில்கள்.
- TikTok: வீடியோக்கள் மற்றும் புகைப்படப் பதிவுகள்; கருத்துப் பதில்கள் எப்போதும் பொதுவில்,
post_id-ஆக வீடியோவின் ID; DM இல்லை. - WhatsApp: வாடிக்கையாளரின் கடைசி மெசேஜுக்கு 24 மணி நேரத்திற்குள்
send_message; மற்றவர்களுக்குsend_template. - YouTube மற்றும் LinkedIn: பயனர் கேட்கும்போது பதிவேற்றங்களும் பதிவுகளும், கருத்துப் பதில்களும் பகுப்பாய்வும்; இரண்டும் நிகழ்வுகளை அனுப்புவதில்லை, எனவே செயலி புதிய கருத்துகளை திட்டமிட்ட நேரத்தில் படிக்கும்.
பொதுவான தவறுகள்
- stopWhen-ஐ அதன் இயல்புநிலையில் விடுவது. generateText முதல் படியிலேயே நின்றுவிடும்; மாதிரி reply_to_comment-ஐ அழைக்கிறது, ஆனால் பதில் போனதா என்று ஒருபோதும் அறியாது. isStepCount உடன் சில படிகளை அனுமதிக்கவும்.
- serverless ஹோஸ்டில் டோக்கன்களை module-level மாறியில் வைப்பது. அடுத்த cold start-இல் அவை இருக்காது, பயனர் மீண்டும் ஒப்புதல் திரையில் இறங்குகிறார்; `tokens()` மற்றும் `saveTokens()` ஒரு டேட்டாபேஸை அடையும் இடத்தில் சேமிக்கவும்.
- ஒரு redirect URL பதிவு செய்து வேறொன்றை அனுப்புவது. easyCoexistence redirect_uri-ஐ பதிவுடன் அப்படியே பொருத்துகிறது; இறுதியில் உள்ள slash அல்லது வேறு பாதை உள்நுழைவை ஒரு பிழைப் பக்கத்தில் முடிக்கும்.
- கணக்கின் சொந்தச் செயல்பாட்டுக்குப் பதிலளிப்பது. Instagram கணக்கின் DM-களை எதிரொலிகளாகத் திருப்பி அனுப்புகிறது, அதன் பொதுப் பதில்கள் கருத்துகளாகத் திரும்பி வருகின்றன; இரண்டையும் prompt மாதிரியை அடைவதற்கு முன் தவிர்க்கவும்.
easyCoexistence, Vercel AI SDK-இல் நீங்கள் உருவாக்கும் ஏஜென்ட்களுக்கு WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn மற்றும் பிற சேனல்களில் வாடிக்கையாளர்களை அடையும் வசதியைத் தருகிறது; ஒவ்வொன்றும் அதிகாரப்பூர்வ API வழியாக: OAuth உள்நுழைவுக்குப் பின்னால் MCP கருவிகள், கருத்துகள் மற்றும் DM-களுக்கான கையொப்பமிடப்பட்ட நிகழ்வுகள், 90 நாட்கள் முன்பு வரை திட்டமிடும் வெளியீட்டு வரிசை, ஒவ்வொரு இணைப்பும் 24/7 கண்காணிக்கப்படுகிறது. ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் சேரச் சேரக் குறைகிறது; முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
AI SDK இயங்க Next.js அல்லது Vercel ஹோஸ்டிங் தேவையா?
இல்லை. AI SDK Node.js-இல் இயங்குகிறது, எனவே HTTPS route வழங்கும் எந்த ஹோஸ்ட்டும் வேலை செய்யும்; MCP கிளையண்டுக்கு easycoexistence.com-க்கு வெளிச்செல்லும் HTTPS மட்டுமே தேவை.
ஒரு chat இடைமுகம் கருவி அழைப்புகளை ஸ்ட்ரீம் செய்ய முடியுமா?
முடியும். அதே கருவிகளை streamText-க்கு அனுப்பி, AI SDK ஸ்ட்ரீம் செய்யப்பட்ட பதில்களுக்கு ஆவணப்படுத்தியபடி MCP கிளையண்டை அதன் onEnd கால்பேக்கில் மூடவும்.
அதே செயலி WhatsApp மெசேஜ்களுக்குப் பதிலளிக்க முடியுமா?
முடியும். எண்ணின் கருவிகள் அதே கிளையண்ட் வழியாக வருகின்றன: connection_id-க்கு list_numbers, பின்னர் வாடிக்கையாளரின் கடைசி மெசேஜுக்கு 24 மணி நேரத்திற்குள் send_message. WhatsApp-க்கான AI SDK வழிகாட்டி அவற்றைப் பெறுவதை விளக்குகிறது.
AI SDK செயலிக்கு easyCoexistence எவ்வளவு செலவாகும்?
ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் சேரச் சேரக் குறைகிறது; எல்லா நெட்வொர்க்குகளிலும் ஒரே விலை. MCP சர்வரும் Partner API-உம் இதில் அடங்கும், முதல் 3 நாட்கள் இலவசம்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: