اے آئی رسائی · انٹرفیسREV. 2026-A
اے آئی اسسٹنٹ اس ویب سائٹ تک کیسے پہنچتے ہیں
انسانوں کے لیے صفحات کے ساتھ ساتھ اس ویب سائٹ میں پروگراموں کے لیے بھی داخلی راستے ہیں۔ ان کے ذریعے کوئی اے آئی اسسٹنٹ /tools کے ٹولز سے حساب کروا سکتا ہے یا ہماری قیمتیں پوچھ سکتا ہے، بجائے اس کے کہ صفحات میں اعداد تلاش کرے۔ یہاں لکھا ہے کہ کنکشن کیسے بنتا ہے اور حدود کیا ہیں۔
- رجسٹریشن کے بغیر
- صرف پڑھنے کے لیے
- کچھ بھی مستقل طور پر محفوظ نہیں کرتا
بتاریخ
01 / جائزہ
تین داخلی راستے، وہی ڈیٹا جو صفحات پر ہے
MCP سرور
/mcp
ان اسسٹنٹس کے لیے جو Model Context Protocol استعمال کرتے ہیں۔ 54 ٹولز، کمپنی پروفائل اور قیمتوں سے لے کر /tools کے کیلکولیٹرز تک۔
A2A اینڈ پوائنٹ
/a2a
A2A پروٹوکول 1.0 والے ایجنٹس کے لیے۔ /tools کے 50 ٹولز چلاتا ہے، اسی حساب کے ساتھ جو /mcp میں ہے۔
Markdown
Accept: text/markdown
اگر کوئی پروگرام مانگے تو صفحہ اپنا متن Markdown کی شکل میں دیتا ہے۔ براؤزرز کو بدستور HTML ملتا ہے۔
تینوں انہی ذرائع سے پڑھتے ہیں جن سے ویب سائٹ پڑھتی ہے۔ کمپنی کی بنیادی معلومات، ریٹ لسٹ اور ٹولز کا حساب کہیں بھی دو جگہ نہیں رکھا جاتا: اگر گھنٹے کا ریٹ بدلے تو ویب سائٹ کی اگلی اپ ڈیٹ کے بعد وہ /preise پر اور MCP سرور کے جواب میں ایک ساتھ نظر آتا ہے۔
02 / MCP سرور
MCP سرور سے کنکشن
- ایڈریس
- https://aureum-tech.com/mcp
- ٹرانسپورٹ
- Streamable HTTP، POST کے ذریعے JSON-RPC 2.0
- لاگ اِن
- کوئی نہیں
- رسائی
- صرف پڑھنے کے لیے
جو MCP کلائنٹ سرورز کو ایڈریس کے ذریعے Streamable HTTP پر جوڑتا ہے، اسے صرف یہی ایڈریس چاہیے۔ اندراج کا صحیح نام آپ کے کلائنٹ کی ہدایات میں لکھا ہے۔ بہت سے کلائنٹ اس طرح کی کنفیگریشن چاہتے ہیں:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
کچھ کلائنٹس میں ٹرانسپورٹ بھی الگ سے لکھنا پڑتا ہے، عموماً "http" یا "streamable-http"۔ کسی key یا token کی ضرورت نہیں۔
کنکشن کے وقت کیا ہوتا ہے
- initialize: کلائنٹ سیشن آئی ڈی کے بغیر رابطہ کرتا ہے۔ جواب کے ہیڈر میں
Mcp-Session-Idہوتا ہے، اور کلائنٹ یہ آئی ڈی ہر اگلی درخواست کے ساتھ بھیجتا ہے۔ - notifications/initialized: کلائنٹ تصدیق کرتا ہے کہ رابطہ مکمل ہو گیا۔
- tools/list: سرور تمام ٹولز ان کی تفصیل اور اِن پٹ سکیما کے ساتھ بتاتا ہے۔
- tools/call: کلائنٹ کسی ٹول کو اس کے اِن پٹس کے ساتھ چلاتا ہے۔ نتیجہ جواب کے ٹیکسٹ فیلڈ میں JSON کی شکل میں آتا ہے۔
ہاتھ سے رابطہ اس طرح ہوتا ہے، مثلاً ٹرمینل میں آزمانے کے لیے:
curl -i https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"test","version":"1.0"}}}'
جواب ایونٹ سٹریم (text/event-stream) کی شکل میں آتا ہے، اور آئی ڈی ہیڈر mcp-session-id میں ہوتی ہے۔ اس آئی ڈی کے ساتھ ٹول چلانے کی مثال؛ قدم 2 کی تصدیق (notifications/initialized) یہاں اختصار کے لیے چھوڑ دی گئی ہے، کلائنٹ اسے پہلے بھیجتا ہے:
curl https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: <Kennung aus der ersten Antwort>" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
"name":"preise_abfragen","arguments":{"zielgruppe":"firma"}}}'
جو /mcp کو براؤزر میں کھولتا ہے وہ GET بھیجتا ہے اور اسے پیغام "Nur POST (JSON-RPC)" ملتا ہے۔ یہ درست جواب ہے، کوئی خرابی نہیں۔ سرور چل رہا ہے یا نہیں، یہ /mcp/health بتاتا ہے۔
کون سے ٹولز موجود ہیں
چار ٹولز ہمارے بارے میں سوالوں کے جواب دیتے ہیں:
firma_und_kontakt: کمپنی پروفائل، پتہ، فون، رابطے کے اوقات اور رجسٹریشن کی معلومات کے ساتھleistungen_auflisten: تمام سروس شعبے، ہر ایک کے متعلقہ صفحے کے ساتھpreise_abfragen: گھنٹے کے ریٹ، آنا جانا اور اضافی چارجز، اسی ماخذ سے جس سے ریٹ لسٹ بنتی ہےwebsite_suchen: aureum-tech.com کے تمام صفحات میں تلاش
اس کے علاوہ /tools کے 51 میں سے 50 ٹولز (ای انوائس چیک کے سوا سب)، ہر ایک werkzeug_email_check جیسے نام کے ساتھ۔ یہ اسی منطق سے حساب کرتے ہیں جس سے براؤزر میں صفحہ، اور ہر جواب میں ٹول کا صفحہ، ڈیٹا کی تاریخ اور نتیجے کی حدود درج ہوتی ہیں۔ کوئی ٹول کون سے اِن پٹس چاہتا ہے، یہ اس کے صفحے پر "اے آئی اسسٹنٹس کے لیے" والے حصے میں لکھا ہے۔
03 / حدود
حدود، تاکہ سروس سب کے لیے چلتی رہے
سرور عوامی ہے اور کسی صارف کو نہیں پہچانتا۔ اس لیے ہر درخواست کا خرچ محدود رکھا گیا ہے، اور جو ٹولز دوسرے سرورز سے معلومات لیتے ہیں ان کی رفتار کی حدیں تمام درخواستوں پر مجموعی طور پر لاگو ہوتی ہیں۔
| حد | قدر | پھر کیا ہوتا ہے |
|---|---|---|
| ایک درخواست کا سائز | 900 کے بی | HTTP 413 |
| کھلے MCP سیشنز، تمام کلائنٹس ملا کر | 500 | HTTP 503، ساتھ میں Retry-After: 30 |
| بغیر سرگرمی کے MCP سیشن | 30 منٹ | سیشن ختم ہو جاتا ہے، کلائنٹ کو 404 ملتا ہے اور وہ دوبارہ رابطہ کرتا ہے۔ |
| /tools کے کسی ٹول کو نیٹ ورک سے معلومات لیے بغیر چلانے پر جواب کا وقت، انتظار سمیت | 10 سیکنڈ | ٹول کی طرف سے خرابی کے پیغام کے ساتھ رک جاتا ہے |
| ای میل چیک | فی منٹ 30 جانچیں، فی گھنٹہ 300 نئی DNS جانچیں | ٹول کہتا ہے کہ بعد میں دوبارہ کوشش کریں۔ |
| تھرڈ پارٹی چیک، اے آئی کرالر چیک اور لنک پریویو چیک | ہر ایک کے لیے فی منٹ 20 جانچیں، فی گھنٹہ 150 نئی جانچیں | ای میل چیک کی طرح |
| Gas کیلکولیٹر، لائیو قدروں کے ساتھ | فیس زیادہ سے زیادہ ایک منٹ میں ایک بار دوبارہ معلوم کی جاتی ہے | پچھلے منٹ کی قدروں کے ساتھ جواب؛ لائیو قدروں کے بغیر ہو تو صفحے کی مقررہ قدروں اور ایک نوٹ کے ساتھ |
جو نتیجہ ابھی کیش میں ہو (ہر ڈومین یا ایڈریس کے لیے پانچ منٹ)، وہ گھنٹے کی حد میں شمار نہیں ہوتا۔ اگر کوئی ٹول خود خرابی بتائے (رفتار کی حد، وقت کی حد، ناقابلِ استعمال اِن پٹ) تو وہ جواب کے فیلڈ fehler میں جرمن زبان میں لکھی ہوتی ہے۔ جو اِن پٹس سکیما سے میل نہ کھائیں، انہیں /a2a JSON-RPC خرابی -32602 کے ساتھ رد کرتا ہے اور /mcp MCP-SDK کے خرابی والے جواب کے ساتھ۔
04 / A2A
A2A پروٹوکول کے ذریعے ٹولز چلانا
- اینڈ پوائنٹ
- https://aureum-tech.com/a2a
- پروٹوکول
- JSON-RPC 2.0 کے ذریعے A2A 1.0
- ہیڈر
- A2A-Version: 1.0
- میتھڈ
- SendMessage
جو ایجنٹس A2A پروٹوکول استعمال کرتے ہیں وہ یہی 50 ٹولز /a2a کے ذریعے چلاتے ہیں۔ ڈیٹا والے حصے {"werkzeug": "…", "eingabe": {…}} کے ساتھ پیغام کوئی ٹول چلاتا ہے، اور جواب میں وہی نتیجہ ہوتا ہے جو /mcp میں:
curl https://aureum-tech.com/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "9b2f6c1e-4d1a-4c3b-8e55-0a7d2f3b1c90",
"role": "ROLE_USER",
"parts": [{
"data": {
"werkzeug": "werkzeug_email_check",
"eingabe": { "domain": "ihre-firma.de" }
},
"mediaType": "application/json"
}]
}
}
}'
- صرف متن والا پیغام ٹولز کی فہرست ان کے اِن پٹ فیلڈز کے ساتھ دیتا ہے۔ اگر متن میں کسی ٹول کا نام ہو تو اس کی مکمل تفصیل مثالی سوالوں سمیت آتی ہے۔
- ایجنٹ مقررہ قواعد کے مطابق کام کرتا ہے اور عام زبان نہیں سمجھتا۔
- یہ کوئی ٹاسک (Tasks) نہیں بناتا اور کچھ محفوظ نہیں کرتا۔ ہر جواب ایک براہِ راست پیغام ہوتا ہے، اس لیے
ListTasksخالی فہرست دیتا ہے۔ - Streaming اور پُش نوٹیفکیشنز یہ فراہم نہیں کرتا، اور فائلیں قبول نہیں کرتا۔
- اگر ہیڈر
A2A-Version: 1.0نہ ہو تو یہ خرابی -32009 کے ساتھ جواب دیتا ہے: سپیسیفکیشن کے مطابق غیر موجود قدر کا مطلب ورژن 0.3 ہے۔
کمپنی پروفائل، سروسز، قیمتوں اور تلاش والے چار ٹولز صرف /mcp کے ذریعے دستیاب ہیں۔ /a2a پر بھی درخواست کے سائز کی وہی حد، وقت کی وہی حد اور رفتار کی وہی حدیں لاگو ہیں۔ پروگراموں کے لیے تفصیل Agent Card میں ہے۔
05 / Markdown
صفحات بطور Markdown
جو کوئی صفحہ ہیڈر Accept: text/markdown کے ساتھ مانگے، اسے HTML کے بجائے اس کا متن Markdown میں ملتا ہے، مینو اور سکرپٹس کے بغیر۔ براؤزر یہ ہیڈر کبھی نہیں بھیجتے اور صفحہ معمول کے مطابق دیکھتے ہیں۔ یہ نسخے ویب سائٹ کی تیاری کے وقت تیار صفحات سے بنتے ہیں، اس لیے اتنے ہی تازہ ہوتے ہیں جتنے صفحات۔
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
جواب میں Content-Type: text/markdown; charset=utf-8 اور Vary: Accept ہوتے ہیں۔ گائیڈ کا مرکزی صفحہ اور ایڈیٹوریل سسٹم کے مضامین اس سے مستثنیٰ ہیں: دونوں صرف کھولنے کے وقت بھرے جاتے ہیں، وہاں بدستور HTML آتا ہے۔ ان صفحات کا متن ایک فائل میں /llms-full.txt دیتا ہے۔
06 / تفصیلی فائلیں
پروگرام کہاں دیکھتے ہیں کہ کیا کچھ موجود ہے
یہ فائلیں داخلی راستوں کو ایسے فارمیٹس میں بیان کرتی ہیں جنہیں ایجنٹس اور جانچ کے پروگرام خود تلاش کرتے ہیں۔ ہوم پیج اپنے جواب کے Link ہیڈر میں API کیٹلاگ، OpenAPI تفصیل اور اس صفحے کا حوالہ دیتا ہے۔
- /.well-known/api-catalogRFC 9727 کے مطابق API کیٹلاگ۔ یہ /mcp اور /a2a کے لیے تفصیل، ڈاکیومنٹیشن کے طور پر یہ صفحہ، اور /mcp کے لیے سٹیٹس چیک بتاتا ہے۔
- /openapi.jsonOpenAPI 3.1: MCP اینڈ پوائنٹ کا HTTP انٹرفیس۔
- /.well-known/mcp/server-card.jsonMCP Server Card، MCP سرور کے ایڈریس، ٹرانسپورٹ اور ٹولز کی فہرست کے ساتھ۔
- /.well-known/agent-card.jsonA2A Agent Card: A2A ایجنٹ کا اینڈ پوائنٹ، پروٹوکول ورژن اور صلاحیتیں۔
- /.well-known/agent-skills/index.jsonAgent Skills کی فہرست۔ اس میں ایجنٹس کے لیے دو ہدایات ہیں: MCP کے ذریعے ٹولز استعمال کرنا، اور کسی انسان کے لیے سروس کی انکوائری تیار کرنا۔
- /llms.txtلینگویج ماڈلز کے لیے ویب سائٹ کا خلاصہ، اہم صفحات کے ساتھ۔
- /llms-full.txtصفحات کا متن ایک فائل میں۔
- /auth.mdایجنٹس کے لیے لاگ اِن کی ہدایات۔ اس میں خاص طور پر یہ لکھا ہے کہ یہاں کوئی لاگ اِن نہیں ہے۔
- /robots.txtکرالرز کے لیے قواعد۔ سب کو اجازت ہے، معروف اے آئی کرالرز الگ الگ درج ہیں۔
07 / ڈیٹا پروٹیکشن
اِن پٹس کے ساتھ کیا ہوتا ہے
/mcp یا /a2a کے ذریعے درخواست اِن پٹس کو ہمارے سرور پر بھیجتی ہے، جو ان سے حساب کر کے نتیجہ واپس کرتا ہے، اِن پٹس یا نتیجہ مستقل طور پر محفوظ کیے بغیر۔ صرف نیٹ ورک جانچوں کے نتائج، جانچے گئے ڈومین یا ایڈریس سمیت، زیادہ سے زیادہ چھ منٹ تک میموری میں رہتے ہیں، درخواست دینے والے سے کسی تعلق کے بغیر۔ ہر صفحہ کھولنے کی طرح صرف درخواست لاگ ہوتی ہے، اس کا مواد نہیں، اور اسسٹنٹ خود آپ کی معلومات کے ساتھ کیا کرتا ہے، یہ اس کا فراہم کنندہ طے کرتا ہے (تفصیل پرائیویسی پالیسی میں)۔
08 / آپ کے کاروبار کے لیے
آپ کے اپنے سسٹمز کے لیے ایسی رسائی
جو یہ ویب سائٹ اپنے ڈیٹا کے لیے پیش کرتی ہے، وہ ہم کاروباروں کے لیے بھی بناتے ہیں: ایک MCP سرور جس کے ذریعے اے آئی اسسٹنٹ انوینٹری سسٹم یا کسی ڈیٹا بیس تک رسائی پاتا ہے، ان اختیارات کے ساتھ جو آپ پہلے سے طے کریں۔ ہم یہ کام کیسے کرتے ہیں، یہ MCP انٹیگریشنز والے صفحے پر لکھا ہے۔
MCP انٹیگریشنز دیکھیں