الاتصالات والمعرفةالمهارات العامة

Maps & Geolocation

معلومات الموقع لوكلاء الذكاء الاصطناعي — الترميز الجغرافي، التوجيه مع تعليمات خطوة بخطوة، اكتشاف نقاط الاهتمام، الارتفاع، مصفوفات المسافات، والبحث عن المنطقة الزمنية. بدون إعداد، مجاني، تغطية عالمية عبر OpenStreetMap.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

تنسيق عمليات تحديد المواقع الجغرافية — ترميز العناوين جغرافيًا، حساب المسارات مع توجيهات خطوة بخطوة، العثور على نقاط الاهتمام، الحصول على بيانات الارتفاع، حساب مصفوفات المسافات، وتحديد المناطق الزمنية. استخدمه عند تحويل العناوين إلى إحداثيات، الحصول على توجيهات القيادة، العثور على أماكن قريبة، حساب المسافات…

الهيكلية

كيف يوجه Maps & Geolocation وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Maps & Geolocation

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-maps

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-maps · الأدوات المسموح بها: 7

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

"أين"، "إحداثيات"، "ترميز جغرافي"، "العنوان إلى"؟

geocode

"ما الموجود في"، "عنوان"، "عكس"؟

reverse_geocode

"المسار"، "الاتجاهات"، "كيفية الوصول إلى"، "القيادة"؟

get_route

"بالقرب"، "العثور على"، "مطاعم"، "مستشفيات"، "صراف آلي"؟

search_poi

"المسافة"، "كم يبعد"، "بين"؟

distance_matrix

"الارتفاع"، "العلو"، "الارتفاع"؟

get_elevation

"المنطقة الزمنية"، "ما الوقت"، "فرق التوقيت عن UTC"؟

get_timezone

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

011-2 استدعاء

الحصول على التوجيهات

تعليمات خطوة بخطوة مع المسافة والمدة

021-2 استدعاء

العثور على القريب

بحث نقاط الاهتمام حسب الفئة والنطاق

031 استدعاء

مصفوفة المسافات

المسافات بين جميع النقاط

041 استدعاء

المنطقة الزمنية

البلد + فرق التوقيت عن UTC لأي موقع

051 استدعاء

الارتفاع

الارتفاع عند أي إحداثي

حدود الأداة

قد تستخدم المهارة 7 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-maps بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

geocode

reverse_geocode

get_route

get_elevation

search_poi

distance_matrix

get_timezone

قواعد العمل

ما الذي يجب على الوكيل القيام به.

تضمين كل من المسافة والمدة في نتائج المسار دائمًا
تحديد وضع النقل (قيادة/مشاة/دراجة) — لا تفترض الوضع
تضمين الوحدات (كم/ميل، دقائق/ساعات)
للبحث عن نقاط الاهتمام، حدد نصف القطر (لا تعيد نتائج تبعد 50 كم)

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

لا تفترض وضع النقل — اسأل إذا لم يكن واضحًا
لا تعيد إحداثيات بدون سياق (تضمين اسم المكان دائمًا)
لا تتجاهل حدود المعدل (طلب واحد في الثانية للترميز الجغرافي)

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-maps، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-maps-geolocation.git \
  ~/.skills/skills/maps-geolocation

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("maps-geolocation").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-maps (OpenStreetMap، OSRM، OpenTopoData — مجاني، بدون مفاتيح API، بدون إعداد).

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md تدفقات عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md حساب المسافة ↗scripts/distance_calc.py ملخص المسار ↗assets/route-summary.md

استمر في الاستكشاف