Vercel AI SDK එකේ social media tools භාවිතා කරන්න: Instagram, TikTok සහ තවත්
Vercel AI SDK එකට easyCoexistence හි MCP server එකෙන් Instagram, TikTok, Facebook, WhatsApp සහ තවත් channels සඳහා social media tools ලැබේ. @ai-sdk/mcp package එකෙන් createMCPClient, https://easycoexistence.com/api/mcp වෙත HTTP සම්බන්ධතාවයක් විවෘත කරයි. ඔබ ලියන OAuthClientProvider එකෙන් sign-in තබා ගන්නා අතර, client හි tools() generateText හෝ streamText වෙත ලබා දේ. එමඟින් පළ කිරීම, schedule කිරීම, comments සහ DMs වලට පිළිතුරු දීම සහ insights කියවීම එක් එක් network හි official API හරහා කළ හැක.
serverUrl සහ authorizationCode වලින් OAuth callback එක අවසන් කරන @ai-sdk/mcp ශ්රිතය; තිබෙන විට callbackState සහ callbackIssuer ද.
generateText හි පෙරනිමි stopWhen, එබැවින් stopWhen වැඩි steps අවසර දෙන තෙක් model එකට tool එකේ ප්රතිඵලය කියවිය නොහැක.
AI SDK නිර්දේශ කරන production සඳහා MCP transport එක; එහි stdio transport එක තිබෙන්නේ local servers සඳහා පමණි.
easyCoexistence MCP access token එකේ ආයු කාලය; එහි refresh token දින 60ක් ජීවත් වන අතර, සෑම refresh එකකදීම ප්රතිස්ථාපනය වේ.
එක් Instagram DM එකකට දැරිය හැකි උපරිම පෙළ, UTF-8 වලින් මනිනු ලැබේ; එබැවින් accents සහ emoji වැඩි ඉඩ ගනී.
AI SDK easyCoexistence වෙත sign in වන්නේ කෙසේද?
ඔබ ඔබේම storage මත ක්රියාත්මක කරන OAuthClientProvider එකක් හරහා, එය AI SDK හි auth() ශ්රිතය ධාවනය කරයි. පළමු call එකෙන් ඔබේ app එක easyCoexistence වෙත public client ලෙස ලියාපදිංචි කර, PKCE verifier එක සුරකියි, සහ redirectToAuthorization හරහා consent URL එක ලබා දෙයි. එය REDIRECT ලබා දෙන අතර, ඔබේ route එක පරිශීලකයා එහි යවයි. ඉන්පසු easyCoexistence code සහිතව ඔබේ callback වෙත redirect කරයි, සහ authorizationCode සහිත දෙවන auth() call එකක් එය tokens සඳහා හුවමාරු කරයි. Tokens සුරකින පසු, auth() refresh token භාවිතා කර නව යුගලයක් ලබා ගනී, පරිශීලකයා නැවත යැවීමකින් තොරව. 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");
}Tools generateText වෙත කෙසේ ළඟා වේද?
HTTP transport, easyCoexistence URL සහ provider සමඟ createMCPClient වෙතින්. tools() මගින් server හි tools AI SDK tools ලෙස ලබා දෙයි; job සඳහා අවශ්ය ඒවා නමින් තබාගෙන generateText හෝ streamText වෙත යවන්න. stopWhen, isStepCount සමඟ සකසන්න, මන්ද පෙරනිමියෙන් call එක එක් step එකකින් නවතින අතර model එකට reply_to_comment ප්රතිඵලය කියවිය නොහැක. Network නීති instructions තුළ තබන්න, වර්තමාන reference එක model හැසිරීම සඳහා භාවිතා කරන parameter එකයි. Client එක finally block එකේ, හෝ streamText හි onEnd callback එකේ වසන්න, කිසිදු සම්බන්ධතාවයක් විවෘතව නොතබා.
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 host එකක tokens කොහේ තබන්නද?
එක invocation එකකට වඩා දිවෙන ඕනෑම තැනක: database row එකක්, Redis හෝ key-value store එකක්, ඒවා අයත් ඔබේ app හි පරිශීලකයා අනුව යතුරු කර. Vercel හෝ වෙනත් serverless platform එකක function එකක් මතකයේ කිසිවක් නැතිව ආරම්භ වේ, එබැවින් tokens විචල්යයක තබන provider එකක් cold start එකකට පසු පරිශීලකයා consent තිරයට නැවත යවයි. Access tokens පැය එකක් ජීවත් වන අතර refresh tokens දින 60ක්, භාවිත වන සෑම වරකම නව refresh token එකක් සමඟ. එබැවින් දින 60ක් තුළ tools අවම වශයෙන් වරක් call කරන app එකක් sign in වූ ලෙස පවතී. Client registration tokens අසල තබන්න, මන්ද provider එක සෑම සම්බන්ධතාවයකදීම දෙකම කියවයි.
Comments සහ DMs app වෙත කෙසේ ළඟා වේද?
route handler වෙත signed POST ලෙස, එය set_social_webhook_destination මගින් ගිණුමකට ලියාපදිංචි කරන අතර, Instagram සහ Facebook comments, mentions සහ DMs, සහ TikTok comments ලබා ගනී. එක් body එකක platform, account_id, external_id සහ entry අඩංගු වේ, network එක යැවූ ආකාරයටම event එක. Body එක text ලෙස කියවා, ගිණුමේ signing secret සමඟ X-EC-Signature පරීක්ෂා කර, ඉක්මනින් පිළිතුරු දෙන්න: easyCoexistence route එකට තත්පර 8ක් ලබා දෙන අතර සෑම event එකක්ම එක් වරක් යවයි, retry නැත. Event එක queue එකක තබා worker එකකට replyToEvent එය සමඟ call කිරීමට ඉඩ දෙන්න, එවිට model එකේ කාලය තත්පර 8 ගණනට කිසිවිටක නොගැනේ.
එක් එක් network මගින් model එකට කළ හැක්කේ කුමක්ද?
ගිණුමේ API ඉඩ දෙන තරම්, instructions තුළ පැහැදිලිව දැක්විය යුතුය:
- Instagram: JPEG රූප සහිත posts, Reels සහ Stories; DM පිළිතුරු පැය 24ක් ඇතුළත ලියා ඇති අයට පමණි, උපරිම bytes 1,000ක්.
- Facebook: Page posts, comment පිළිතුරු සහ Messenger පිළිතුරු, එම පැය 24 තුළ.
- TikTok: videos සහ photo posts; comment පිළිතුරු සැමවිටම public, video හි ID එක
post_idලෙස, සහ DMs නැත. - WhatsApp:
send_message, customer ගේ අවසන් පණිවිඩයෙන් පැය 24ක් ඇතුළත;send_templateවෙනත් ඕනෑම කෙනෙකු සඳහා. - YouTube සහ LinkedIn: පරිශීලකයා ඉල්ලන විට uploads සහ posts, comment පිළිතුරු සහ analytics; දෙකම events යවන්නේ නැත, එබැවින් app එක නව comments කාලසටහනකට අනුව කියවයි.
සාමාන්ය වැරදි
- stopWhen එහි පෙරනිමියේ තබා ගැනීම. generateText පළමු step එකෙන් නවතින බැවින් model එක reply_to_comment call කරයි, සහ පිළිතුර ගියාද යන්න කිසිවිටක නොදනී; isStepCount සමඟ steps කිහිපයකට ඉඩ දෙන්න.
- Serverless host එකක module-level variable එකක tokens තැබීම. ඊළඟ cold start එකේදී ඒවා නැති වන අතර, පරිශීලකයා නැවත consent තිරයට වැටේ; tokens() සහ saveTokens() database එකට ළඟා වන තැනක සුරකින්න.
- Redirect URL එකක් ලියාපදිංචි කර වෙනත් එකක් යැවීම. easyCoexistence redirect_uri ලියාපදිංචියට හරියටම පරීක්ෂා කරන බැවින්, අග ඇති slash එකක් හෝ වෙනස් path එකක් sign-in එක error පිටුවකින් අවසන් කරයි.
- ගිණුමේ තමන්ගේම activity වලට පිළිතුරු දීම. Instagram ගිණුමේ DMs echoes ලෙස ආපසු යවන අතර එහි public පිළිතුරු comments ලෙස ආපසු පැමිණේ, එබැවින් prompt එක model එකට ළඟා වීමට පෙර දෙකම මඟ හරින්න.
easyCoexistence, Vercel AI SDK සමඟ ඔබ සාදන agents වලට WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn සහ තවත් channels වල පාරිභෝගිකයන් වෙත ළඟාවීම ලබා දෙයි, එක් එක් එක official API හරහා: OAuth sign-in පිටුපස MCP tools, comments සහ DMs සඳහා signed events, සහ දින 90ක් ඉදිරියට posting queue එකක්, සෑම සම්බන්ධතාවයක්ම 24/7 නිරීක්ෂණය වෙමින්. එක් සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, ඔබ සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
මෙයට Next.js හෝ Vercel hosting අවශ්යද?
නැත. AI SDK Node.js හි ක්රියාත්මක වන බැවින්, HTTPS route එකක් සේවා කරන ඕනෑම host එකක් ක්රියා කරයි, සහ MCP client එකට easycoexistence.com වෙත outbound HTTPS පමණක් අවශ්යයි.
Chat interface එකකට tool calls stream කළ හැකිද?
හැක. එම tools streamText වෙත යවා, MCP client එක එහි onEnd callback එකේ වසන්න, AI SDK streamed responses සඳහා ලේඛනගත කරන පරිදි.
එම app එකට WhatsApp පණිවිඩවලට පිළිතුරු දිය හැකිද?
හැක. අංකයේ tools එම client එක හරහාම ළඟා වේ: connection_id සඳහා list_numbers, ඉන්පසු customer ගේ අවසන් පණිවිඩයෙන් පැය 24ක් ඇතුළත send_message. WhatsApp සඳහා AI SDK guide එක ඒවා ලබා ගැනීම ආවරණය කරයි.
AI SDK app එකකට easyCoexistence මිල කීයද?
සම්බන්ධතාවයන්ට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, ඔබ සම්බන්ධතා එකතු කරන විට අඩු වේ, සෑම network එකටම එකම. MCP server සහ Partner API එයට ඇතුළත් වන අතර, පළමු දින 3 නොමිලේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ