mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-04-11 05:22:41 +00:00
120 lines
5.2 KiB
Plaintext
120 lines
5.2 KiB
Plaintext
---
|
|
title: أداة AI Mind
|
|
description: أداة `AIMindTool` مصممة للاستعلام عن مصادر البيانات باللغة الطبيعية.
|
|
icon: brain
|
|
mode: "wide"
|
|
---
|
|
|
|
# `AIMindTool`
|
|
|
|
## الوصف
|
|
|
|
أداة `AIMindTool` هي غلاف حول [AI-Minds](https://mindsdb.com/minds) المقدمة من [MindsDB](https://mindsdb.com/). تتيح لك الاستعلام عن مصادر البيانات باللغة الطبيعية ببساطة من خلال إعداد معاملات الاتصال الخاصة بها. هذه الأداة مفيدة عندما تحتاج إلى إجابات عن أسئلة من بياناتك المخزنة في مصادر بيانات متنوعة بما في ذلك PostgreSQL وMySQL وMariaDB وClickHouse وSnowflake وGoogle BigQuery.
|
|
|
|
Minds هي أنظمة ذكاء اصطناعي تعمل بشكل مشابه لنماذج اللغة الكبيرة (LLMs) لكنها تتجاوز ذلك من خلال الإجابة على أي سؤال من أي بيانات. يتحقق ذلك من خلال:
|
|
- اختيار البيانات الأكثر صلة للإجابة باستخدام البحث البارامتري
|
|
- فهم المعنى وتقديم الاستجابات ضمن السياق الصحيح من خلال البحث الدلالي
|
|
- تقديم إجابات دقيقة من خلال تحليل البيانات واستخدام نماذج التعلم الآلي (ML)
|
|
|
|
## التثبيت
|
|
|
|
لدمج هذه الأداة في مشروعك، تحتاج إلى تثبيت Minds SDK:
|
|
|
|
```shell
|
|
uv add minds-sdk
|
|
```
|
|
|
|
## خطوات البدء
|
|
|
|
لاستخدام `AIMindTool` بفعالية، اتبع الخطوات التالية:
|
|
|
|
1. **تثبيت الحزمة**: تأكد من تثبيت حزمتي `crewai[tools]` و`minds-sdk` في بيئة Python.
|
|
2. **الحصول على مفتاح API**: سجّل في حساب Minds [هنا](https://mdb.ai/register)، واحصل على مفتاح API.
|
|
3. **إعداد البيئة**: خزّن مفتاح API الذي حصلت عليه في متغير بيئة باسم `MINDS_API_KEY` لتسهيل استخدامه من قبل الأداة.
|
|
|
|
## مثال
|
|
|
|
يوضح المثال التالي كيفية تهيئة الأداة وتنفيذ استعلام:
|
|
|
|
```python 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**: قائمة الجداول التي سيستخدمها مصدر البيانات. هذا اختياري ويمكن حذفه إذا كانت جميع الجداول في مصدر البيانات مطلوبة.
|
|
|
|
يمكن العثور على قائمة مصادر البيانات المدعومة ومعاملات اتصالها [هنا](https://docs.mdb.ai/docs/data_sources).
|
|
|
|
## مثال على التكامل مع الوكيل
|
|
|
|
إليك كيفية دمج `AIMindTool` مع وكيل CrewAI:
|
|
|
|
```python 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، تمكّن هذه الأداة الوكلاء من الوصول إلى البيانات وتحليلها بكفاءة.
|