Este repositório open source acabou de resolver o problema nº 1 do Claude Code
CChase AI
Computing/SoftwareSmall Business/StartupsInternet Technology
Transcript
00:00:00O Graphify acaba de resolver o problema de memória do Claude Code.
00:00:03Ele consegue transformar qualquer repositório em um grafo de conhecimento incrível,
00:00:06exatamente como o que você vê aqui.
00:00:08E, no processo, ele permite que o Claude Code lhe dê respostas mais precisas
00:00:12por uma fração do custo em tokens.
00:00:14Ele consegue fazer isso percorrendo todo o seu código,
00:00:17mapeando todas as conexões e discernindo o porquê por trás delas.
00:00:21E o melhor de tudo é que também é open source e totalmente gratuito.
00:00:24Então, hoje vou mostrar como você mesmo pode colocar isso para funcionar
00:00:27e o que está acontecendo por baixo dos panos,
00:00:30para que você possa começar a aproveitar agora mesmo.
00:00:32O Graphify surgiu há alguns meses.
00:00:34Ele tem quase 60 mil estrelas.
00:00:36E o que ele faz é permitir que seu assistente de codificação de IA,
00:00:39não precisa ser o Claude Code, mas é o que usaremos hoje,
00:00:41mapeie todo o seu projeto, código, documentos, PDFs, imagens e vídeos
00:00:45em um grafo de conhecimento que você pode consultar em vez de procurar nos arquivos.
00:00:49Então, podemos pegar o Graphify e apontá-lo para qualquer tipo de repositório que quisermos,
00:00:54e ele cria esse tipo de grafo de conhecimento.
00:00:55A razão pela qual nos importamos com isso é que, ao criar um grafo de conhecimento,
00:01:00o Claude Code consegue responder mais facilmente a perguntas sobre aquele repositório
00:01:04porque tudo já está mapeado.
00:01:06Fica muito claro como A se conecta a B, como B se conecta a C,
00:01:09e por que essas conexões importam.
00:01:11Isso contrasta com a busca manual em arquivos,
00:01:13que é como os assistentes de codificação de IA como o Claude Code normalmente funcionam.
00:01:16Uma analogia um tanto simplista, mas é como se ele estivesse apenas fazendo um Control-F
00:01:19e tentando procurar, em vez de ter um caminho claramente mapeado de como tudo está funcionando, certo?
00:01:25Isso dá ao Claude Code um mapa, enquanto a busca em arquivos não dá nada.
00:01:29Então, por causa disso, custa menos tokens obter respostas mais precisas com algo como o Graphify.
00:01:35Agora, quão significativa é essa economia de tokens?
00:01:37Bem, algumas pessoas afirmam que chega a 70x, o que achei um pouco exagerado.
00:01:41E como você verá quando demonstrarmos hoje,
00:01:42é um pouco menos que 70x, mas ainda é significativo.
00:01:45Então esse é o porquê de você se importar.
00:01:47Agora vamos falar sobre como ele realmente funciona.
00:01:48Como passamos de uma base de código para algum tipo de grafo de conhecimento como este,
00:01:51que parece muito, muito similar a algo como uma base de conhecimento Graph RAG.
00:01:56São a mesma coisa?
00:01:56Como isso se relaciona com RAG?
00:01:57Vamos falar sobre isso.
00:01:58Bem, a forma como funciona é através de três passagens diferentes.
00:02:00Na primeira passagem, estamos analisando a estrutura do código,
00:02:03e isso é totalmente gratuito.
00:02:05Tudo o que você vê aqui, é apenas através da primeira passagem.
00:02:09Isso é determinístico.
00:02:10Isso não é uma IA fazendo um jogo de adivinhação.
00:02:12Ele está literalmente percorrendo o próprio código e dizendo,
00:02:15esta parte do código se relaciona com esta segunda parte.
00:02:18E é literalmente assim que a base de código é escrita.
00:02:20Essas são conexões estabelecidas.
00:02:22Como diz aqui, um tree sitter analisa seus arquivos de código e extrai classes,
00:02:26funções, importações, grafos de chamadas e comentários embutidos.
00:02:29Isso roda localmente sem envolver LLM.
00:02:31Na segunda passagem, ele analisa vídeo e áudio,
00:02:34se esses arquivos existirem.
00:02:36E se existirem, eles serão transcritos com o faster whisper.
00:02:39E, uma vez que eles sejam convertidos em texto,
00:02:41eles também serão injetados no grafo de conhecimento.
00:02:44Por último, ele faz uma terceira passagem em documentos, artigos e imagens.
00:02:47Então, se sua base de código incluir coisas que não são código puro,
00:02:50seja arquivos PDF, documentações, imagens, o que for,
00:02:54isso é processado na terceira passagem.
00:02:56E é aqui que o grande modelo de linguagem realmente entra
00:02:58e faz algum tipo de análise semântica,
00:03:00ou seja, o que este documento realmente significa
00:03:03e onde ele deve se encaixar neste grafo de conhecimento maior?
00:03:06Essa terceira passagem é, de certa forma, similar sem usar embeddings reais
00:03:10ao que um sistema RAG faz.
00:03:12Uma vez feito tudo isso,
00:03:13ele então começa a criar o próprio grafo de conhecimento.
00:03:17Ele entra em um pouco mais de detalhes técnicos aqui,
00:03:19mas tudo o que você precisa entender é que ele criará nós,
00:03:23nós, que são esses pequenos círculos, certo?
00:03:26Cada um desses círculos é um nó.
00:03:28Temos então as arestas, que são a linha entre dois nós,
00:03:33duas coisas que estão conectadas, e então comunidades.
00:03:35Comunidades são simplesmente grandes grupos de nós
00:03:38que são de natureza similar.
00:03:39O que você vê aqui são 486 comunidades.
00:03:43Então, essa é a visão geral de como os dados são realmente extraídos
00:03:46e transformados em um grafo.
00:03:47E lembre-se, nos importamos em transformar em um grafo
00:03:49porque, para todos os fins,
00:03:51é um mapa para o Claude Code,
00:03:52para que ele possa responder perguntas mais rapidamente.
00:03:54Agora, você provavelmente tem algumas perguntas neste momento.
00:03:56Uma, e se não houver estrutura de código?
00:03:58E se eu estiver apontando para um repositório cheio de arquivos markdown?
00:04:01São apenas um monte de documentos
00:04:02dos quais quero criar um grafo de conhecimento
00:04:03e não quero usar RAG completo.
00:04:05Posso fazer isso?
00:04:05Sim.
00:04:06Na verdade, você pode transformá-lo em um cofre do Obsidian
00:04:08através do Graphify.
00:04:09Falaremos um pouco sobre isso no final.
00:04:11A segunda pergunta que você provavelmente tem é,
00:04:13sim, isso realmente parece super similar
00:04:15a algo como GraphRAG.
00:04:17Qual é a real diferença
00:04:18e quando devo usar um ou outro?
00:04:21Bem, a maior diferença entre o Graphify
00:04:23e um sistema GraphRAG como o LightRAG,
00:04:25ou RAGanything, ou Microsoft GraphRAG,
00:04:28são realmente os embeddings, certo?
00:04:29O Graphify não usa nenhum sistema de embedding.
00:04:33A segunda maior diferença são os casos de uso.
00:04:35Então, o Graphify é melhor e obtemos o máximo dele
00:04:37quando falamos de bases de código.
00:04:39Mas se vemos algum repositório enorme,
00:04:40seja um novo ou um em que estamos trabalhando,
00:04:42e queremos descobrir como ele está conectado,
00:04:44o Graphify é perfeito para isso.
00:04:46GraphRAG, por outro lado,
00:04:48é ótimo para algo que é mais não estruturado.
00:04:50Digamos que você tenha dezenas de milhares de documentos
00:04:52que são todos arquivos PDF ou arquivos Markdown
00:04:55e você só quer perguntar sobre eles.
00:04:57Sabe, imagine que são todos documentos de política
00:04:58e você está perguntando algo como,
00:04:59o que a política diz sobre X, certo?
00:05:01Poderia estar em qualquer lugar entre qualquer um desses documentos.
00:05:04Eles não estão necessariamente conectados.
00:05:05É muito não estruturado.
00:05:06É aí que o GraphRAG ou qualquer sistema RAG brilha.
00:05:09Dito isto, a divisão entre esses dois aqui
00:05:13é um pouco obscura
00:05:14porque, como mencionei na terceira passagem,
00:05:16podemos meio que fazer isso com o Graphify.
00:05:18É quase como um sistema RAG leve nesse sentido.
00:05:21Então, isso é o que o Graphify é,
00:05:22como funciona e por que você deve se importar.
00:05:24Agora vamos falar sobre a instalação desta ferramenta
00:05:27e usá-la de verdade.
00:05:27Mas antes de pularmos para essa demonstração,
00:05:29uma palavra rápida do patrocinador de hoje: eu mesmo.
00:05:32Não faz muito tempo,
00:05:33lancei a Masterclass de Claude Code
00:05:35e é a maneira número um de ir do zero a desenvolvedor de IA,
00:05:37independentemente da sua formação técnica.
00:05:39Este curso é atualizado semanalmente
00:05:40e também inclui masterclasses adicionais
00:05:43como a Masterclass de Codex
00:05:45e a Masterclass de Cloud OS.
00:05:48Então, se você é alguém que quer levar isso
00:05:49um pouco mais a sério,
00:05:51definitivamente confira.
00:05:52Você pode encontrá-lo dentro do Chase AI+.
00:05:53Há um link no comentário fixado.
00:05:55Instalar o Graphify é relativamente simples.
00:05:58Temos alguns pré-requisitos,
00:05:59bem como instruções de como instalá-lo.
00:06:02Se você estiver usando o Cloud Code,
00:06:03eu sugiro que facilite bastante para você mesmo.
00:06:06Basta ir ao link do GitHub do Graphify.
00:06:08Vou colocar abaixo.
00:06:09Copie, cole no Cloud Code
00:06:11e apenas diga a ele,
00:06:12ei, instale o Graphify para mim.
00:06:14Mas se quiser fazer manualmente,
00:06:15você pode apenas seguir as etapas
00:06:16como estão definidas.
00:06:18E, novamente, o Graphify é agnóstico à plataforma
00:06:20e funciona com qualquer agente de codificação por aí.
00:06:22E uma vez que você tenha o Graphify instalado,
00:06:23a próxima pergunta se torna,
00:06:24ok, como uso isso?
00:06:25Quais são os comandos?
00:06:27Bem, há muitos comandos
00:06:30e existem tantos comandos.
00:06:31Na verdade, você não vai
00:06:32lembrar de nenhum deles.
00:06:33Felizmente, quando você instala o Graphify,
00:06:35ele virá com uma habilidade Graphify.
00:06:38Essa skill ensinará ao Cloud Code
00:06:39como usar o Graphify
00:06:41e quando ele deve usar quais comandos
00:06:42dependendo da linguagem natural que você usa.
00:06:45Dito isto,
00:06:47sugiro que dê uma olhada no repositório GitHub,
00:06:49familiarize-se um pouco
00:06:50com o que é possível
00:06:51porque há muito.
00:06:52Mas entenda,
00:06:53você não precisa ter isso memorizado.
00:06:54O Cloud Code entende o que fazer.
00:06:56Mas há alguns comandos
00:06:58que devemos conhecer.
00:06:59Se eu digitar barra Graphify,
00:07:00isso vai executar tudo
00:07:02no diretório em que estou atualmente.
00:07:04Existem também comandos do Graphify
00:07:05para consultar o grafo de conhecimento.
00:07:07Então, se eu usar Graphify query
00:07:09ou Graphify explain,
00:07:10isso dirá explicitamente ao Cloud Code
00:07:12ou a qualquer agente de codificação que você esteja usando,
00:07:13ei,
00:07:14dê uma olhada no grafo de conhecimento
00:07:16ao responder a essa pergunta.
00:07:17Não seja preguiçoso
00:07:17e não tente responder sozinho.
00:07:19Além disso,
00:07:19temos comandos
00:07:20para garantir que esteja sempre ativo.
00:07:21Então, se eu fizer Graphify Cloud install,
00:07:23isso significa que ele sempre usará
00:07:25o Graphify
00:07:26para responder às perguntas.
00:07:27Não preciso ser explícito.
00:07:28Isso vira literalmente um gancho.
00:07:29E existem outras
00:07:30flags interessantes
00:07:31como a flag do obsidian,
00:07:32que vai,
00:07:33com um comando,
00:07:34criar todo um cofre do obsidian
00:07:35para você
00:07:36e preenchê-lo com
00:07:37o que o Graphify encontrar.
00:07:39Mas, novamente,
00:07:40lembre-se de que a habilidade está instalada.
00:07:41Então, se você ficar confuso
00:07:42sobre o que faz sentido,
00:07:43apenas pergunte ao Cloud Code.
00:07:44Ele entenderá.
00:07:45Então agora vamos executar isso.
00:07:47Para a demonstração,
00:07:47vamos apontar
00:07:49o Cloud Code para o OpenDesign,
00:07:51que é uma base de código relativamente grande.
00:07:53Se você nunca usou o OpenDesign,
00:07:55é essencialmente Cloud Design,
00:07:57mas de código aberto.
00:07:59Então eu o clonei na minha máquina
00:08:00e vou abrir o Cloud Code
00:08:02dentro desse diretório.
00:08:03Então estamos dentro do diretório
00:08:04e tudo o que vou fazer
00:08:05é barra Graphify
00:08:07e depois ponto.
00:08:08Ele agora vai rodar o Graphify
00:08:10nessa pasta inteira.
00:08:12Então, após rodar por seis minutos,
00:08:13isso foi o que obtivemos.
00:08:15Ele analisou 203 arquivos.
00:08:17Temos 1.907 nós,
00:08:203.447 conexões em 109 comunidades
00:08:24e o número de tokens de saída
00:08:25ficou um pouco abaixo de 120 mil.
00:08:27Ele lista os nós principais.
00:08:29Os nós principais são basicamente
00:08:30os nós mais proeminentes,
00:08:32as conexões mais proeminentes
00:08:33dentro do que ele atravessou.
00:08:36Temos conexões surpreendentes
00:08:37que eu não esperava
00:08:39e perguntas sugeridas.
00:08:42Então, se quisermos dar uma olhada
00:08:42no grafo,
00:08:43eu posso dizer,
00:08:44vá em frente e traga
00:08:47o grafo para mim.
00:08:49Então aqui está uma olhada
00:08:50no grafo de conhecimento
00:08:51que ele construiu
00:08:52e você pode meio que ver
00:08:53as comunidades ali.
00:08:54Ele criou 109 comunidades
00:08:56e isso é realmente apenas
00:08:56todos esses clusters.
00:08:58À medida que aumentamos o zoom neles,
00:09:00podemos ver os nós
00:09:01que são os pontos reais
00:09:03e então as conexões
00:09:05são as ligações entre eles.
00:09:06Quando clico no nó,
00:09:07você pode ver ali
00:09:08no canto superior direito,
00:09:10seu tipo,
00:09:11então é um nó de código,
00:09:12sua comunidade,
00:09:13sua origem,
00:09:14assim como seus vizinhos.
00:09:15Mas lembre-se,
00:09:16por mais legal que seja essa visualização
00:09:17e ela pareça bacana,
00:09:19o valor real aqui
00:09:20não é o grafo de conhecimento.
00:09:21Isso é legal de ver,
00:09:23mas o valor real
00:09:24é o fato de que
00:09:25agora entregamos
00:09:26ao Claude Code um mapa
00:09:27do repositório Open Design
00:09:29e agora posso fazer perguntas
00:09:31sobre ele
00:09:31e obter respostas precisas.
00:09:33Então, o que vamos testar agora
00:09:34é fazer uma pergunta
00:09:35sobre algo relacionado
00:09:36ao repositório
00:09:37e vamos fazer com que ele
00:09:38use o Graphify,
00:09:39então faremos com que ele use
00:09:40o grafo de conhecimento
00:09:41e depois faremos
00:09:42quase a mesma pergunta
00:09:43sem usar o Graphify,
00:09:44apenas fazendo com que ele
00:09:45pegue a resposta
00:09:46e daremos uma olhada
00:09:47em como é a diferença
00:09:48de tokens.
00:09:49Então, para ver
00:09:49a diferença de tokens
00:09:50com e sem o Graphify,
00:09:51vamos fazer a mesma pergunta
00:09:52ao Claude Code
00:09:53sobre o repositório.
00:09:54A primeira é
00:09:55rastrear como um pedido de design
00:09:56flui do aplicativo web
00:09:58para um agente de codificação
00:09:59e volta.
00:10:00Estamos tentando entender
00:10:00como esse aplicativo
00:10:01funciona de verdade
00:10:03e na primeira aba
00:10:03vamos dizer
00:10:04use o Graphify
00:10:05e na segunda aba
00:10:06com a mesma pergunta
00:10:07estamos dizendo
00:10:08não use o Graphify.
00:10:09Então podemos ver
00:10:10a habilidade do Graphify
00:10:11sendo carregada imediatamente
00:10:11e então podemos ver
00:10:13comandos como
00:10:14graphify query
00:10:15fazendo a pergunta
00:10:16que acabamos de fazer ao Claude Code.
00:10:17Por aqui,
00:10:18no lado sem Graphify,
00:10:19vemos que o Claude Code
00:10:20spawnou agentes de exploração
00:10:21para dar uma olhada
00:10:22na base de código
00:10:23e logo de cara
00:10:25já usamos
00:10:25100.000 tokens
00:10:27entre eles.
00:10:27Agora, em termos das
00:10:28respostas reais que obtivemos,
00:10:29elas foram as mesmas;
00:10:30ambos identificaram
00:10:30como esse aplicativo
00:10:31funciona de verdade,
00:10:32mas com a versão
00:10:32sem Graphify,
00:10:34precisamos executar
00:10:35aqueles agentes de exploração,
00:10:36então estávamos lidando com cerca de
00:10:37150.000 tokens,
00:10:38mais ou menos,
00:10:39com os agentes de exploração
00:10:40mais uns adicionais
00:10:40150.000 tokens
00:10:42mais ou menos
00:10:43com os agentes de exploração
00:10:44mais um adicional
00:10:45de 50.000 tokens
00:10:46na sessão principal
00:10:47então sabe
00:10:48cerca de 200.000 tokens
00:10:50cerca de 80.000,
00:10:50então cerca de
00:10:5240%
00:10:54do custo total
00:10:55da versão sem Graphify,
00:10:58então cerca de
00:10:5840%
00:11:00essa versão sem Graphify
00:11:01meio que
00:11:02rastreou
00:11:03o repositório em si,
00:11:04se eu fizer perguntas adicionais,
00:11:06o custo em tokens
00:11:07não será tão
00:11:08alto.
00:11:09No entanto,
00:11:11já que temos
00:11:12o grafo de conhecimento
00:11:13construído,
00:11:14sempre que quisermos
00:11:14fazer perguntas
00:11:16sobre ele
00:11:16via Graphify,
00:11:17sempre que quisermos
00:11:18fazer perguntas
00:11:18sobre isso
00:11:19via graphify
00:11:20bem, não vamos
00:11:21precisar
00:11:21lidar com esse
00:11:22custo de tokens
00:11:22de passar por
00:11:23isso de novo e de novo
00:11:24e isso meio que
00:11:25toca na
00:11:26questão da memória
00:11:26já que construímos
00:11:27isso por completo
00:11:28podemos sempre
00:11:28consultá-lo de forma barata
00:11:29agora, a pergunta
00:11:30então passa a ser
00:11:31se este é um
00:11:31repositório vivo
00:11:32o que acontece
00:11:33quando fazemos
00:11:34atualizações no repositório
00:11:35este grafo de conhecimento
00:11:35também será atualizado?
00:11:36bem, a resposta
00:11:37é sim
00:11:38vemos isso detalhado
00:11:39no fluxo de trabalho
00:11:40no readme
00:11:40se executarmos
00:11:41graphify hook install
00:11:42ele irá
00:11:43reconstruir automaticamente
00:11:44após cada commit
00:11:45e isso é apenas
00:11:45o AST
00:11:46não há custo
00:11:47de API associado
00:11:48a isso
00:11:48é literalmente
00:11:49apenas olhar para
00:11:50o que realmente
00:11:51mudou
00:11:51o que é agora
00:11:52conectado a
00:11:53e ele reconstrói
00:11:53essa árvore
00:11:54mas sem qualquer
00:11:54custo para você
00:11:55como isso é
00:11:56feito
00:11:56de uma maneira
00:11:57determinística
00:11:58além disso
00:11:59isso também funciona
00:12:00em uma equipe
00:12:00de trabalho
00:12:01então, se você tivesse
00:12:01dois desenvolvedores
00:12:02trabalhando no
00:12:02mesmo repositório
00:12:03em paralelo
00:12:04ele também lida
00:12:04com essa situação
00:12:05então, no final
00:12:06você obtém esse
00:12:07mapa persistente
00:12:08e vivo
00:12:09de qualquer repositório
00:12:09que você queira
00:12:10e que você pode dar
00:12:10ao Claude Code
00:12:11para que possa obter
00:12:12respostas mais
00:12:13eficientes
00:12:14e, por último
00:12:14nós demos uma dica disso
00:12:15um pouco aqui
00:12:16com a flag do obsidian
00:12:17podemos fazer tudo isso
00:12:18com um repositório
00:12:19que não é baseado em código
00:12:19é um pouco
00:12:20diferente e nós vamos
00:12:21fazer isso
00:12:22em outro vídeo
00:12:23onde vamos nos aprofundar
00:12:23no graphify e no obsidian
00:12:25e meio que como
00:12:26essa conexão funciona
00:12:27mas entenda apenas
00:12:28que não estamos limitados
00:12:29apenas ao código
00:12:30essa é uma ferramenta
00:12:31bastante flexível
00:12:32mas é aqui que
00:12:33vou deixar
00:12:33vocês hoje
00:12:34acho que esta é uma
00:12:35ferramenta muito legal
00:12:36e quando você olha
00:12:37para o espectro
00:12:37dessas aplicações
00:12:39e plugins adjacentes à memória
00:12:40que podemos usar
00:12:42ao lado de coisas
00:12:43como o Claude Code
00:12:43e o Codex
00:12:44acho que o Graphify
00:12:44acaba ficando
00:12:45em algum lugar
00:12:46entre o obsidian
00:12:47e um verdadeiro sistema RAG
00:12:48e acho que isso é ótimo
00:12:49quanto mais opções tivermos
00:12:50mais ferramentas à nossa disposição
00:12:52melhor podemos escolher
00:12:53a certa para o trabalho
00:12:53não precisamos usar
00:12:54apenas o obsidian
00:12:55sabe, talvez não estejamos
00:12:56apenas fazendo algo
00:12:57em markdown
00:12:58e não precisamos enlouquecer
00:12:59e gerar
00:12:59alguma infraestrutura RAG enorme
00:13:00isso é, novamente
00:13:02um pequeno meio termo
00:13:03muito legal
00:13:04que eu acho
00:13:04que vale a pena explorar
00:13:05então, como sempre
00:13:05deixe-me saber
00:13:06o que você achou
00:13:06certifique-se de conferir
00:13:08o Chase AI Plus
00:13:08se você quiser colocar
00:13:09as mãos na
00:13:10masterclass de Claude Code
00:13:11falando em obsidian
00:13:11eu realmente vou
00:13:12realizar um webinar
00:13:13gratuito ao vivo na próxima semana
00:13:14sobre obsidian
00:13:15e Claude Code
00:13:16vou colocar um link para isso
00:13:17aqui embaixo também
00:13:18e, fora isso
00:13:19nos vemos por aí
00:13:19ou melhor
00:13:21até mais
00:13:22vejo vocês em breve
Community Posts
No posts yet. Be the first to write about this video!
Write about this video