# 1) நிறுவவும்
# pip install llama-index llama-index-embeddings-openai llama-index-llms-openai
import os
from llama_index.core import VectorStoreIndex, SimpleDirectoryReader
from llama_index.embeddings.openai import OpenAIEmbedding
from llama_index.llms.openai import OpenAI
# 2) உங்கள் model + embeddings ஐ உள்ளமைக்கவும்
os.environ["OPENAI_API_KEY"] = "YOUR_KEY" # அல்லது ஆதரிக்கப்படும் LLM/embedding provider ஐப் பயன்படுத்தவும்
llm = OpenAI(model="gpt-4o-mini")
embed_model = OpenAIEmbedding(model="text-embedding-3-small")
# 3) ஆவணங்களை ஏற்றவும் (எ.கா., ./data/*.pdf, .md, .txt)
docs = SimpleDirectoryReader("./data").load_data
# 4) ஒரு index ஐ உருவாக்கவும்
index = VectorStoreIndex.from_documents(docs, embed_model=embed_model)
# 5) ஒரு query engine ஐ உருவாக்கி ஒரு கேள்வி கேளுங்கள்
query_engine = index.as_query_engine(llm=llm)
response = query_engine.query("ஆவணங்களில் குறிப்பிடப்பட்டுள்ள முக்கிய பாதுகாப்பு நடைமுறைகள் என்ன?")
print(response)

from llama_index.core import SimpleDirectoryReader
from llama_index.readers.web import SimpleWebPageReader
file_docs = SimpleDirectoryReader("./policies").load_data
web_docs = SimpleWebPageReader(html_to_text=True).load_data
all_docs = file_docs + web_docs

from llama_index.core.node_parser import SentenceSplitter
from llama_index.core import Document
parser = SentenceSplitter(chunk_size=800, chunk_overlap=100)
nodes = []
for d in all_docs:
nodes.extend(parser.get_nodes_from_documents([Document(text=d.text, metadata=d.metadata)]))

from llama_index.core import VectorStoreIndex, SummaryIndex
from llama_index.core.retrievers import BM25Retriever
from llama_index.core.query_engine import RetrieverQueryEngine
# Vector index pre-parsed nodes இலிருந்து
v_index = VectorStoreIndex(nodes)
# BM25 keyword retriever
bm25_retriever = BM25Retriever.from_defaults(nodes=nodes, similarity_top_k=6)
# Hybrid: candidates ஐ merge செய்து, பின்னர் rerank செய்யவும்
from llama_index.core.retrievers import RouterRetriever
from llama_index.retrievers.merge import MergerRetriever
v_retriever = v_index.as_retriever(similarity_top_k=6)
hybrid = MergerRetriever(retrievers=[v_retriever, bm25_retriever], top_k=8)
query_engine = RetrieverQueryEngine.from_args(retriever=hybrid)

from llama_index.postprocessor.flag_embedding_reranker import FlagEmbeddingReranker
from llama_index.core.query_engine import RetrieverQueryEngine
reranker = FlagEmbeddingReranker(top_n=5, model="BAAI/bge-reranker-base")
query_engine = v_index.as_query_engine(
similarity_top_k=12,
node_postprocessors=[reranker]
)

from llama_index.core.response_synthesizers import get_response_synthesizer
from llama_index.core import ServiceContext
synth = get_response_synthesizer(response_mode="tree_summarize")
query_engine = v_index.as_query_engine(response_synthesizer=synth)
ans = query_engine.query("onboarding படிகளை சுருக்கி மூலங்களை மேற்கோள் காட்டுங்கள்.")
print(ans)

from llama_index.core.prompts import PromptTemplate
qa_tmpl = PromptTemplate(
"""
நீங்கள் ஒரு சுருக்கமான, சான்றுகள் அடிப்படையிலான உதவியாளர். வழங்கப்பட்ட context ஐ மட்டும் பயன்படுத்தவும்.
சந்தேகம் இருந்தால், எனக்குத் தெரியாது என்று சொல்லுங்கள். answer, sources விசைகளுடன் JSON ஐத் திருப்பி அனுப்பவும்.
கேள்வி: {query_str}
Context: {context_str}
"""
)
query_engine = v_index.as_query_engine(text_qa_template=qa_tmpl)

from llama_index.core.agent import ReActAgent
from llama_index.tools.sql import SQLQueryEngineTool
from sqlalchemy import create_engine
engine = create_engine("sqlite:///analytics.db")
sql_tool = SQLQueryEngineTool.from_engine(engine)
agent = ReActAgent.from_tools([sql_tool], llm=llm, verbose=True)
agent.chat("Q2 2025 இல் மாதாந்திர churn என்ன? தேவைப்பட்டால், DB ஐ query செய்யவும்.")

from llama_index.core.evaluation import FaithfulnessEvaluator, RelevancyEvaluator
faith = FaithfulnessEvaluator(llm=llm)
rel = RelevancyEvaluator(llm=llm)
pred = query_engine.query("எங்கள் கொள்கையில் SOC 2 control families ஐ பட்டியலிடுங்கள்.")
print("faithful?", faith.evaluate_response(pred))
print("relevant?", rel.evaluate_response(pred))

# எடுத்துக்காட்டு: Chroma
# pip install chromadb llama-index-vector-stores-chroma
from llama_index.vector_stores.chroma import ChromaVectorStore
from llama_index.core import StorageContext
import chromadb
chroma_client = chromadb.PersistentClient(path="./chroma_store")
collection = chroma_client.get_or_create_collection("company_knowledge")
vector_store = ChromaVectorStore(chroma_collection=collection)
storage_context = StorageContext.from_defaults(vector_store=vector_store)
index = VectorStoreIndex.from_documents(all_docs, storage_context=storage_context)

# எடுத்துக்காட்டு: query நேரத்தில் metadata-based filtering
retriever = index.as_retriever(similarity_top_k=8)
retriever.metadata_filters = {"department": ["legal", "security"], "published": [True]}

# குறைந்தபட்ச FastAPI wrapper
# pip install fastapi uvicorn
from fastapi import FastAPI
app = FastAPI
qe = index.as_query_engine(llm=llm)
@app.post("/query")
async def query(payload: dict):
q = payload.get("q", "")
resp = qe.query(q)
return {"answer": str(resp), "sources": [s.node.metadata for s in resp.source_nodes]}