بلاگ پر واپس جائیں

نئے سیکھنے والوں کے لیے AIگائیڈ

ACP (Agent Client Protocol) کیا ہے؟ اپنا ایجنٹ لائیں

ACP ایک کوڈ ایڈیٹر اور کوڈنگ ایجنٹ کے درمیان ساکٹ ہے۔ یہاں دیکھیں کہ یہ MCP سے کیسے مختلف ہے اور آپ کا ماڈل اور API کلید کہاں فٹ ہوتے ہیں۔

از CheapTokens Teamشائع شدہ 6 منٹ کا مطالعہ

کور: ایڈیٹر → ACP → ایجنٹ فلو، کوڈ ایڈیٹر اور کوڈنگ ایجنٹ کے درمیان پروٹوکول
اس صفحہ پر
  1. آخر ساکٹ کیوں؟
  2. ACP کیسے کام کرتا ہے، سادہ الفاظ میں
  3. ACP بمقابلہ MCP: کون کسے جوڑتا ہے
  4. Android Studio میں اپنا ایجنٹ لائیں
  5. ماڈل اور API کلید کہاں ہوتے ہیں
  6. آگے کیا کریں

Android Studio اب 40 سے زیادہ کوڈنگ ایجنٹس کا مینو پیش کرتا ہے، اور اس کی خبروں میں تین حروف بار بار آتے ہیں: ACP۔ مختصر بات یہ ہے۔ Agent Client Protocol (ACP) ایک کوڈ ایڈیٹر اور کوڈنگ ایجنٹ کے درمیان مشترکہ ساکٹ ہے، بالکل ایسے جیسے کمپیوٹر اور اس میں لگائی جانے والی کسی بھی چیز کے درمیان USB۔ کوئی بھی ایڈیٹر جو ACP بولتا ہے، کسی بھی ایجنٹ کی میزبانی کر سکتا ہے جو اسے بولتا ہے۔ MCP ایک مختلف کیبل ہے: یہ ایجنٹ کو ٹولز اور ڈیٹا سے جوڑتا ہے، آپ کے ایڈیٹر سے نہیں۔

خبر کا مرکز Android Studio ہے۔ Android Developers بلاگ (28 اکتوبر 2026) کے مطابق Android Studio Rabbit 2، جو اب مستحکم ہے، “Bring Your Own Agent” کے ساتھ آتا ہے: آپ 40 سے زیادہ کوڈنگ ایجنٹس میں سے انتخاب کرتے ہیں، جن میں Claude Agent، OpenAI کا Codex، Junie اور Google Antigravity شامل ہیں۔ پوسٹ میں کہیں “ACP” کا ذکر نہیں۔ نام اور طریقہ کار ACP تعارف سے آتا ہے (1 نومبر 2026 کو دیکھا گیا)۔

آخر ساکٹ کیوں؟#

فرض کریں 5 ایڈیٹرز اور 8 کوڈنگ ایجنٹس ہیں۔ اگر ہر جوڑے کو اپنا الگ ہاتھ سے بنایا گیا کنکشن چاہیے، تو یہ 5 × 8 = 40 انٹیگریشنز ہیں، اور ہر نیا ایجنٹ پانچ ایڈیٹر ٹیموں کے لیے پانچ مزید کاموں کا مطلب ہے۔ اگر سب ایک ساکٹ پر متفق ہوں، تو ہر ایڈیٹر اسے ایک بار بناتا ہے اور ہر ایجنٹ اسے ایک بار: 5 + 8 = 13 کام۔ پوری بات یہی ہے۔

ACP سائٹ LSP، یعنی Language Server Protocol، کے ساتھ یہی موازنہ کرتی ہے، جو ایک لینگویج سرور کو کئی ایڈیٹرز میں کام کرنے دیتا ہے۔ وہی ترکیب، کوڈنگ ایجنٹس پر لاگو: کوئی بھی ACP ایجنٹ کسی بھی ACP ایڈیٹر کے ساتھ کام کرتا ہے، ہر جوڑے کے لیے الگ انٹیگریشن کے بغیر۔

فلیش کارڈز

ACP کے آس پاس ملنے والی اصطلاحات

ACP کیسے کام کرتا ہے، سادہ الفاظ میں#

دو ساتھیوں کا تصور کریں جو میل سلاٹ کے ذریعے پرچیاں پاس کرتے ہیں۔ ایڈیٹر درخواست لکھتا ہے، ایجنٹ واپس لکھتا ہے جو وہ دکھانا چاہتا ہے۔ مقامی ایجنٹ کے لیے، وہ میل سلاٹ لفظی ہے: ایڈیٹر آپ کی مشین پر ایجنٹ کو ذیلی پروسیس کے طور پر شروع کرتا ہے اور وہ stdio کے ذریعے JSON-RPC پیغامات کا تبادلہ کرتے ہیں۔ ہر پیغام کی عمومی ساخت ایک جیسی ہوتی ہے:

json
{ "jsonrpc": "2.0", "id": 1, "method": "…", "params": { … } }

طریقوں کے نام خود ACP کی طرف سے متعین ہیں، اس لیے آپ انہیں کبھی ہاتھ سے نہیں لکھتے۔ ایڈیٹر اور ایجنٹ لکھتے ہیں۔

ایجنٹس کا آپ کے لیپ ٹاپ پر رہنا ضروری نہیں۔ ریموٹ ایجنٹس HTTP یا WebSocket استعمال کرتے ہیں، حالانکہ ACP سائٹ کہتی ہے کہ مکمل ریموٹ سپورٹ ابھی کام جاری ہے۔ اور چونکہ پروٹوکول کوڈنگ کے لیے بنایا گیا ہے، یہ جہاں ممکن ہو MCP کی JSON نمائندگیوں کو دوبارہ استعمال کرتا ہے اور ایسی چیزیں شامل کرتا ہے جو ایڈیٹر کو دکھانی ہوں، جیسے diffs۔ اسی لیے تجویز کردہ تبدیلی آپ کے ایڈیٹر میں متن کی دیوار کے بجائے diff کے طور پر دکھائی دے سکتی ہے۔

ایڈیٹر، ACP، ایجنٹ اور ماڈل API ایک قطار میں
ACP ایڈیٹر اور ایجنٹ کے درمیان ربط ہے۔ ماڈل ایجنٹ کے پیچھے، الگ کنکشن پر ہوتا ہے۔

ACP بمقابلہ MCP: کون کسے جوڑتا ہے#

ایجنٹ کو درمیان میں رکھیں۔ ایک طرف آپ کا ایڈیٹر ہے، اور وہ ربط ACP ہے۔ دوسری طرف وہ چیزیں ہیں جن کے ساتھ ایجنٹ کام کرتا ہے: فائلیں، ڈیٹابیسز، سروسز۔ وہ ربط MCP ہے۔ وہ ایجنٹ کے مختلف اطراف میں ہیں، اس لیے وہ مقابلہ نہیں کرتے۔ اگر MCP آپ کے لیے نیا ہے، تو ہماری سادہ زبان میں MCP گائیڈ سے شروع کریں۔

ACP ایڈیٹر اور ایجنٹ کو جوڑتا ہے، MCP ایجنٹ اور ٹولز کو جوڑتا ہے
دونوں پروٹوکول ساتھ ساتھ۔ ACP ایڈیٹر کی طرف، MCP ٹولز کی طرف۔

وہ قریبی رشتہ دار بھی ہیں: جیسا کہ اوپر ذکر ہوا، ACP جہاں ممکن ہو MCP کی JSON نمائندگیاں مستعار لیتا ہے۔ خود ملانے کی کوشش کریں:

جوڑے ملائیں

ہر نام کو اس سے ملائیں جو وہ جوڑتا ہے

  • ACPایڈیٹر ⇄ کوڈنگ ایجنٹ
  • MCPایجنٹ ⇄ ٹولز اور ڈیٹا
  • stdio پر JSON-RPCمقامی ACP ایجنٹ ایڈیٹر سے کیسے بات کرتا ہے
  • Model API (base URL + key)ایجنٹ ⇄ لینگویج ماڈل

Android Studio میں اپنا ایجنٹ لائیں#

مشترکہ پروٹوکول کے بغیر، ایڈیٹر میں ایجنٹ شامل کرنا ایڈیٹر وینڈر کا کام ہے۔ Android Studio Rabbit 2 کے ساتھ آپ خود ایجنٹ منتخب کرتے ہیں۔ Android Developers پوسٹ کے مطابق، آپ ایجنٹ ونڈو کھول کر ایجنٹ منتخب کرتے ہیں، یا Settings > Tools > AI > Agents میں ایک منتخب کرتے ہیں۔ پھر آپ تصدیق کرتے ہیں اور اپنا پہلا پرامپٹ بھیجتے ہیں۔ پوسٹ صرف “authenticate” کہتی ہے؛ یہ کیا مانگتا ہے اس کا انحصار آپ کے منتخب کردہ ایجنٹ پر ہے، اس لیے ایجنٹ کی اپنی دستاویزات دیکھنے کی جگہ ہیں۔

ترتیب یہ ہے، اگر آپ خود جانچنا چاہیں:

ترتیب دیں

Android Studio کے مراحل کو ترتیب دیں

  1. Android Studio Rabbit 2 کھولیں
  2. ایجنٹ منتخب کریں (ایجنٹ ونڈو یا Settings > Tools > AI > Agents)
  3. تصدیق کریں
  4. پہلا پرامپٹ بھیجیں

ماڈل اور API کلید کہاں ہوتے ہیں#

یہی وہ حصہ ہے جو زیادہ تر مبتدیوں کو الجھاتا ہے۔ ACP ربط ایڈیٹر اور ایجنٹ کے درمیان گفتگو لے کر چلتا ہے۔ ایجنٹ کو سوچنے کے لیے پھر بھی لینگویج ماڈل چاہیے، اور وہ الگ کنکشن ہے، عام طور پر اپنے لاگ ان یا API کلید کے ساتھ۔ ایڈیٹر بدلنے سے ماڈل نہیں بدلتا، اور ماڈل بدلنے سے ایڈیٹر نہیں بدلتا۔ Android Studio پوسٹ کسٹم کلیدوں یا ماڈلز کے بارے میں کچھ نہیں کہتی، اس لیے آپ کیا بدل سکتے ہیں اس کا انحصار آپ کے منتخب کردہ ایجنٹ پر ہے۔

کچھ ایجنٹس آپ کو OpenAI-مطابق اینڈ پوائنٹ کی طرف اشارہ کرنے دیتے ہیں: ایک base URL، ایک کلید اور ایک ماڈل id۔ جب آپ کا ایجنٹ ایسا کرتا ہے، تو یہ پورا ماڈل کی طرف کا کنکشن ہے، اور آپ کسی بھی سیٹنگ کو چھونے سے پہلے اسے ٹرمینل میں آزمائش کر سکتے ہیں (کلید ماحول کے متغیر میں ایک پلیس ہولڈر ہے):

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain ACP in one sentence."}]
  }'

آپ کو JSON جواب ملتا ہے جس میں متن choices[0].message.content میں اور ٹوکن کی گنتی usage میں ہوتی ہے۔ کوڈنگ ایجنٹس ہر مرحلے پر بہت زیادہ سیاق و سباق دوبارہ بھیجتے ہیں، اس لیے لمبے سیاق و سباق والا ماڈل ان کے لیے موزوں ہے۔ CheapTokens میں وہ DeepSeek-V4-Flash ہے: 380K سیاق و سباق کی ونڈو، فی جواب زیادہ سے زیادہ 32,768 آؤٹ پٹ ٹوکنز، دن کے کسی بھی وقت ایک قیمت اور تمام ماڈلز میں ایک بیلنس۔ API OpenAI- اور Anthropic-مطابق ہے۔ درست ماڈل id CheapTokens دستاویزات سے لیں؛ ids فراہم کنندگان کے درمیان مختلف ہوتی ہیں۔ تفصیلات DeepSeek ماڈلز صفحہ پر ہیں۔

یقین نہیں کہ کون سا ٹول کسٹم کلید لیتا ہے؟ ہماری گائیڈ اپنی API کلید کہاں لگائیں چیٹ، ایڈیٹر، ٹرمینل اور کوڈ پر روشنی ڈالتی ہے۔ اور اگر “base URL” نیا اصطلاح ہے، تو base_url کیا ہے اور کیسے تبدیل کریں پڑھیں۔

خود آزمائیںآزمائیں: آپ نے ACP ایجنٹ انسٹال کیا۔ اس کے استعمال کردہ ماڈل کو تبدیل کرنے کے لیے آپ کون سا کنکشن بدلتے ہیں؟جواب دکھائیں

ACP والا نہیں۔ ایڈیٹر سے ایجنٹ کا ساکٹ ویسا ہی رہتا ہے۔ ماڈل ایجنٹ کی اپنی سیٹنگ ہے: ایجنٹ کی کنفگ میں base URL، کلید اور ماڈل id، اگر ایجنٹ انہیں ظاہر کرتا ہے۔

آگے کیا کریں#

اپنے مطلوبہ ایجنٹ کی دستاویزات کھولیں اور دیکھیں کہ وہ ماڈل کہاں سیٹ کرتا ہے۔ اگر آپ جاننا چاہتے ہیں کہ ایجنٹ اندر سے کیسے کام کرتا ہے، تو AI ایجنٹ کیسے کام کرتا ہے: لوپ اسے مرحلہ وار دکھاتا ہے۔ ACP صرف ایک سوال کا جواب دیتا ہے، ایڈیٹر اور ایجنٹ کیسے بات کرتے ہیں۔ باقی سب ایجنٹ اور اس کے ٹولز اور ماڈل کے درمیان رہتا ہے۔