ربط قاعدة بيانات

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

ليست قاعدة البيانات صفًا في مكتبة أدوات مساحة العمل مثل أداة Webhook أو مستند OpenAPI المستورد. تشرح نظرة عامة على الأدوات الفرق بين الأنواع.

ما تحتاج إليه

• عضوية في مساحة العمل. عناصر التحكم في قواعد البيانات تحتاج إلى الوصول إلى مساحة العمل ولا تحتاج إلى صلاحية إضافية، لذلك يستطيع أي عضو فيها ربط قاعدة بيانات أو حذفها.
• قاعدة بيانات PostgreSQL أو MySQL أو MariaDB يمكن الوصول إليها عبر TLS. هذه المحركات الثلاثة هي القائمة كاملة حاليًا.
• مستخدم لقاعدة البيانات بصلاحية قراءة فقط. اقرأ أمان أداة قاعدة البيانات قبل أن تختار المستخدم.
• سلسلة اتصال بصيغة SQLAlchemy مع مشغّل غير متزامن، بالشكل postgresql+asyncpg://user:pass@host:5432/db?sslmode=require.
• جملة أو جملتان عن النشاط. تعتمد الصياغة عليهما، ولا يمكن تسجيل الاتصال دونهما.

الخطوات

الخطوة 1: افتح نموذج إضافة الأداة

من الوكيل، افتح تبويب الأدوات واضغط إضافة أداة. في النافذة التي عنوانها إضافة أداة، اختر تبويب قاعدة بيانات.

الخطوة 2: سمِّ الاتصال

الاسم حقل إلزامي ويتسع لـ 120 حرفًا. هو العنوان الذي يظهر في كل جدول وورقة بدلًا من اسم المضيف واسم قاعدة البيانات.

الخطوة 3: اختر المحرك

المحرك يعرض MySQL و PostgreSQL و MariaDB بهذا الترتيب. MySQL محدد مسبقًا، لذلك غيّره إذا كانت قاعدتك Postgres أو MariaDB. يجب أن يطابق المحرك قاعدة البيانات التي تشير إليها.

الخطوة 4: الصق سلسلة الاتصال

سلسلة الاتصال حقل إلزامي ويتسع لـ 2000 حرف. يُخفى الحقل أثناء الكتابة. وجّهه إلى مستخدم القراءة فقط، واترك TLS مفعّلًا.

السلسلة تُشفَّر فور وصولها، ولا تعرضها أي شاشة أو استجابة بعد ذلك. احتفظ بنسخة لك، فتغييرها يعني تسجيل اتصال جديد.

الخطوة 5: صف النشاط

ما طبيعة هذا النشاط؟ (يوجّه الأسئلة التي نصيغها) هو النص الذي يوجّه الأسئلة التي تصوغها إيكونوڤا. اكتب ما تفعله الأعمال، وما يسأل عنه المتصلون عادة.

يعرض النموذج هذا الحقل بعبارة «(اختياري)» ويحسب حتى 500 حرف. وهو مطلوب فعلًا: الإرسال بدونه يفشل.

الخطوة 6: اضغط اختبار واتصال

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

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

الوصف هو النص الوحيد الذي يخبر الصياغة بالغرض من قاعدة البيانات هذه. اذكر النشاط، والأشياء التي يسأل عنها المتصلون، والكلمات التي يستخدمونها لها.

الموصى به

Online pharmacy in the UAE. Callers ask where their order is, whether a medicine
is in stock at a branch, and what a previous order contained. They say "parcel",
"prescription" and "branch".

الأقل فاعلية

Our main database.

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

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

يظهر الاتصال بعد ذلك في جدول أدوات الوكيل بالنوع قاعدة بيانات، مع اسم المضيف واسم قاعدة البيانات بوصفهما نقطة النهاية، وبحالة. ويظهر أيضًا في صفحة مكتبة الأدوات، مع شارة تعد أسئلته، وشارة TLS تُملأ عند التحقق من TLS.

أثناء انتظار الاتصال تتحدث القائمة كل 5 ثوانٍ، وتتوقف حين لا يبقى شيء معلّقًا، فتتغير الحالة دون إعادة تحميل.

لا شيء يصل إلى المحادثة بعد. الاتصال الجديد ليس له أي سؤال معتمد، ولا يصل إلى الوكيل إلا الأسئلة المعتمدة. عندما تصبح الحالة جاهزة، انتقل إلى مراجعة أسئلة قاعدة البيانات واعتمادها.

الحالات الثلاث

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

الحدود

حل المشكلات

"تعذّر الاتصال بقاعدة البيانات."

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

الحالة «تعذّر الاتصال»

فشل الاتصال أو الصياغة. افتح الاتصال: يظهر السبب في مربع أحمر أسفل الرأس. عالج السبب واضغط إعادة المزامنة، أو احذف الاتصال وسجّله من جديد.

"Duplicate value for connection string"

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

الحالة تبقى عند جارٍ قراءة البنية…

الصياغة لم تنتهِ بعد، لذلك لا تُعرض أي أسئلة. اضغط إعادة المزامنة لتشغيلها من جديد. إذا بقي الاتصال معلّقًا بعد إعادة المزامنة، احذفه وسجّله من جديد.

الاتصال جاهز لكن الوكيل لا يستخدمه أبدًا

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

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

هل أستطيع رؤية سلسلة الاتصال مرة أخرى؟

لا. تُشفَّر فور وصولها، ولا تعيدها أي شاشة أو استجابة. تعرض البوابة المضيف واسم قاعدة البيانات فقط، ولا تعرض بيانات الاعتماد أبدًا.

هل يستطيع وكيلان مشاركة قاعدة بيانات واحدة؟

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

هل تكتب إيكونوڤا في قاعدة بياناتي؟

لا. كل سؤال معتمد هو قراءة. انظر أمان أداة قاعدة البيانات.

ماذا يحدث عند حذف اتصال؟

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

أين أدير الاتصال أيضًا؟

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

صفحات ذات صلة

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