Esta postagem faz parte do panorama Native AI de Aurabase. Nenhuma das estruturas oferece um conector proprietário para um banco de dados: a conexão com Postgres passa, em ambos os casos, por meio de um driver SQL genérico (SQLAlchemy no lado do Python) e uma string de conexão padrão. Isso é verdade para Aurabase assim como para qualquer Postgres gerenciado.
- LangChain: estrutura geral de orquestração LLM (cadeias, ferramentas, memória). Os agentes são construídos hoje por meio de
LangGraphe o SQL é tratado como um kit de ferramentas entre outros. - LlamaIndex: framework de dados nascido para RAG e consulta de fontes estruturadas. Mecanismo SQL nativo (
NLSQLTableQueryEngine), agentes por meio de seu mecanismoWorkflows. - CrewAI e AutoGen não são alternativas para LangChain/LlamaIndex: são camadas de orquestração multiagentes, colocadas em cima de uma das duas (ou uma função Python interna).
- Nem LangChain nem LlamaIndex oferecem um conector Postgres proprietário: ambos usam SQLAlchemy, compatível com qualquer Postgres gerenciado, Aurabase incluído.
- Nenhuma integração de pacote Aurabase existe para essas estruturas até o momento. A conexão é feita por meio da string de conexão padrão Postgres exposta por cada projeto.
Duas estruturas nascidas para necessidades diferentes
LangChain e LlamaIndex apareceram durante o mesmo período, após o lançamento do ChatGPT no final de 2022. Seu ponto de partida difere marcadamente. LangChain modela um aplicativo LLM como uma cadeia de etapas combináveis: prompt, chamada de modelo, ferramenta, memória, tudo montado por meio de LCEL ou um gráfico LangGraph.
LlamaIndex primeiro modela dados: documentos, nós, índices, mecanismo de consulta. Um VectorStoreIndex ou SQLDatabase são cidadãos de primeira classe, não ferramentas adicionadas a um agente genérico. Ambos são de código aberto (licença MIT), disponíveis em Python e TypeScript, e hoje cobrem um escopo amplamente sobreposto: agentes, RAG, chamada de ferramenta, conexão SQL.
Essa convergência torna a comparação mais útil na arquitetura do que na lista de funcionalidades: ambas podem, quase, fazer a mesma coisa. O que muda é como.
Como todos se conectam a Postgres, sem integração de pacote
No lado LangChain, o módulo langchain_community.utilities.SQLDatabase encapsula um mecanismo SQLAlchemy. O agente create_sql_agent então o expõe como um conjunto de ferramentas: listar tabelas, descrever um esquema, executar uma consulta, verificar uma consulta antes da execução.
from langchain_community.utilities import SQLDatabase
from langchain_community.agent_toolkits import create_sql_agent
from langchain_openai import ChatOpenAI
# Canal obtido em Studio → Configurações → Conexão.
# rota search_path para o esquema do projeto (consulte o documento SQLAlchemy/psycopg para
# a codificação exata do parâmetro "options" dependendo do driver utilizado).
db = SQLDatabase.from_uri(
"postgresql+psycopg2://aura:***@<host>:5432/aura_db_master?options=-csearch_path%3Dproject_<id>"
)
llm = ChatOpenAI(model="gpt-4o-mini")
agent = create_sql_agent(llm=llm, db=db, agent_type="tool-calling")
agent.invoke({"input": "Combien de commandes la semaine dernière ?"})
No lado LlamaIndex, a abstração equivalente é llama_index.core.SQLDatabase, também construída em um mecanismo SQLAlchemy. O mecanismo de consulta NLSQLTableQueryEngine traduz uma pergunta de linguagem natural em uma consulta SQL, executa-a e então reformula o resultado como uma resposta.
from sqlalchemy import create_engine
from llama_index.core import SQLDatabase
from llama_index.core.query_engine import NLSQLTableQueryEngine
from llama_index.llms.openai import OpenAI
engine = create_engine(
"postgresql+psycopg2://aura:***@<host>:5432/aura_db_master?options=-csearch_path%3Dproject_<id>"
)
sql_database = SQLDatabase(engine, include_tables=["orders", "customers"])
query_engine = NLSQLTableQueryEngine(
sql_database=sql_database, llm=OpenAI(model="gpt-4o-mini"),
)
response = query_engine.query("Combien de commandes la semaine dernière ?")
Nenhuma das extrações depende de Aurabase. Um driver SQLAlchemy e uma cadeia de conexão Postgres padrão são suficientes, assim como para Supabase, RDS ou uma instância auto-hospedada.
LangGraph versus Workflows: duas maneiras de orquestrar um agente
LangChain propôs pela primeira vez um loop de agente clássico (AgentExecutor, padrão ReAct). Desde então, o projeto convergiu seus agentes para LangGraph: um agente é ali representado como um gráfico explícito de nós e arestas, com pontos de verificação e possível intervenção humana entre dois estágios.
LlamaIndex responde com seu Workflows: uma orquestração orientada a eventos, onde cada etapa emite e consome eventos digitados. Um mecanismo de consulta SQL ou vetorial se conecta diretamente como uma etapa, sem uma camada de adaptação adicional, uma vez que esses mecanismos já são primitivos nativos do framework.
Para um agente consultando Postgres, a diferença prática é esta: LangGraph fornece controle refinado sobre ramificações e novas tentativas em torno de uma chamada SQL. LlamaIndex requer menos código de ligação quando a questão diz respeito primeiro a dados já indexados pela estrutura.
Vá mais fundo: tutorial de chamada de função para um agente Postgres
Onde LlamaIndex permanece um passo histórico à frente
LlamaIndex foi projetado desde o início para conectar um LLM a fontes de dados, com um catálogo de conectores (LlamaHub) e índices especializados dependendo do tipo de conteúdo. O RAG continua sendo o caso de uso mais direto da estrutura, e não um recurso adicionado posteriormente.
LangChain cobre a mesma necessidade por meio de suas cadeias retrievers e de busca, com integração igualmente madura no ecossistema LangGraph. A diferença tem menos a ver com a capacidade do que com o local onde reside a lógica de negócios: integrada ao índice no lado LlamaIndex, montada explicitamente em uma cadeia no lado LangChain.
Ambos sabem usar pgvector como base vetorial: llama-index-vector-stores-postgres no lado LlamaIndex, a classe PGVector do pacote langchain-postgres no lado LangChain. Em um projeto Aurabase, pgvector 0.8.6 já está presente na imagem do locatário Postgres: ambos os pacotes se conectam a ele com a mesma cadeia de conexão, sem uma etapa de ativação separada.
CrewAI e AutoGen: quando um único agente não é mais suficiente
CrewAI orquestra vários agentes por função: cada agente recebe um objetivo, um contexto (backstory) e ferramentas, agrupados em Crew com Task executado em sequência ou de acordo com uma hierarquia. É uma estrutura de orquestração completa, não uma extensão de LangChain.
AutoGen, um projeto de pesquisa da Microsoft, adota uma abordagem diferente: agentes que conversam entre si (AssistantAgent, UserProxyAgent, GroupChat), com a capacidade de executar código em um ambiente isolado. A coordenação parece uma conversa, não um gráfico de estado explícito como LangGraph.
Nenhum deles substitui a camada de conexão de dados. Um agente CrewAI ou AutoGen que precisa ler Postgres chama, na prática, uma ferramenta SQL construída com LangChain ou LlamaIndex, ou uma função Python simples em torno de psycopg2. CrewAI e AutoGen respondem “quem faz o quê e em que ordem”, não “como ler o banco de dados”.
O que nenhum dos dois faz nativamente em um banco de dados Postgres
create_sql_agent e NLSQLTableQueryEngine executam a consulta gerada pelo modelo na conexão fornecida. Nem limita o número de linhas retornadas por padrão, nem bloqueia uma solicitação de gravação: a proteção real é a função Postgres usada na cadeia de conexão, não uma opção de estrutura.
Esta é uma diferença estrutural com o NL2SQL nativo de Aurabase, que traduz uma pergunta em SQL no lado do servidor, valida a consulta gerada (análise SQL, rejeição de campos de servidor falsificados) e limita o LIMIT antes da execução. Não é o mesmo tijolo: um endpoint NL2SQL responde de uma só vez, com guarda-corpos instalados pela plataforma; um agente LangChain ou LlamaIndex raciocina em vários estágios, com salvaguardas para você mesmo montar.
Na prática, as duas abordagens se complementam em vez de se excluirem: um endpoint NL2SQL limitado para uma pergunta simples exposta a um usuário final, um agente para raciocínio em várias etapas que combina diversas ferramentas além do SQL.
LangChain, LlamaIndex, CrewAI, AutoGen em uma tabela
| Objetivo principal | Orquestração LLM generalista | Estrutura de dados / RAG | Orquestração multiagente por funções | Orquestração conversacional multiagente |
|---|---|---|---|---|
| Agente primitivo | LangGraph (gráfico de estado) | Fluxos de trabalho (etapas do evento) | Tripulação/Tarefa/Processo | AssistenteAgente / GroupChat |
| Conexão SQL nativa | SQLDatabase + create_sql_agent | SQLDatabase + NLSQLTableQueryEngine | Nenhum (ferramenta externa) | Nenhum (ferramenta externa) |
| Suporte pgvector | langchain-postgres (PGVector) | lhama-índice-vetor-lojas-postgres | Não nativo | Não nativo |
| Multiagente nativo | Não (vários nós LangGraph) | Não (fluxo de agente único) | Sim | Sim |
| Licença | MIT | MIT | MIT | MIT (projeto de pesquisa da Microsoft) |
| LANGCHAIN | LAMAINDEX | CREWAI | AUTOGEN |
Conecte LangChain ou LlamaIndex em um backend Postgres padrão
Três etapas são suficientes, independente do framework escolhido, e não dependem de nenhum conector específico da plataforma.
# 1. Recupere a string de conexão Postgres do projeto
# (Estúdio → Configurações → Conexão ou qualquer Postgres gerenciado)
export AURA_DB_URL="postgresql+psycopg2://aura:***@<host>:5432/aura_db_master?options=-csearch_path%3Dproject_<id>"
# 2. Instale o driver SQL e o framework escolhido
pip install langchain langchain-community langchain-openai psycopg2-binary
# ou, no lado LlamaIndex:
pip install llama-index llama-index-llms-openai psycopg2-binary
# 3. Crie uma função Postgres dedicada, somente leitura se o agente precisar apenas pesquisar
CREATE ROLE agent_readonly LOGIN PASSWORD '***';
GRANT SELECT ON ALL TABLES IN SCHEMA project_<id> TO agent_readonly;
A terceira etapa é mais importante do que a escolha da estrutura. Uma função Postgres restrita a direitos verdadeiramente necessários continua sendo a única salvaguarda confiável contra uma solicitação gerada que exceda seu escopo, independentemente do agente que a executa. Consulte a documentação do AI para a configuração dos provedores LLM nativos de Aurabase(OpenAI, Anthropic, Gemini) utilizáveis no lado do agente.
Qual escolher de acordo com seu projeto
Nenhuma das estruturas é estritamente superior para um agente conectado a Postgres. O contexto inicial do projeto é mais decisivo do que a lista de funcionalidades.
- LangChain: se o agente deve combinar diversas ferramentas heterogêneas (SQL, APIs externas, web search) com controle fino do fluxo via LangGraph, e se a equipe valoriza o ecossistema de integração mais amplo do mercado.
- LlamaIndex: se o coração do projeto é o RAG ou a consulta de dados já indexados, com forte necessidade de conectores de origem e um modelo de índice/consulta que se ajuste diretamente ao caso de uso.
- CrewAI ou AutoGen além de: assim que um único agente não for mais suficiente e o trabalho tiver que ser distribuído entre várias funções especializadas, acima de uma ou outra das duas estruturas de dados.
Os dois também podem coexistir no mesmo projeto: um mecanismo de consulta LlamaIndex exposto como uma ferramenta em um agente LangGraph é um padrão comum. Manter duas estruturas tem um custo real de complexidade, que deve ser ponderado em relação ao ganho antes de adotá-lo por padrão.
Perguntas frequentes
LangChain e LlamaIndex podem modificar dados Postgres (INSERT, UPDATE, DELETE)?+
create_sql_agent no lado LangChain nem NLSQLTableQueryEngine no lado LlamaIndex restringem nativamente consultas somente leitura. A verdadeira salvaguarda surge no nível de Postgres: uma função de aplicativo dedicada com GRANTs limitados a SELECT. Consulte também o guia sobre como proteger NL2SQL contra injeção de SQL.