advanced⏱40 minutesLição 4 de 10
RAG Agentic
Construa sistemas RAG (Geração Aumentada por Recuperação) Agentic com LangGraph — nós de recuperação, integração com armazenamento de documentos, planejamento de consultas e recuperação em múltiplas etapas.
RAG Agentic
RAG Agentic combines retrieval-augmented generation with agentic decision-making. Instead of a single retrieve-then-generate pipeline, the agent decides when and what to retrieve, plans queries, and iteratively refines results.
Do RAG Simples ao RAG Agentic
RAG Simples (Recuperar → Gerar)
Query → Embed → Retrieve → LLM → Answer
RAG Agentic
Query → Analyze → Plan queries → Retrieve → Evaluate → Need more? → Yes → Refine query → Retrieve
↓ No
Generate answer
The agent has tools for retrieval and makes decisions about how to use them.
Componentes Principais
python
from langchain_openai import ChatOpenAI, OpenAIEmbeddings
from langchain_community.vectorstores import Chroma
from langchain_core.tools import tool
from langchain_core.documents import Document
from langgraph.graph import StateGraph, START, END, add_messages
from typing_extensions import TypedDict, Annotated
from typing import List, Any
from langgraph.prebuilt import ToolExecutor
# Vector store
embeddings = OpenAIEmbeddings()
vectorstore = Chroma(
collection_name="documents",
embedding_function=embeddings,
persist_directory="./chroma_db"
)
retriever = vectorstore.as_retriever(search_kwargs={"k": 4})Definindo Ferramentas de Recuperação
python
@tool
def search_documents(query: str) -> str:
"""Search the knowledge base for relevant documents. Use for factual questions."""
docs = retriever.invoke(query)
return "\n\n".join(f"Source: {d.metadata.get('source', 'unknown')}\n{d.page_content}"
for d in docs)
@tool
def search_by_metadata(filters: str) -> str:
"""Search documents by metadata. Provide as JSON: {\"source\": \"report_2024.pdf\"}"""
import json
filters_dict = json.loads(filters)
docs = vectorstore.similarity_search("", filter=filters_dict, k=5)
return "\n\n".join(d.page_content for d in docs)
@tool
def web_search(query: str) -> str:
"""Search the web for current information not in the knowledge base."""
return f"Web results for: {query}"[!NOTA]
Different retrieval tools serve different needs. search_documents for semantic search, search_by_metadata for filtered access, and web_search as a fallback for current info.
Agente com Ferramentas de Recuperação
python
llm = ChatOpenAI(model="gpt-4o")
tools = [search_documents, search_by_metadata, web_search]
llm_with_tools = llm.bind_tools(tools)
tool_executor = ToolExecutor(tools)
class RAGState(TypedDict):
messages: Annotated[List[Any], add_messages]
context: List[str]
query_plan: List[str]
def agent_node(state: RAGState) -> dict:
"""Decides whether to retrieve or answer."""
system = """You are an AI research assistant with access to a knowledge base.
- If you need information, use search_documents or web_search
- If the user asks for specific sources, use search_by_metadata
- Once you have sufficient information, answer the question
- Cite your sources"""
messages = [SystemMessage(system)] + state["messages"]
response = llm_with_tools.invoke(messages)
return {"messages": [response]}
def tool_node(state: RAGState) -> dict:
"""Execute tool calls from the agent."""
last = state["messages"][-1]
if not last.tool_calls:
return {}
new_messages = []
for tc in last.tool_calls:
result = tool_executor.invoke(tc)
new_messages.append(ToolMessage(content=str(result), tool_call_id=tc["id"]))
return {"messages": new_messages}
def router(state: RAGState) -> str:
last = state["messages"][-1]
if hasattr(last, "tool_calls") and last.tool_calls:
return "tool"
return "end"
builder = StateGraph(RAGState)
builder.add_node("agent", agent_node)
builder.add_node("tool", tool_node)
builder.add_edge(START, "agent")
builder.add_conditional_edges("agent", router, {"tool": "tool", "end": END})
builder.add_edge("tool", "agent") # Loop back
app = builder.compile()Planejamento de Consultas
Instead of a single retrieval, plan multiple sub-queries:
python
def plan_queries(state: RAGState) -> dict:
prompt = ChatPromptTemplate.from_messages([
("system", "Break down the user's question into 3-5 specific sub-queries "
"that together cover all aspects. Return as a numbered list."),
("human", "{question}")
])
chain = prompt | llm | StrOutputParser()
plan = chain.invoke({"question": state["messages"][-1].content})
queries = [q.strip() for q in plan.split("\n") if q.strip() and q[0].isdigit()]
return {"query_plan": queries}[!SUCESSO] Query planning ensures comprehensive coverage by breaking a broad question into focused sub-queries, each targeting different aspects of the topic.
Recuperação de Múltiplas Consultas
python
@tool
def multi_query_search(main_question: str) -> str:
"""Break down a question and search multiple aspects."""
# Generate sub-queries
prompt = f"Break this into 3 sub-queries: {main_question}"
response = llm.invoke(prompt)
queries = [q.strip() for q in response.content.split("\n")
if q.strip() and not q.strip().startswith(("-", "1", "2", "3", "4", "5"))]
# Search each
all_results = []
for q in queries[:5]: # Limit to 5 queries
docs = retriever.invoke(q)
for d in docs:
all_results.append(d)
# Deduplicate and format
seen = set()
unique = []
for d in all_results:
if d.page_content[:100] not in seen:
seen.add(d.page_content[:100])
unique.append(d)
return "\n\n---\n\n".join(
f"[Relevance: {d.metadata.get('score', 'N/A')}]\n{d.page_content}"
for d in unique[:10]
)Pontuação de Relevância
Evaluate if retrieved documents are actually relevant:
python
def score_relevance(query: str, doc: str) -> float:
prompt = f"""On a scale of 0.0 to 1.0, how relevant is this document to the query?
Query: {query}
Document: {doc[:500]}
Relevance score (respond with only the number):"""
response = llm.invoke(prompt)
try:
return float(response.content.strip())
except ValueError:
return 0.0
def filter_relevant_docs(state: RAGState) -> dict:
query = state["messages"][-1].content if state["messages"] else ""
relevant = []
for doc in state.get("context", []):
score = score_relevance(query, doc)
if score > 0.5:
relevant.append(doc)
return {"context": relevant}[!AVISO] Relevance scoring adds an LLM call per document. For large result sets, consider embedding similarity scores as a cheaper proxy.
Sistema RAG Agentic Completo
python
from langgraph.graph import StateGraph, START, END, add_messages
from langgraph.checkpoint.memory import MemorySaver
from langchain_openai import ChatOpenAI
from langchain_core.messages import SystemMessage, ToolMessage
from langchain_core.tools import tool
from langgraph.prebuilt import ToolExecutor
from typing_extensions import TypedDict, Annotated
from typing import List, Any
llm = ChatOpenAI(model="gpt-4o")
retriever = vectorstore.as_retriever(search_kwargs={"k": 5})
@tool
def retrieve(query: str) -> str:
"""Search the knowledge base."""
docs = retriever.invoke(query)
return "\n".join(d.page_content[:500] for d in docs)
tools = [retrieve]
llm_with_tools = llm.bind_tools(tools)
tool_executor = ToolExecutor(tools)
class AgentState(TypedDict):
messages: Annotated[List[Any], add_messages]
def agent(state: AgentState) -> dict:
messages = [SystemMessage("Answer using the knowledge base. "
"Use the retrieve tool if you need information.")] + state["messages"]
response = llm_with_tools.invoke(messages)
return {"messages": [response]}
def tools_node(state: AgentState) -> dict:
last = state["messages"][-1]
if not last.tool_calls:
return {}
return {"messages": [ToolMessage(
content=str(tool_executor.invoke(tc)),
tool_call_id=tc["id"]
) for tc in last.tool_calls]}
def router(state: AgentState) -> str:
last = state["messages"][-1]
if hasattr(last, "tool_calls") and last.tool_calls:
return "tools"
return "end"
builder = StateGraph(AgentState)
builder.add_node("agent", agent)
builder.add_node("tools", tools_node)
builder.add_edge(START, "agent")
builder.add_conditional_edges("agent", router, {"tools": "tools", "end": END})
builder.add_edge("tools", "agent")
app = builder.compile(checkpointer=MemorySaver())Perguntas Práticas
Practice Question
What distinguishes Agentic RAG from simple RAG?
Practice Question
What pattern does the agentic retrieval loop follow?
Practice Question
What is query planning in Agentic RAG?
Practice Question
Why might you include a web_search tool alongside a document retriever?
Practice Question
What is the purpose of relevance scoring in Agentic RAG?
Practice Question
What type of search does search_by_metadata enable?
Practice Question
What is the trade-off of relevance scoring with LLM?
Practice Question
In the agentic RAG loop, what triggers the agent to answer instead of retrieve?
Practice Question
What does the multi_query_search tool do?
Practice Question
What reducer is used for the messages field in the RAG agent state?
[!SUCESSO]
Principais Conclusões
- RAG Agentic gives the agent control over retrieval decisions
- ReAct loop: agent → tool (retrieve) → agent → ... → final answer
- Multiple retrieval tools serve different needs (semantic, metadata, web)
- Query planning decomposes questions into comprehensive sub-queries
- Relevance scoring filters irrelevant retrieved documents
- Tool-based retrieval enables the agent to decide when to search vs. answer
- Multi-query search ensures broad coverage of complex topics
Progresso40%