البحث المتجهي يعثر على نص مشابه. البحث الوكيلي يعثر على سياق ذي صلة. الفرق هو الاستدلال.
يسأل البحث التقليدي: "أي المستندات تحتوي على هذه الكلمات؟"
لكن البشر يسألون: "ماذا قصدت عندما قلت ذلك؟"
مثال على استعلام: "كيف تعاملت مع مصادقة المستخدم؟"
نهج البحث المتجهي:
نهج الذاكرة البشرية:
يبحث البشر بـ الاستدلال، وليس بـ التشابه.
يجمع البحث الوكيلي:
const response = await searchEngine.search({
userId: 'user_123',
query: "How did I handle user authentication?",
strategy: 'hybrid', // temporal + semantic + pattern
depth: 3,
limit: 10,
});
// يُرجع:
response.insights.summary
// "Found 3 authentication implementations across 2 projects"
response.insights.patterns
// ["jwt-auth", "oauth-integration", "session-management"]
response.insights.suggestions
// ["Consider reusing the JWT pattern from Project A"]
response.results[0].reasoning
// "Session from March 2025 implemented JWT authentication
// with refresh tokens for the e-commerce project""ماذا فعلت الأسبوع الماضي؟"
const response = await searchEngine.search({
userId: 'user_123',
query: "Show me recent authentication work",
strategy: 'temporal',
});كيف يعمل:
// تسجيل الصلة
const daysAgo = (Date.now() - session.createdAt) / (1000 * 60 * 60 * 24);
const recencyBoost = Math.max(0.1, 1 - daysAgo / 30);"كيف تعاملت مع أدوار المستخدمين؟"
const response = await searchEngine.search({
userId: 'user_123',
query: "Find my role-based access control implementation",
strategy: 'semantic',
});كيف يعمل:
const concepts = extractConcepts(query);
// { entities: ['Role', 'User'], patterns: ['guard'], actions: ['authorize'] }
// المطابقة مع الجلسات
const matches = sessions.filter(s =>
s.entities.some(e => concepts.entities.includes(e)) ||
s.patterns.some(p => concepts.patterns.includes(p))
);"أرني جميع عروض القوائم التي بنيتها"
const response = await searchEngine.search({
userId: 'user_123',
query: "Find all my list views",
strategy: 'pattern',
});كيف يعمل:
const patternTerms = ['list', 'table', 'grid', 'cards'];
const userPatterns = await memoryManager.getUserPatterns(userId);
// إيجاد الـ patterns عالية النجاح
const goodPatterns = userPatterns.filter(p =>
p.successCount / p.usageCount > 0.8
);"ما الذي نجح مع النماذج؟" (يجمع جميع الاستراتيجيات)
const response = await searchEngine.search({
userId: 'user_123',
query: "What worked well for forms?",
strategy: 'hybrid',
depth: 3,
limit: 10,
});يجمع نتائج البحث الزمني والدلالي والـ patterns مع إزالة التكرار.
البحث الوكيلي لا يُرجع مطابقات فحسب — بل يشرح لماذا تطابقت:
interface SearchResult {
type: 'preference' | 'session' | 'project' | 'pattern';
data: unknown;
relevance: number; // 0-1
reasoning: string; // تفسير مقروء للبشر
source: string; // من أين أتت
}
// مثال على نتيجة
{
type: 'session',
data: { /* سجل الجلسة */ },
relevance: 0.87,
reasoning: "Session from March 2025 contains 'User' entity with
'role' field and uses 'guard-clause' pattern.
User previously marked this pattern as successful.",
source: 'generation_history'
}بعيداً عن النتائج الفردية، يولّد البحث الوكيلي رؤى:
interface Insights {
summary: string; // ما تم إيجاده
patterns: string[]; // الـ patterns الشائعة
trends: string[]; // الاتجاهات الزمنية
suggestions: string[]; // الخطوات التالية القابلة للتنفيذ
}
// مثال
{
summary: "Found 12 sessions involving forms across 3 projects",
patterns: ["form-section", "validation-rules", "wizard-flow"],
trends: [
"High success rate (92%) with form-section pattern",
"Validation errors decreased after adopting std/validate"
],
suggestions: [
"Consider reusing the wizard-flow pattern for complex forms",
"Add entity-form to your preferred patterns"
]
}استعلام المستخدم: "كيف بنيت تدفق الدفع؟"
عملية البحث الوكيلي:
استخراج المفاهيم
concepts = {
entities: ['Order', 'Payment', 'Cart'],
patterns: ['wizard', 'form', 'validation'],
actions: ['checkout', 'purchase', 'pay']
}البحث الزمني
البحث الدلالي
البحث بالـ patterns
wizard-flowتوليد الرؤى
{
summary: "Found checkout implementation using 3-step wizard",
patterns: ["wizard-flow", "form-section", "validation-rules"],
trends: [
"Most successful: 3-step wizard (92% completion)",
"Less successful: single-page checkout (67%)"
],
suggestions: [
"Reuse wizard-flow for future checkout flows",
"Consider adding progress indicator pattern"
]
}// داخلي: محرك البحث الوكيلي في المدار
// (هكذا يعمل من الداخل — ليس واجهة برمجية عامة)
const searchEngine = createSearchEngine(memoryManager);
// البحث عن أنماط المصادقة
const response = await searchEngine.search({
userId: 'user_123',
query: "How did I handle authentication in the e-commerce project?",
strategy: 'hybrid',
depth: 3,
limit: 10,
});
// عرض الملخص
console.log(response.insights.summary);
// "Found 4 authentication implementations across 2 projects"
// عرض الـ patterns المستخدمة
response.insights.patterns.forEach(pattern => {
console.log(`- ${pattern}`);
});
// - jwt-auth
// - oauth-integration
// - session-management
// عرض أعلى النتائج مع الاستدلال
response.results.slice(0, 3).forEach(result => {
console.log(`${result.type}: ${result.reasoning} (${result.relevance})`);
});
// session: Session from March 2025 implemented JWT authentication
// with refresh tokens for the e-commerce project (0.92)
//
// pattern: Pattern 'jwt-auth' has 95% success rate across 12 uses (0.88)
//
// preference: User prefers JWT over session-based auth (0.85)
// تنفيذ إجراء بناءً على الاقتراحات
if (response.insights.suggestions.length > 0) {
console.log("\nSuggested actions:");
response.insights.suggestions.forEach(s => console.log(`- ${s}`));
}
// - Consider reusing the JWT pattern from E-Commerce project
// - Add 'jwt-auth' to your preferred patterns| الجانب | البحث المتجهي | البحث الوكيلي |
|---|---|---|
| الاستعلام | "authentication" | "كيف تعاملت مع المصادقة؟" |
| الطريقة | تشابه التضمينات | استدلال + تنقل |
| النتائج | نص مشابه | سياق ذو صلة |
| الزمني | طابع زمني فقط | state transitions |
| السببي | لا يوجد | سلاسل خطأ ← إصلاح |
| التفسير | درجة تشابه | استدلال مقروء للبشر |
| الرؤى | لا يوجد | patterns، اتجاهات، اقتراحات |
البحث المتجهي = أمين المكتبة:
البحث الوكيلي = مساعد البحث:
يجيب البحث المتجهي: "ما الذي يشبه هذا النص؟"
يجيب البحث الوكيلي: "ما الذي أحتاج معرفته الآن؟"
الفرق هو الاستدلال:
هكذا يتذكر البشر. وهكذا يتذكر ذكاؤنا الاصطناعي أيضاً.
تعلم المزيد عن الذاكرة المدارية.
وكلاء ذكاء اصطناعي خاصّون على أجهزتك.