مراجعة أسئلة قاعدة البيانات واعتمادها

لا تمنح قاعدة البيانات الوكيل بنيتك. تمنحه قائمة ثابتة من الأسئلة، كل سؤال منها استعلام للقراءة فقط تم التحقق منه سلفًا على قاعدة بياناتك، ومعه معاملات مسماة يملؤها الوكيل. تصوغ إيكونوڤا هذه القائمة من البنية عند ربط قاعدة البيانات، ولا يصل شيء منها إلى المحادثة قبل أن تعتمده أنت.

ربط قاعدة البيانات يأتي أولًا: ربط قاعدة بيانات.

ما تحتاج إليه

• اتصال حالته جاهزة. الاتصال المعلّق ليس له أسئلة بعد، والاتصال الفاشل ليس له أي سؤال على الإطلاق.
• عضوية في مساحة العمل. الاعتماد والتعديل يحتاجان إلى العضوية ولا يحتاجان إلى صلاحية إضافية.

الخطوات

الخطوة 1: افتح الاتصال

من تبويب الأدوات لدى الوكيل، افتح صف قاعدة البيانات. ومن صفحة مكتبة الأدوات، استخدم قائمة الصف الخاصة بقاعدة البيانات. كلاهما يفتح الورقة نفسها، وعنوانها اسم الاتصال، واسم المضيف واسم قاعدة البيانات تحته.

تعرض الورقة الأسئلة فقط عندما يكون الاتصال جاهزة. يعدّ العنوان الأسئلة بالصيغة «أسئلة صاغتها EchoNova من قاعدة بيانات الطلبات: 12»، ويعرض العداد على اليمين «3 من 12 معتمدة».

الخطوة 2: اقرأ سؤالًا صاغته إيكونوڤا

كل صف يحمل الاسم الذي سيناديه الوكيل به، والوصف الذي يقرؤه ليقرر متى يستدعيه، والمعاملات تحت المعطيات مع نجمة حمراء على المطلوب منها، وعبارات المثال تحت تُسمع كـ.

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

لا يُعرض SQL على أي شاشة أو في أي استجابة.

الخطوة 3: اعتمد الأسئلة التي يحق للوكيل استخدامها

استخدم المفتاح في آخر يمين الصف. تحته تكتب معتمد عندما يكون مفعّلًا، ومعطّل عندما لا يكون. اعتماد سؤال واحد طلب واحد، والعداد يتحرك معك.

اعتمد أقل عدد يمكنك الدفاع عنه. السؤال المعتمد يمكن استدعاؤه في كل محادثة، لدى كل وكيل يرتبط به هذا الاتصال.

الخطوة 4: اختبر ما قد يصل إليه كلام المتصل

افتح تفاصيل الاتصال، واذهب إلى تبويب الاختبارات، واضغط اختبار الأداة. تعنون النافذة «اختبار الاسترجاع/» وتشرح نفسها: «اكتب ما قد يقوله المتصل. هذا يشغّل نفس البحث الذي يجريه الوكيل في كل دور، حتى تكتشف القوالب التي لن يصل إليها أحد.»

اكتب جملة واضغط تشغيل. يعرض كل نتيجة اسم السؤال، ودرجته نسبةً مئوية، والنص الدقيق الذي تطابق معه. درجة 66% أو أكثر تعني تطابقًا حقيقيًا، أما الدرجة من 50% فتعني نجاحًا بالكاد. النتيجة التي لم تعتمدها تحمل الوسم غير معتمد، ويُقرأ الوسم من الاعتماد نفسه، فلا يوحي لك الاختبار أبدًا بأن السؤال فعّال وهو ليس كذلك.

يعرض الاختبار 5 نتائج على الأكثر، تسجّل كل منها 0.5 أو أكثر.

الخطوة 5: أعد المزامنة عند تغيّر البنية

اضغط إعادة المزامنة على الاتصال. تقرأ إيكونوڤا بنيتك من جديد وتصوغ قائمة جديدة.

يعود الاتصال إلى جارٍ قراءة البنية… أثناء ذلك، فتصبح قائمة الأسئلة فارغة حتى تصل الصياغة الجديدة. وعندما تصل، تحل محل القائمة القديمة بالكامل، وتأتي حالة الاعتماد لكل سؤال من الصياغة الجديدة، لا من اعتمادك السابق. تحقق من العداد بعد كل إعادة مزامنة، وهو بصيغة «3 من 12 معتمدة».

احصل على أفضل نتيجة

يصل السؤال إلى المتصل بمطابقة كلماته مع اسم السؤال ووصفه. يُصاغ الاثنان من بنيتك ومن الوصف الذي كتبته للاتصال عند تسجيله، أي حقل ما طبيعة هذا النشاط؟، لذلك يجب أن يحمل ذلك الوصف الكلمات التي يستخدمها المتصلون. اكتبه بكلماتهم، لا بكلمات بنيتك، واعتمد الأسئلة المصوغة التي تُقرأ بالطريقة نفسها.

الموصى به

An online furniture shop. Callers ask where their parcel is, whether an order is
late, what a tracking number says, and whether a sofa is in stock.

الأقل فاعلية

Postgres with orders, shipments and inventory tables joined on order_id.

ماذا يحدث بعد ذلك

لا يصل إلى المحادثة إلا الأسئلة المعتمدة. الأسئلة التي تركتها معطّلة لا تُعرض على الوكيل بأي طريق.

قد يستغرق اعتماد سؤال أو إلغاء اعتماده دقيقة كاملة حتى يصل إلى محادثة جديدة. ربط قاعدة بيانات بالوكيل أو فصلها يسري على المحادثة التالية فورًا. المحادثة الجارية تحتفظ بما بدأت به في الحالتين.

كم سؤالًا يصل إلى كل دور

في كل دور يبحث الوكيل في الأسئلة المعتمدة لكل قاعدة بيانات مرتبطة به، ويُعرض عليه 5 أسئلة على الأكثر، وتلك التي تسجّل 0.5 أو أكثر فقط. لا يمكن تعديل أي من الرقمين من البوابة حاليًا.

يستحق الحد 0.5 أن يُفهم. للدرجات أرضية مرتفعة: النص غير المرتبط يقع عند 0.30 إلى 0.41 تقريبًا، بينما يقع التطابق الحقيقي عند 0.66 إلى 0.72 تقريبًا. هذه الفجوة هي سبب أن درجة 66% أو أكثر في الاختبار تعني تطابقًا حقيقيًا، وأن درجة أعلى قليلًا من 50% تعني نجاحًا بالكاد.

تُبحث أسئلة قواعد البيانات وعمليات OpenAPI المستوردة في الجولة نفسها في كل دور، فالوكيل الذي يملك الاثنين يختار بينهما. تصف أدوات OpenAPI ذلك البحث، ولماذا قد تكون الأداة موجودة ومع ذلك لا تُستدعى أبدًا.

تعديل السؤال

تعتمد الورقة السؤال وتلغي اعتماده فقط. تغيير اسم السؤال أو وصفه أو معاملاته أو SQL غير متاح من البوابة حاليًا.

الوصف مع الاسم هو النص الذي تُقارن به كلمات المتصل. شغّل اختبار الاسترجاع بالكلمات التي يستخدمها المتصلون فعلًا قبل أن تعتمد على سؤال في محادثة، واترك السؤال معطّلًا عندما يُظهر الاختبار أن عبارة أحد لن تصل إليه.

الحدود

حل المشكلات

"لم تُصَغ أي أسئلة بعد."

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

الاختبار لا يعيد شيئًا فوق العتبة

تخبرك النافذة بالحالة التي أنت فيها. رسالة تذكر درجة أقرب قالب، وتقول «الكلمات التي يستخدمها المتصلون غير موجودة في وصفه وعباراته»، تعني أن السؤال موجود وقابل للمطابقة، لكنه لا يطابق الجملة التي كتبتها. اختبر من جديد بالكلمات التي يستخدمها المتصلون فعلًا، قبل أن تحكم بأن السؤال لا يُبلغ إليه.

"لا شيء مفهرس لهذا الاتصال، لذلك لن يصل الوكيل إلى أي قالب. أعد المزامنة."

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

"لا يوجد فهرس لهذا الاتصال، لذلك اتّسع البحث ليشمل مساحة العمل كلها. أعد المزامنة."

لم يجد البحث شيئًا تحت هذا الاتصال فاتّسع، لذلك قد تنتمي النتائج التي تنظر إليها إلى قاعدة بيانات أخرى. أعد مزامنة الاتصال قبل أن تستنتج أي شيء من النتائج.

الوكيل يجيب بلا شيء، أو يقول إنه لا يستطيع البحث عن ذلك

تحقق من القائمة بالترتيب: قاعدة البيانات مرتبطة بذلك الوكيل، والاتصال جاهزة، وسؤال واحد معتمد على الأقل، والاختبار يصل إلى ذلك السؤال بعبارة المتصل، وأن التغيير مضى عليه أكثر من دقيقة.

الأسئلة الشائعة

هل أستطيع رؤية SQL أو كتابته بنفسي؟

لا. لا يُعرض SQL على أي شاشة، وكتابته أو استبداله غير متاح من البوابة حاليًا.

هل يكلّف اعتماد السؤال شيئًا وهو ساكن؟

لا. السؤال المعتمد يُعرض على الوكيل ويُطابَق أثناء المحادثة. لا يُنفَّذ على قاعدة بياناتك إلا عندما يستدعيه الوكيل.

ما هي شارة «بيانات شخصية»؟

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

لماذا أُعيد ضبط اعتماداتي؟

تستبدل إعادة المزامنة قائمة الأسئلة بالصياغة الجديدة، وتعود حالة الاعتماد معها. أعد التحقق من العداد بعد كل إعادة مزامنة.

هل تنطبق هذه الأسئلة على كل الوكلاء؟

الأسئلة تنتمي إلى الاتصال، والاتصال يُرتبط بكل وكيل على حدة. الوكيل الذي لا يدرج الاتصال لا يستطيع الوصول إلى أي من أسئلته.

صفحات ذات صلة

• ربط قاعدة بيانات: تسجيل الاتصال الذي تأتي منه هذه الأسئلة
• أمان أداة قاعدة البيانات: المستخدم الذي تنشئه وما يُحفظ
• اختبار الاسترجاع: الاختبار نفسه للواجهات البرمجية المستوردة
• نظرة عامة على الأدوات: كيف تختلف قواعد البيانات عن أنواع الأدوات الأخرى