دەستگەیشتنی AI · ڕووکارەکانی پەیوەندیREV. 2026-A
یاریدەدەرەکانی AI چۆن دەگەنە ئەم ماڵپەڕە
جگە لە پەڕەکان بۆ مرۆڤ، ئەم ماڵپەڕە دەرگای بۆ بەرنامەکانیش هەیە. یاریدەدەرێکی AI دەتوانێت لەو ڕێگایەوە ئامرازەکانی /tools بخاتە کار یان نرخەکانمان بپرسێت، لە جیاتی ئەوەی بە دوای ژمارەدا بە ناو پەڕەکاندا بگەڕێت. لێرەدا نووسراوە چۆن پەیوەندی دەکرێت و سنوورەکان لە کوێدان.
- بێ تۆمارکردن
- تەنیا خوێندنەوە
- هیچ شتێک بە هەمیشەیی پاشەکەوت ناکات
دوایین نوێکردنەوە:
01 / پوختە
سێ دەرگا، هەمان داتای ناو پەڕەکان
سێرڤەری MCP
/mcp
بۆ ئەو یاریدەدەرانەی Model Context Protocol بەکار دەهێنن. 54 ئامراز، لە پرۆفایلی کۆمپانیا و نرخەکانەوە تا ژمێرەرەکانی /tools.
خاڵی پەیوەندیی A2A (Endpoint)
/a2a
بۆ ئەو ئەیجێنتانەی پرۆتۆکۆلی A2A 1.0 بەکار دەهێنن. 50 ئامرازی /tools بە کار دەخات، بە هەمان حیسابی /mcp.
Markdown
Accept: text/markdown
ئەگەر بەرنامەیەک داوای بکات، پەڕەکە دەقەکەی وەک Markdown دەنێرێت. براوزەرەکان هەر HTML وەردەگرن.
هەر سێکیان لە هەمان سەرچاوەکانی ماڵپەڕەکە دەخوێننەوە. زانیارییە سەرەکییەکان، لیستی نرخەکان و حیسابی ئامرازەکان لە هیچ شوێنێک دووجار نانووسرێن: ئەگەر نرخی کاتژمێرێک بگۆڕێت، دوای بڵاوکردنەوەی داهاتوو لە یەک کاتدا لەسەر /preise و لە وەڵامی سێرڤەری MCP دا دەردەکەوێت.
02 / سێرڤەری MCP
بەستنەوەی سێرڤەری MCP
- ناونیشان
- https://aureum-tech.com/mcp
- گواستنەوە
- Streamable HTTP، JSON-RPC 2.0 لە ڕێگەی POST
- تۆمارکردن
- هیچ
- دەستگەیشتن
- تەنیا خوێندنەوە
کلاینتێکی MCP کە سێرڤەر بە ناونیشان لە ڕێگەی Streamable HTTP زیاد دەکات، تەنیا ئەم ناونیشانەی پێویستە. ناوی وردی ئەم بەندە لە ڕێنمایی کلاینتەکەتاندا نووسراوە. زۆربەیان ڕێکخستنێکی لەم شێوەیە چاوەڕێ دەکەن:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
هەندێک کلاینت دەیانەوێت جۆری گواستنەوەکەش (Transport) بنووسرێت، زۆرجار وەک „http" یان „streamable-http". هیچ کلیل یان تۆکنێک پێویست نییە.
لە کاتی پەیوەندیکردندا چی ڕوو دەدات
- initialize: کلاینتەکە بێ ناسنامەی دانیشتن خۆی دەناسێنێت. وەڵامەکە لە سەرپەڕەکەیدا
Mcp-Session-Idهەڵدەگرێت، و کلاینتەکە ئەم ناسنامەیە لەگەڵ هەموو داواکارییەکی دواتر دەنێرێت. - notifications/initialized: کلاینتەکە پشتڕاستی دەکاتەوە کە ناساندنەکە تەواو بووە.
- tools/list: سێرڤەرەکە هەموو ئامرازەکان لەگەڵ وەسف و شێوەی داخڵکردنیان (Schema) دەناسێنێت.
- tools/call: کلاینتەکە ئامرازێک لەگەڵ زانیارییە داخڵکراوەکانی بانگ دەکات. ئەنجامەکە وەک JSON لە خانەی دەقی وەڵامەکەدا دێت.
ناساندن بە دەست ئاوا دەبێت، بۆ نموونە بۆ تاقیکردنەوە لە Terminal:
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
جگە لەوانە 50 لە 51 ئامرازەکەی /tools (هەموویان جگە لە پشکنینی پسوولەی ئەلیکترۆنی)، هەر یەکەیان بە ناوێکی وەک werkzeug_email_check. هەمان لۆجیکی پەڕەکە لە براوزەردا بەکار دەهێنن، و هەموو وەڵامێک پەڕەی ئامرازەکە، کاتی داتاکان و سنوورەکانی ئەنجامەکە دەڵێت. ئامرازێک چ زانیارییەکی پێویستە، لە پەڕەکەی خۆیدا لە بەشی „بۆ یاریدەدەرەکانی AI" نووسراوە.
03 / سنوورەکان
سنوورەکان، بۆ ئەوەی خزمەتگوزارییەکە بۆ هەمووان کار بکات
سێرڤەرەکە گشتییە و هیچ بەکارهێنەرێک ناناسێت. بۆیە تێچووی هەر داواکارییەک سنووردارە، و سنووری ئەو ئامرازانەی سێرڤەری تر دەپشکنن، بۆ کۆی هەموو بانگکردنەکان پێکەوە دەژمێردرێت.
| سنوور | بەها | ئینجا چی ڕوو دەدات |
|---|---|---|
| قەبارەی داواکارییەک | 900 KB | HTTP 413 |
| دانیشتنە کراوەکانی MCP، کۆی هەموو کلاینتەکان | 500 | HTTP 503 لەگەڵ Retry-After: 30 |
| دانیشتنی MCP بێ چالاکی | 30 خولەک | دانیشتنەکە بەسەر دەچێت، کلاینتەکە 404 وەردەگرێت و دووبارە خۆی دەناسێنێت. |
| کاتی وەڵام بۆ هەر بانگکردنێکی ئامرازێکی /tools کە پێویستی بە تۆڕ نییە، لەگەڵ کاتی چاوەڕوانیشدا | 10 چرکە | ڕاگرتن لەگەڵ پەیامی هەڵەی ئامرازەکە |
| پشکنینی ئیمەیڵ | 30 پشکنین لە خولەکێکدا، 300 پشکنینی نوێی DNS لە کاتژمێرێکدا | ئامرازەکە داوا دەکات دواتر دووبارە هەوڵ بدەنەوە. |
| پشکنینی لایەنی سێیەم، پشکنینی کراولەری AI و پشکنینی پێشاندانی لینک | هەر یەکەیان 20 پشکنین لە خولەکێکدا و 150 پشکنینی نوێ لە کاتژمێرێکدا | وەک پشکنینی ئیمەیڵ |
| ژمێرەری Gas لەگەڵ بەهای ڕاستەوخۆ | کرێکان لە خولەکێکدا تەنیا جارێک نوێ دەپرسرێنەوە | وەڵام بە بەهاکانی دوایین خولەک؛ بێ بەهای ڕاستەوخۆ، بە بەها جێگیرەکانی پەڕەکە و تێبینییەک |
ئەنجامێک کە هێشتا لە بیرگەی کاتیدایە (پێنج خولەک بۆ هەر دۆمەین یان ناونیشانێک)، لە سنووری کاتژمێردا ناژمێردرێت. ئەگەر ئامرازێک خۆی هەڵەیەک ڕابگەیەنێت (سنوور، سنووری کات، زانیاریی نەگونجاو)، ئەوا بە ئەڵمانی لە خانەی fehler ی وەڵامەکەدا دەنووسرێت. زانیارییەک کە لەگەڵ Schema ناگونجێت، /a2a بە هەڵەی JSON-RPC ـی -32602 ڕەتی دەکاتەوە و /mcp بە وەڵامێکی هەڵەی MCP-SDK.
04 / A2A
بانگکردنی ئامرازەکان لە ڕێگەی پرۆتۆکۆلی A2A
- خاڵی پەیوەندی (Endpoint)
- https://aureum-tech.com/a2a
- پرۆتۆکۆل
- A2A 1.0 لەسەر JSON-RPC 2.0
- سەرپەڕە (Header)
- A2A-Version: 1.0
- ڕێگا (Method)
- 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"
}]
}
}
}'
- نامەیەک کە تەنیا دەقی تێدا بێت، لیستی ئامرازەکان لەگەڵ خانەکانی داخڵکردنیان دەنێرێتەوە. ئەگەر دەقەکە ناوی ئامرازێک بهێنێت، هەموو زانیارییەکانی ئەو ئامرازە لەگەڵ نموونەی پرسیار دێن.
- ئەیجێنتەکە بە پێی ڕێسای جێگیر کار دەکات و زمانی ئازاد تێناگات.
- هیچ ئەرکێک (Task) دروست ناکات و هیچ شتێک پاشەکەوت ناکات. هەموو وەڵامێک نامەیەکی ڕاستەوخۆیە، بۆیە
ListTasksلیستێکی بەتاڵ دەنێرێتەوە. - Streaming و ئاگادارکردنەوەی Push پێشکەش ناکات، و فایل وەرناگرێت.
- ئەگەر سەرپەڕەی
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-catalogکەتەلۆگی API بە پێی RFC 9727. بۆ /mcp و /a2a وەسفەکە، ئەم پەڕەیە وەک دۆکیومێنت و بۆ /mcp پشکنینی دۆخ دەناسێنێت.
- /openapi.jsonOpenAPI 3.1: ڕووکاری HTTP ی خاڵی پەیوەندیی MCP.
- /.well-known/mcp/server-card.jsonMCP Server Card لەگەڵ ناونیشان، جۆری گواستنەوە و لیستی ئامرازەکانی سێرڤەری MCP.
- /.well-known/agent-card.jsonA2A Agent Card: خاڵی پەیوەندی، وەشانی پرۆتۆکۆل و تواناکانی ئەیجێنتی A2A.
- /.well-known/agent-skills/index.jsonپێڕستی Agent Skills. دوو ڕێنمایی بۆ ئەیجێنتەکانی تێدایە: بەکارهێنانی ئامرازەکان لە ڕێگەی MCP و ئامادەکردنی داواکارییەکی خزمەتگوزاری بۆ مرۆڤێک.
- /llms.txtکورتەی ماڵپەڕەکە بۆ مۆدێلەکانی زمان، لەگەڵ پەڕە گرنگەکان.
- /llms-full.txtدەقی پەڕەکان لە یەک فایلدا.
- /auth.mdڕێنمایی تۆمارکردن بۆ ئەیجێنتەکان. بە تایبەتی دەڵێت کە لێرەدا هیچ تۆمارکردنێک نییە.
- /robots.txtڕێساکان بۆ Crawler ەکان. ڕێگە بە هەمووان دراوە، و AI-Crawler ە ناسراوەکان یەک بە یەک تێیدا نووسراون.
07 / پاراستنی داتا
چی بەسەر زانیارییە داخڵکراوەکاندا دێت
بانگکردنێک لە ڕێگەی /mcp یان /a2a زانیارییە داخڵکراوەکان دەنێرێت بۆ سێرڤەرەکەمان، کە حیسابیان پێ دەکات و ئەنجامەکە دەنێرێتەوە، بێ ئەوەی زانیارییەکان یان ئەنجامەکە بە هەمیشەیی پاشەکەوت بکات. تەنیا ئەنجامی پشکنینەکانی تۆڕ لەگەڵ دۆمەین یان ناونیشانی پشکنراو زۆرترین شەش خولەک، بێ پەیوەندی بە بانگکەرەوە، لە بیرگەی کارکردندا دەمێننەوە. وەک لە هەموو داواکردنێکی پەڕەدا، تەنیا داواکارییەکە بێ ناوەڕۆکەکەی تۆمار دەکرێت، و ئەوەی یاریدەدەرەکە خۆی بە زانیارییەکانتان دەکات، دابینکەرەکەی ڕێکی دەخات (وردەکاری لە ڕاگەیاندنی پاراستنی داتا).
08 / بۆ کۆمپانیاکەتان
دەستگەیشتنی لەم شێوەیە بۆ سیستەمەکانی خۆتان
ئەوەی ئەم ماڵپەڕە بۆ داتاکانی خۆی پێشکەشی دەکات، بۆ کۆمپانیاکانیش دروستی دەکەین: سێرڤەرێکی MCP کە یاریدەدەرێکی AI لە ڕێگەیەوە دەگاتە سیستەمی کاڵا و کۆگا یان داتابەیسێک، بەو دەسەڵاتانەی ئێوە پێشتر دیاریان دەکەن. چۆن کار دەکەین، لە پەڕەی بەستنەوەی MCP دا نووسراوە.
بینینی بەستنەوەی MCP