بنية الوكلاءالمهارات العامة

Search Engine

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

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

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

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

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

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

الهيكلية

كيف يوجه Search Engine وكيل ADK-Rust.

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

طلب المستخدم

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

→

مهارة Search Engine

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

→

وكيل ADK-Rust

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

→

mcp-search

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

→

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

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

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

دليل القرار

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

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

"بحث"، "إيجاد"، "استعلام"؟

بحث (نصي كامل) أو بحث دلالي (معنى)

"مشابه"، "مثل هذا"، "مرتبط"؟

إيجاد مشابه / استعلام المتجهات

"إكمال تلقائي"، "اقتراح"؟

اقتراح

"فهرسة"، "إضافة مستند"، "استيعاب"؟

فهرسة مستند / تحديث المتجهات

"إنشاء فهرس"، "مخطط"؟

إنشاء فهرس

"لماذا تم الترتيب"، "شرح"، "تصحيح"؟

شرح الترتيب / اختبار الاستعلام

"تحليلات"، "الأداء"، "عدم وجود نتائج"؟

الحصول على تحليلات البحث

"مرادفات"؟

الحصول على المرادفات / تحديث المرادفات

سير عمل مثبتة

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

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

011 استدعاء

البحث النصي الكامل

بحث بالكلمات المفتاحية مع الفلاتر

021 استدعاء

البحث الدلالي

بحث قائم على المعنى (متجه)

031 استدعاء

فهرسة المستند

إضافة/تحديث في الفهرس

042 استدعاء

تصحيح الترتيب

شرح سبب ترتيب المستند في مكانه

052 استدعاء

تحسين الصلة

إيجاد نتائج صفرية → إضافة مرادفات

06Best For استدعاء

الوضع

أداة

حدود الأداة

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

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

semantic_search

multi_search

suggest

find_similar

list_indexes

get_index

create_index

index_document

delete_document

upsert_vectors

query_vectors

list_namespaces

get_vector_stats

get_search_analytics

get_index_stats

explain_ranking

test_query

get_synonyms

update_synonyms

قواعد العمل

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

استخدم semantic_search عندما تكون نية المستخدم أهم من الكلمات المفتاحية الدقيقة
تحقق بانتظام من get_search_analytics للاستعلامات التي لا تعطي نتائج
أضف مرادفات للمصطلحات الشائعة التي لا تعطي نتائج
استخدم explain_ranking لتصحيح ترتيب غير متوقع

حدود التشغيل

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

لا تستخدم البحث النصي الكامل للاستعلامات الغامضة/المفاهيمية (استخدم الدلالي)
لا تفهرس دون تحديد الحقول القابلة للبحث
لا تتجاهل الاستعلامات التي لا تعطي نتائج (تشير إلى ثغرات)

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

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

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

ثبت المهارة

git clone https://github.com/zavora-ai/skill-search-engine.git \
  ~/.skills/skills/search-engine

شكل تحميل ADK-Rust

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

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

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-search (Meilisearch، Typesense، Elasticsearch، Pinecone، أو مخصص).

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

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

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

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

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