أداة NL2SQL

​

نظرة عامة

​

نموذج الأمان

• بيانات الاعتماد التي تقدمها في db_uri
• ما إذا كان بإمكان المدخلات غير الموثوقة التأثير على الأوامر
• ما إذا كنت تضيف حواجز حماية لاستدعاءات الأدوات قبل التنفيذ

​

توصيات التقوية

• استخدم مستخدم قاعدة بيانات للقراءة فقط كلما أمكن
• فضّل نسخة القراءة لأعباء العمل التحليلية/الاسترجاعية
• امنح أقل صلاحيات ممكنة (بدون أدوار المسؤول/المستخدم الفائق، بدون صلاحيات على مستوى الملفات/النظام)
• طبّق حدود الموارد على مستوى قاعدة البيانات (مهلة الاستعلام، مهلة القفل، حدود التكلفة/الصفوف)
• أضف خطافات before_tool_call لفرض أنماط الاستعلام المسموح بها
• فعّل تسجيل الاستعلامات والتنبيهات للعبارات التدميرية

​

المتطلبات

• SqlAlchemy
• أي مكتبة متوافقة مع قواعد البيانات (مثل psycopg2، mysql-connector-python)

​

التثبيت

pip install 'crewai[tools]'

​

الاستخدام

from crewai_tools import NL2SQLTool

# psycopg2 was installed to run this example with PostgreSQL
nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")

@agent
def researcher(self) -> Agent:
    return Agent(
        config=self.agents_config["researcher"],
        allow_delegation=False,
        tools=[nl2sql]
    )

​

مثال

 DB -> Agent -> ... -> Agent -> DB