الانتقال إلى المحتوى الرئيسي

AIMindTool

الوصف

أداة AIMindTool هي غلاف حول AI-Minds المقدمة من MindsDB. تتيح لك الاستعلام عن مصادر البيانات باللغة الطبيعية ببساطة من خلال إعداد معاملات الاتصال الخاصة بها. هذه الأداة مفيدة عندما تحتاج إلى إجابات عن أسئلة من بياناتك المخزنة في مصادر بيانات متنوعة بما في ذلك PostgreSQL وMySQL وMariaDB وClickHouse وSnowflake وGoogle BigQuery. Minds هي أنظمة ذكاء اصطناعي تعمل بشكل مشابه لنماذج اللغة الكبيرة (LLMs) لكنها تتجاوز ذلك من خلال الإجابة على أي سؤال من أي بيانات. يتحقق ذلك من خلال:
  • اختيار البيانات الأكثر صلة للإجابة باستخدام البحث البارامتري
  • فهم المعنى وتقديم الاستجابات ضمن السياق الصحيح من خلال البحث الدلالي
  • تقديم إجابات دقيقة من خلال تحليل البيانات واستخدام نماذج التعلم الآلي (ML)

التثبيت

لدمج هذه الأداة في مشروعك، تحتاج إلى تثبيت Minds SDK:
uv add minds-sdk

خطوات البدء

لاستخدام AIMindTool بفعالية، اتبع الخطوات التالية:
  1. تثبيت الحزمة: تأكد من تثبيت حزمتي crewai[tools] وminds-sdk في بيئة Python.
  2. الحصول على مفتاح API: سجّل في حساب Minds هنا، واحصل على مفتاح API.
  3. إعداد البيئة: خزّن مفتاح API الذي حصلت عليه في متغير بيئة باسم MINDS_API_KEY لتسهيل استخدامه من قبل الأداة.

مثال

يوضح المثال التالي كيفية تهيئة الأداة وتنفيذ استعلام:
Code
from crewai_tools import AIMindTool

# Initialize the AIMindTool
aimind_tool = AIMindTool(
    datasources=[
        {
            "description": "house sales data",
            "engine": "postgres",
            "connection_data": {
                "user": "demo_user",
                "password": "demo_password",
                "host": "samples.mindsdb.com",
                "port": 5432,
                "database": "demo",
                "schema": "demo_data"
            },
            "tables": ["house_sales"]
        }
    ]
)

# Run a natural language query
result = aimind_tool.run("How many 3 bedroom houses were sold in 2008?")
print(result)

المعاملات

تقبل AIMindTool المعاملات التالية:
  • api_key: اختياري. مفتاح API الخاص بـ Minds. إذا لم يُقدَّم، سيُقرأ من متغير البيئة MINDS_API_KEY.
  • datasources: قائمة من القواميس، كل منها يحتوي على المفاتيح التالية:
    • description: وصف البيانات الموجودة في مصدر البيانات.
    • engine: محرك (أو نوع) مصدر البيانات.
    • connection_data: قاموس يحتوي على معاملات الاتصال لمصدر البيانات.
    • tables: قائمة الجداول التي سيستخدمها مصدر البيانات. هذا اختياري ويمكن حذفه إذا كانت جميع الجداول في مصدر البيانات مطلوبة.
يمكن العثور على قائمة مصادر البيانات المدعومة ومعاملات اتصالها هنا.

مثال على التكامل مع الوكيل

إليك كيفية دمج AIMindTool مع وكيل CrewAI:
Code
from crewai import Agent
from crewai.project import agent
from crewai_tools import AIMindTool

# Initialize the tool
aimind_tool = AIMindTool(
    datasources=[
        {
            "description": "sales data",
            "engine": "postgres",
            "connection_data": {
                "user": "your_user",
                "password": "your_password",
                "host": "your_host",
                "port": 5432,
                "database": "your_db",
                "schema": "your_schema"
            },
            "tables": ["sales"]
        }
    ]
)

# Define an agent with the AIMindTool
@agent
def data_analyst(self) -> Agent:
    return Agent(
        config=self.agents_config["data_analyst"],
        allow_delegation=False,
        tools=[aimind_tool]
    )

الخلاصة

توفر AIMindTool طريقة قوية للاستعلام عن مصادر بياناتك باستخدام اللغة الطبيعية، مما يسهّل استخراج الرؤى دون كتابة استعلامات SQL معقدة. من خلال الاتصال بمصادر بيانات متنوعة والاستفادة من تقنية AI-Minds، تمكّن هذه الأداة الوكلاء من الوصول إلى البيانات وتحليلها بكفاءة.