كيفية إعداد LlamaIndex: دليل عملي لفرق الذكاء الاصطناعي المؤسسية

# تثبيت الحزمة الأساسية (التبعيات الدنيا)
pip install llama-index-core

# تثبيت الحزمة الكاملة (يتضمن الوسائط المتعددة، الوكلاء، إلخ.)
pip install llama-index

# التحقق من التثبيت
python -c "from llama_index.core import VectorStoreIndex; print('LlamaIndex v0.10.28 جاهز')"
# المخرج المتوقع: LlamaIndex v0.10.28 جاهز

npm install llamaindex
# أو
yarn add llamaindex

# التحقق من التثبيت
node -e "const { VectorStoreIndex } = require('llamaindex'); console.log('LlamaIndex.TS v0.3.12 جاهز')"
# المخرج المتوقع: LlamaIndex.TS v0.3.12 جاهز

from llama_index.core import SimpleDirectoryReader

# تحميل المستندات من مجلد (يدعم PDF، DOCX، CSV، إلخ.)
documents = SimpleDirectoryReader("data/").load_data()
print(f"تم تحميل {len(documents)} مستندات")
# المخرج المتوقع: تم تحميل 3 مستندات

# تحليل إلى عقد (أجزاء مع بيانات وصفية)
from llama_index.core.node_parser import SentenceSplitter
parser = SentenceSplitter(chunk_size=512, chunk_overlap=20)
nodes = parser.get_nodes_from_documents(documents)
print(f"تم إنشاء {len(nodes)} عقد")
# المخرج المتوقع: تم إنشاء 42 عقدة

from llama_index.core import VectorStoreIndex

# إنشاء فهرس متجهات (يستخدم تضمينات OpenAI افتراضياً)
index = VectorStoreIndex.from_documents(documents)

# الحفظ على القرص
index.storage_context.persist("storage/")

INFO:llama_index.core.storage.storage_context:تم حفظ VectorStoreIndex في storage/

from llama_index.core import KeywordTableIndex

keyword_index = KeywordTableIndex.from_documents(documents)

from llama_index.core import TreeIndex

tree_index = TreeIndex.from_documents(documents)
# الاستعلام مع اجتياز فرع فرعي
query_engine = tree_index.as_query_engine(child_branch_factor=2)
response = query_engine.query("لخص النقاط الرئيسية")
print(response)

query_engine = index.as_query_engine()
response = query_engine.query("ما هي مخاطر الذكاء الاصطناعي في عام 2026؟")
print(response)

تشمل مخاطر الذكاء الاصطناعي في عام 2026:
1. إزاحة الوظائف في الصناعات الإبداعية.
2. زيادة المعلومات المضللة عبر التزييف العميق.
3. فجوات تنظيمية في النماذج متعددة الوسائط.
المصدر: data/report.pdf (صفحة 42)

from llama_index.core import QueryBundle
from llama_index.core.retrievers import BaseRetriever

class HybridRetriever(BaseRetriever):
    def __init__(self, vector_index, keyword_index):
        self.vector_retriever = vector_index.as_retriever()
        self.keyword_retriever = keyword_index.as_retriever()

    def _retrieve(self, query_bundle: QueryBundle):
        vector_nodes = self.vector_retriever.retrieve(query_bundle)
        keyword_nodes = self.keyword_retriever.retrieve(query_bundle)
        return vector_nodes + keyword_nodes

retriever = HybridRetriever(index, keyword_index)
query_engine = index.as_query_engine(retriever=retriever)

from llama_index.core import get_response_synthesizer
from llama_index.core.retrievers import BaseRetriever
from llama_index.core.schema import NodeWithScore
from typing import List

class TimeBasedRetriever(BaseRetriever):
    def __init__(self, index, time_field="date"):
        self.index = index
        self.time_field = time_field

    def _retrieve(self, query_bundle: QueryBundle) -> List[NodeWithScore]:
        # تصفية العقد حسب الوقت (مثلاً، "المستندات من 2025-2026")
        nodes = self.index.docstore.get_nodes()
        filtered_nodes = [
            node for node in nodes
            if node.metadata.get(self.time_field, "").startswith("2025")
        ]
        return [NodeWithScore(node=node, score=1.0) for node in filtered_nodes]

retriever = TimeBasedRetriever(index)
query_engine = index.as_query_engine(retriever=retriever)

from llama_index.core.evaluation import (
    generate_question_context_pairs,
    EmbeddingQAFinetuneDataset,
)
from llama_index.evaluation import RetrieverEvaluator

# توليد أزواج أسئلة وأجوبة اصطناعية
qa_dataset = generate_question_context_pairs(documents, num_questions_per_chunk=2)

# تقييم أداة الاسترجاع
retriever = index.as_retriever(similarity_top_k=2)
evaluator = RetrieverEvaluator.from_metric_names(
    ["mrr", "hit_rate"], retriever=retriever
)
eval_results = await evaluator.aevaluate_dataset(qa_dataset)
print(eval_results)

{'mrr': 0.85, 'hit_rate': 0.92}

from fastapi import FastAPI
from llama_index.core import VectorStoreIndex
from pydantic import BaseModel

app = FastAPI()
index = VectorStoreIndex.from_documents(documents)

class QueryRequest(BaseModel):
    query: str

@app.post("/query")
async def query_index(request: QueryRequest):
    query_engine = index.as_query_engine()
    response = query_engine.query(request.query)
    return {"response": str(response)}

# التشغيل باستخدام: uvicorn app:app --reload

{
  "response": "تشمل مخاطر الذكاء الاصطناعي في عام 2026 إزاحة الوظائف والمعلومات المضللة."
}

from llama_index.core.callbacks import CallbackManager
from llama_index.callbacks.arize_ai import ArizeCallbackHandler

arize_callback = ArizeCallbackHandler(
    api_key="...",
    space_key="...",
)
callback_manager = CallbackManager([arize_callback])
index = VectorStoreIndex.from_documents(
    documents, callback_manager=callback_manager
)

from llama_index.indices.managed.llama_cloud import LlamaCloudIndex

index = LlamaCloudIndex.from_documents(
    documents,
    name="my-production-index",
    project_name="my-project",
    api_key="llx-...",
)