pydantic/pydantic-ai

O que é?

Recursos principais

• 01Alterne entre vários provedores de modelos usando uma string de modelo.
• 02Saídas estruturadas e validadas, além de ferramentas de função tipadas com injeção de dependências.
• 03Execute o mesmo agente como CLI, chat web, sessão de voz em tempo real ou fluxo de eventos de UI.
• 04Execução durável em mecanismos como Temporal, DBOS e Prefect.
• 05Instrumentação baseada em OpenTelemetry para rastrear chamadas de modelos e ferramentas.
• 06Geração de imagens e embeddings no mesmo pacote.

Casos de uso

• Criar um pipeline tipado de extração de dados que retorna modelos Pydantic validados a partir de saídas de LLM.
• Criar um agente de pesquisa de longa duração que precisa sobreviver a reinicializações usando Temporal ou DBOS.
• Adicionar um assistente de voz que chama ferramentas internas durante uma conversa ao vivo.
• Avaliar respostas de agentes e o comportamento das chamadas de ferramentas com base em um conjunto de dados de teste.

Início rápido

1. 1

   Instale o pacote com uv

   uv add pydantic-ai
2. 2

   Crie um arquivo Python com um Agent e chame agent.run_sync(...) para obter um resultado tipado

Antes de usar

• !Para executar os exemplos com modelos hospedados, é necessária a chave de API do provedor correspondente, algo que o README não explica em detalhes.
• !A execução durável, a voz em tempo real e outros recursos avançados exigem instalações adicionais e um backend separado, como o Temporal.

Tópicos

Perguntas frequentes

O que é pydantic-ai?

SDK de IA para Python para criar agentes tipados que funcionam com vários modelos, interfaces web, CLI, voz e fluxos de trabalho duráveis em segundo plano. Pydantic AI é um SDK de Python para criar agentes de IA com entradas, saídas e dependências tipadas. É possível alternar entre modelos de provedores como OpenAI, Anthropic, Google e Groq mudando uma string, e disponibilizar o mesmo agente por meio de uma CLI, um chat web integrado, sessões de voz em tempo real ou fluxos de eventos de UI para integração com o frontend.

pydantic-ai é gratuito? Qual é a licença?

pydantic-ai é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

pydantic-ai ainda é mantido?

Manutenção ativa. O último commit de pydantic-ai foi em 20 de out. de 2026.

Para que posso usar pydantic-ai?

Criar um pipeline tipado de extração de dados que retorna modelos Pydantic validados a partir de saídas de LLM. Criar um agente de pesquisa de longa duração que precisa sobreviver a reinicializações usando Temporal ou DBOS. Adicionar um assistente de voz que chama ferramentas internas durante uma conversa ao vivo. Avaliar respostas de agentes e o comportamento das chamadas de ferramentas com base em um conjunto de dados de teste.

Como instalar pydantic-ai?

Instale o pacote com uv: uv add pydantic-ai Crie um arquivo Python com um Agent e chame agent.run_sync(...) para obter um resultado tipado

Onde consigo pydantic-ai?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pydantic/pydantic-ai