Gráficos PydanticAI Transformam Fluxos de Trabalho de Agentes de IA
8 de Maio de 2025
RyanTaylor
0
PydanticAI recentemente lançou um recurso inovador chamado PydanticAI Graphs, que promete transformar a maneira como os agentes de IA gerenciam e executam fluxos de trabalho. Esta nova ferramenta oferece aos desenvolvedores uma forma de modelar, controlar e visualizar interações complexas de IA com um nível de clareza e eficiência sem precedentes. Neste artigo, vamos mergulhar no mundo dos PydanticAI Graphs, uma biblioteca de grafos e máquinas de estado assíncronas, explorando suas principais características, benefícios e seu potencial para revolucionar o desenvolvimento de IA.
Principais pontos
- PydanticAI introduz suporte a grafos para modelar fluxos de trabalho de agentes de IA.
- Esses grafos funcionam como máquinas de estado assíncronas, definidas usando dicas de tipo.
- A biblioteca é destinada a desenvolvedores intermediários e avançados, fornecendo opções de controle sofisticadas.
- Os componentes principais incluem GraphRunContext, End, Nodes e Graph.
- Foi projetado para melhorar os processos de tomada de decisão em aplicações de IA.
- Esses componentes principais servem como os blocos de construção fundamentais dos PydanticAI Graphs.
Entendendo os PydanticAI Graphs
O que são PydanticAI Graphs?
PydanticAI Graphs é uma biblioteca de grafos e máquinas de estado assíncronas construída especificamente para Python, permitindo que os desenvolvedores definam nós e arestas com dicas de tipo. Esta abordagem estruturada permite o design de interações complexas de agentes de IA.

Esta biblioteca capacita os desenvolvedores a modelar, executar, controlar e visualizar fluxos de trabalho complexos com uma clareza notável. Usando os PydanticAI Graphs, você pode criar aplicações de IA mais robustas, compreensíveis e mantíveis, estabelecendo um novo padrão no design de agentes de IA. A combinação de grafos e máquinas de estado finitas oferece uma abstração poderosa para gerenciar fluxos de trabalho complexos.
Público-alvo
Os PydanticAI Graphs são direcionados a desenvolvedores intermediários e avançados, em vez de iniciantes. Esta ferramenta requer um entendimento sólido de Python e estruturas de dados de grafos.

Dada sua natureza avançada, a biblioteca utiliza genéricos de Python e dicas de tipo para agilizar o processo de desenvolvimento. Para desenvolvedores experientes com estruturas de dados de grafos, os PydanticAI Graphs oferecem um poder e uma flexibilidade incomparáveis.
Instalação
Começar com os PydanticAI Graphs é simples. Você pode instalá-lo usando pip:
pip install pydantic-graph

É recomendado também ter o PydanticAI instalado, embora seja uma dependência opcional.
Componentes principais dos PydanticAI Graphs
Os PydanticAI Graphs são construídos em torno de quatro componentes principais cruciais para entender e utilizar a biblioteca de forma eficaz:
GraphRunContext: Similar ao RunContext no PydanticAI, este componente gerencia o estado do grafo e suas dependências. É como o bastão em uma corrida de revezamento, passando informações vitais entre os nós para garantir uma execução suave.

End: Isso significa o fim da execução do grafo, marcando quando um nó retornou seu valor final. É a linha de chegada da corrida, sinalizando a conclusão do fluxo de trabalho, o que é especialmente útil no gerenciamento de fluxos de trabalho complexos com muitas ações.
Nodes: São as unidades principais do grafo, executando a lógica do processo através do método run.
Graph: Atua como o motor de execução, composto por nós. É o projeto mestre que orquestra todo o fluxo de trabalho, semelhante a um pipeline que aciona tarefas.
Tópicos avançados em PydanticAI Graphs
Estruturas de dados de grafos e sua importância
Na ciência da computação, grafos são tipos de dados abstratos que representam conexões entre entidades. Eles consistem em vértices (ou nós) e arestas, que podem ser direcionadas ou não direcionadas.

Os grafos têm inúmeras aplicações, desde modelar redes de transporte e utilidades até redes sociais e estruturas moleculares. São essenciais para representar relacionamentos e sistemas complexos.
Máquinas de estado explicadas
Uma máquina de estado é um modelo computacional que pode estar em um de um número finito de estados a qualquer momento. Ela muda de estado em resposta a entradas, com essas mudanças conhecidas como transições.

As máquinas de estado são cruciais para modelar sistemas complexos, projetar controladores de robôs, analisar linguagens de computador e desenvolver jogos de vídeo. Podem ser visualizadas como grafos direcionados, onde os nós representam estados e as arestas representam transições.
Como usar o PydanticAI Graph
Codificando um grafo simples
Vamos configurar um grafo simples com três nós:
- Nó A como o nó inicial.
- Nó B como o nó de tomada de decisão.
- Nó C como o fim do processo.
Cada nó compartilha um tipo de classe base, o que é crucial. Primeiro, importe os componentes necessários:

from dataclasses import dataclass
from pydantic_graph import GraphRunContext, BaseNode, Graph, End
@dataclass
class NodeA(BaseNode[int]):
track_number: int
@dataclass
class NodeB(BaseNode[int]):
track_number: int
@dataclass
class NodeC(BaseNode[int]):
track_number: int
Codificando métodos de execução assíncrona
Agora, vamos codificar os métodos de execução assíncrona para esses nós:
@dataclass
class NodeA(BaseNode[int]):
track_number: int
async def run(self, ctx: GraphRunContext) -> BaseNode:
print(f'Chamando Nó A')
return NodeB(self.track_number)
@dataclass
class NodeB(BaseNode[int]):
track_number: int
async def run(self, ctx: GraphRunContext) -> BaseNode | End:
print(f'Chamando Nó B')
if self.track_number == 1:
return End(f'Parar no Nó B com valor --> {self.track_number}')
else:
return NodeC(self.track_number)
@dataclass
class NodeC(BaseNode[int]):
track_number: int
async def run(self, ctx: GraphRunContext) -> End:
print(f'Chamando Nó C')
return End(f'Valor a ser retornado no Nó C: {self.track_number}')
O Nó A passa o controle para o Nó B, que então decide se deve parar a execução ou prosseguir para o Nó C.
Execução
Finalmente, inicialize o grafo e execute-o:
graph = Graph(nodes=[NodeA, NodeB, NodeC])
result, history = graph.run_sync(start_node=NodeA(track_number=1))
print('*' * 40)
print('Histórico:')
for history_part in history:
print(history_part)
print('*' * 40)
print(f'Resultado: {result}')
Este código chamará o Nó A e depois parará a execução no Nó B com um valor de trilha de 1.
Vantagens e desvantagens de usar PydanticAI Graphs
Prós
- Modelagem e visualização de fluxos de trabalho aprimoradas.
- Operação assíncrona para alto desempenho.
- Dicas de tipo para código robusto.
- Uso independente possível.
Contras
- Curva de aprendizado acentuada para iniciantes.
- Status de versão beta inicial pode incluir bugs e documentação incompleta.
FAQ
O que é PydanticAI?
PydanticAI é um framework de IA projetado para agilizar o desenvolvimento, a implantação e o gerenciamento de aplicações de IA. Ele integra programação assíncrona, validação de dados e gerenciamento de fluxos de trabalho em um sistema coeso.
Qual é o principal benefício de usar PydanticAI Graphs?
PydanticAI Graphs permitem que os desenvolvedores criem fluxos de trabalho complexos de agentes de IA com maior clareza e controle. A estrutura de grafo permite uma modelagem e visualização mais fáceis desses fluxos de trabalho, melhorando a manutenibilidade e o desempenho.
Os PydanticAI Graphs dependem de outros componentes do PydanticAI?
Embora desenvolvido como parte do PydanticAI, os PydanticAI Graphs não têm dependências em outros componentes e podem ser usados de forma independente para aplicações de máquinas de estado baseadas em grafos. Esta flexibilidade o torna adequado para uma ampla gama de projetos.
Perguntas relacionadas
Quais são as alternativas ao PydanticAI?
Alternativas para construir agentes de IA e fluxos de trabalho incluem:
- Langchain: Um framework para criar aplicações usando Modelos de Linguagem de Grande Escala (LLMs).
- AutoGen: Desenvolvido pela Microsoft, ajuda os desenvolvedores a construir IA conversacional orquestrando múltiplos agentes que podem conversar para resolver tarefas.
- Haystack: Um framework de código aberto da deepset que permite aos desenvolvedores construir aplicações de busca inteligente sobre grandes coleções de documentos.
Artigo relacionado
Trump e Zelensky Clash: um mergulho profundo nas relações EUA-Ucrânia
A relação entre os Estados Unidos e a Ucrânia chamou a atenção global, principalmente durante tempos de tensão geopolítica e alianças em mudança. Este artigo explora as nuances desse relacionamento, com um foco especial nas interações entre o ex -presidente dos EUA, Donald Trump
Pop pop ai: transformando efeitos sonoros em jogos indie
No mundo do desenvolvimento de jogos indie, encontrar efeitos sonoros de alta qualidade em um orçamento apertado pode parecer perseguir uma miragem. É aí que entra o Pop Pop Ai-um divisor de jogos para desenvolvedores independentes que procuram enriquecer seus jogos com áudio personalizado sem gastar muito. Esta plataforma movida a IA oferece um free
IA Generativa Aumenta a Carga de Trabalho em Vez de Economizar Tempo
A Espada de Dois Gumes da Inteligência Artificial GenerativaFerramentas de inteligência artificial generativa (IA) são frequentemente elogiadas como economizadoras de tempo e impul
Comentários (0)
0/200






PydanticAI recentemente lançou um recurso inovador chamado PydanticAI Graphs, que promete transformar a maneira como os agentes de IA gerenciam e executam fluxos de trabalho. Esta nova ferramenta oferece aos desenvolvedores uma forma de modelar, controlar e visualizar interações complexas de IA com um nível de clareza e eficiência sem precedentes. Neste artigo, vamos mergulhar no mundo dos PydanticAI Graphs, uma biblioteca de grafos e máquinas de estado assíncronas, explorando suas principais características, benefícios e seu potencial para revolucionar o desenvolvimento de IA.
Principais pontos
- PydanticAI introduz suporte a grafos para modelar fluxos de trabalho de agentes de IA.
- Esses grafos funcionam como máquinas de estado assíncronas, definidas usando dicas de tipo.
- A biblioteca é destinada a desenvolvedores intermediários e avançados, fornecendo opções de controle sofisticadas.
- Os componentes principais incluem GraphRunContext, End, Nodes e Graph.
- Foi projetado para melhorar os processos de tomada de decisão em aplicações de IA.
- Esses componentes principais servem como os blocos de construção fundamentais dos PydanticAI Graphs.
Entendendo os PydanticAI Graphs
O que são PydanticAI Graphs?
PydanticAI Graphs é uma biblioteca de grafos e máquinas de estado assíncronas construída especificamente para Python, permitindo que os desenvolvedores definam nós e arestas com dicas de tipo. Esta abordagem estruturada permite o design de interações complexas de agentes de IA.
Esta biblioteca capacita os desenvolvedores a modelar, executar, controlar e visualizar fluxos de trabalho complexos com uma clareza notável. Usando os PydanticAI Graphs, você pode criar aplicações de IA mais robustas, compreensíveis e mantíveis, estabelecendo um novo padrão no design de agentes de IA. A combinação de grafos e máquinas de estado finitas oferece uma abstração poderosa para gerenciar fluxos de trabalho complexos.
Público-alvo
Os PydanticAI Graphs são direcionados a desenvolvedores intermediários e avançados, em vez de iniciantes. Esta ferramenta requer um entendimento sólido de Python e estruturas de dados de grafos.
Dada sua natureza avançada, a biblioteca utiliza genéricos de Python e dicas de tipo para agilizar o processo de desenvolvimento. Para desenvolvedores experientes com estruturas de dados de grafos, os PydanticAI Graphs oferecem um poder e uma flexibilidade incomparáveis.
Instalação
Começar com os PydanticAI Graphs é simples. Você pode instalá-lo usando pip:
pip install pydantic-graph
É recomendado também ter o PydanticAI instalado, embora seja uma dependência opcional.
Componentes principais dos PydanticAI Graphs
Os PydanticAI Graphs são construídos em torno de quatro componentes principais cruciais para entender e utilizar a biblioteca de forma eficaz:
GraphRunContext: Similar ao RunContext no PydanticAI, este componente gerencia o estado do grafo e suas dependências. É como o bastão em uma corrida de revezamento, passando informações vitais entre os nós para garantir uma execução suave.
End: Isso significa o fim da execução do grafo, marcando quando um nó retornou seu valor final. É a linha de chegada da corrida, sinalizando a conclusão do fluxo de trabalho, o que é especialmente útil no gerenciamento de fluxos de trabalho complexos com muitas ações.
Nodes: São as unidades principais do grafo, executando a lógica do processo através do método run.
Graph: Atua como o motor de execução, composto por nós. É o projeto mestre que orquestra todo o fluxo de trabalho, semelhante a um pipeline que aciona tarefas.
Tópicos avançados em PydanticAI Graphs
Estruturas de dados de grafos e sua importância
Na ciência da computação, grafos são tipos de dados abstratos que representam conexões entre entidades. Eles consistem em vértices (ou nós) e arestas, que podem ser direcionadas ou não direcionadas.
Os grafos têm inúmeras aplicações, desde modelar redes de transporte e utilidades até redes sociais e estruturas moleculares. São essenciais para representar relacionamentos e sistemas complexos.
Máquinas de estado explicadas
Uma máquina de estado é um modelo computacional que pode estar em um de um número finito de estados a qualquer momento. Ela muda de estado em resposta a entradas, com essas mudanças conhecidas como transições.
As máquinas de estado são cruciais para modelar sistemas complexos, projetar controladores de robôs, analisar linguagens de computador e desenvolver jogos de vídeo. Podem ser visualizadas como grafos direcionados, onde os nós representam estados e as arestas representam transições.
Como usar o PydanticAI Graph
Codificando um grafo simples
Vamos configurar um grafo simples com três nós:
- Nó A como o nó inicial.
- Nó B como o nó de tomada de decisão.
- Nó C como o fim do processo.
Cada nó compartilha um tipo de classe base, o que é crucial. Primeiro, importe os componentes necessários:
from dataclasses import dataclass
from pydantic_graph import GraphRunContext, BaseNode, Graph, End
@dataclass
class NodeA(BaseNode[int]):
track_number: int
@dataclass
class NodeB(BaseNode[int]):
track_number: int
@dataclass
class NodeC(BaseNode[int]):
track_number: int
Codificando métodos de execução assíncrona
Agora, vamos codificar os métodos de execução assíncrona para esses nós:
@dataclass
class NodeA(BaseNode[int]):
track_number: int
async def run(self, ctx: GraphRunContext) -> BaseNode:
print(f'Chamando Nó A')
return NodeB(self.track_number)
@dataclass
class NodeB(BaseNode[int]):
track_number: int
async def run(self, ctx: GraphRunContext) -> BaseNode | End:
print(f'Chamando Nó B')
if self.track_number == 1:
return End(f'Parar no Nó B com valor --> {self.track_number}')
else:
return NodeC(self.track_number)
@dataclass
class NodeC(BaseNode[int]):
track_number: int
async def run(self, ctx: GraphRunContext) -> End:
print(f'Chamando Nó C')
return End(f'Valor a ser retornado no Nó C: {self.track_number}')
O Nó A passa o controle para o Nó B, que então decide se deve parar a execução ou prosseguir para o Nó C.
Execução
Finalmente, inicialize o grafo e execute-o:
graph = Graph(nodes=[NodeA, NodeB, NodeC])
result, history = graph.run_sync(start_node=NodeA(track_number=1))
print('*' * 40)
print('Histórico:')
for history_part in history:
print(history_part)
print('*' * 40)
print(f'Resultado: {result}')
Este código chamará o Nó A e depois parará a execução no Nó B com um valor de trilha de 1.
Vantagens e desvantagens de usar PydanticAI Graphs
Prós
- Modelagem e visualização de fluxos de trabalho aprimoradas.
- Operação assíncrona para alto desempenho.
- Dicas de tipo para código robusto.
- Uso independente possível.
Contras
- Curva de aprendizado acentuada para iniciantes.
- Status de versão beta inicial pode incluir bugs e documentação incompleta.
FAQ
O que é PydanticAI?
PydanticAI é um framework de IA projetado para agilizar o desenvolvimento, a implantação e o gerenciamento de aplicações de IA. Ele integra programação assíncrona, validação de dados e gerenciamento de fluxos de trabalho em um sistema coeso.
Qual é o principal benefício de usar PydanticAI Graphs?
PydanticAI Graphs permitem que os desenvolvedores criem fluxos de trabalho complexos de agentes de IA com maior clareza e controle. A estrutura de grafo permite uma modelagem e visualização mais fáceis desses fluxos de trabalho, melhorando a manutenibilidade e o desempenho.
Os PydanticAI Graphs dependem de outros componentes do PydanticAI?
Embora desenvolvido como parte do PydanticAI, os PydanticAI Graphs não têm dependências em outros componentes e podem ser usados de forma independente para aplicações de máquinas de estado baseadas em grafos. Esta flexibilidade o torna adequado para uma ampla gama de projetos.
Perguntas relacionadas
Quais são as alternativas ao PydanticAI?
Alternativas para construir agentes de IA e fluxos de trabalho incluem:
- Langchain: Um framework para criar aplicações usando Modelos de Linguagem de Grande Escala (LLMs).
- AutoGen: Desenvolvido pela Microsoft, ajuda os desenvolvedores a construir IA conversacional orquestrando múltiplos agentes que podem conversar para resolver tarefas.
- Haystack: Um framework de código aberto da deepset que permite aos desenvolvedores construir aplicações de busca inteligente sobre grandes coleções de documentos.












