Agno: O guia definitivo para criar agentes de IA

7 minutos de leitura 13 de Novembro de 2025

Caio Sampaio

Por que o Agno me impressionou

Quando conheci o Agno, percebi de cara sua preocupação em unir performance e facilidade de uso. O framework já traz inúmeras bibliotecas pré-compiladas, o que acelera o desenvolvimento e reduz dores de cabeça com dependências e compatibilidade. Outro fator decisivo para mim foi a maneira como o Agno orquestra diferentes agentes, permitindo que cada um atue em um papel específico. Essa estrutura facilita desde criações simples até arquiteturas mais complexas, como integrações com Telegram, Google Agenda ou até buscas acadêmicas avançadas.

Agno cria pontes entre agentes de IA e ferramentas digitais, tornando tarefas antes complexas muito mais simples.

Código Python em tela mostrando pipeline de criação de agente de IA Começando: instalação e ambiente

O início do trabalho com Agno passa por uma preparação simples do ambiente. Pude utilizar tanto UV quanto o pip para instalar. Essa flexibilidade é útil, pois cada desenvolvedor tem sua preferência de gerenciador de pacotes.

  • Se preferir UV, basta rodar uv pip install agno
  • Com pip convencional: pip install agno

Criando seu primeiro agente

Com o Agno instalado, a primeira tarefa foi montar o arquivo main.py. Costumo centralizar nele minhas configurações e primeira estrutura de agentes. Esse arquivo serve de ponto de partida para o agente principal, onde você define desde parâmetros básicos até instruções mais sofisticadas.

from agno.agent import Agent

agent = Agent(
    id="Agente de pesquisa",
    name="Pesquisador DDG",
    role="Responda perguntas baseado em contextos buscados na internet",
    instructions=[
        "Busque as principais fontes confiáveis sobre o tema.",
        "Entregue uma saída concisa com: 5-10 fatos em bullets e um quadro de fontes com título + URL.",
        "Não invente links. Priorize sites oficiais, artigos e referências robustas.",
        "Use a ValyuTools para busca em artigos e o DuckDuckGoTools para buscas na internet."
    ],
    model=OpenAIChat(id="gpt-4o-mini"),
)

Adicione no arquivo .env sua chave de API da OpenAI

OPENAI_API_KEY='sua-chave-aqui'


Executando o agente

Você pode rodar o seu agente tanto via código Python:

print(agent.print_response('Quais os principais artigos sobre redes neurais'))

Ou usar o AgentOS, primeiro adicione no seu código:

agent_os = AgentOS(agents=[agent])
app = agent_os.get_app()

E para iniciar o servidor execute:

uv run fastapi dev main.py

Acesse agora https://os.agno.com/ e faça o cadastro do seu agente

E pronto, agora você terá um interface pronta para usar e testar seu agente.

Adicionando ferramentas inteligentes

Para tornar nosso agente ainda mais poderoso podemos utilizar as Tools, que permite a IA conectar a ferramentas externas.

Vamos o DuckDuckGo, uma ferramenta para o seu modelo realizar pesquisas na internet antes de gerar uma resposta.

Faça a importação:

from agno.tools.duckduckgo import DuckDuckGoTools

E adicione o parâmetro em seu agente:

tools=[DuckDuckGoTools(),],

Conclusão

O Agno mostrou que criar agentes de IA personalizados e potentes não precisa ser complicado. Com uma linha de aprendizado clara e uma infinidade de aplicações possíveis, abre portas tanto para novatos quanto para quem já domina a área. Aproveite a estrutura do framework para criar soluções únicas, e não hesite em buscar suporte e aprofundamento na Pythonando, onde conhecimento prático faz a diferença.

Perguntas frequentes sobre Agno e agentes de IA

O que é o Agno para IA?

Agno é um framework Python desenhado para facilitar a criação de agentes de inteligência artificial, permitindo integração com diversas ferramentas digitais, automação de fluxos complexos e personalização total das funcionalidades do agente.

Quais são os benefícios do Agno?

O Agno oferece rapidez de desenvolvimento com bibliotecas pré-compiladas, integração direta com múltiplas ferramentas (WhatsApp, Google Agenda, Telegram), estrutura modular para múltiplos agentes e fácil adaptação para aplicações web com FastAPI.

É fácil usar o Agno para iniciantes?

Sim, o Agno tem curva de aprendizado amigável para quem já conhece Python básico, principalmente se seguir trilhas práticas, como as oferecidas pela Pythonando. Os recursos de documentação e suporte comunitário também facilitam o início para novos programadores.

Quanto custa usar o Agno?

O Agno em si pode ser usado gratuitamente, dependendo da licença, mas algumas ferramentas integradas, como a OpenAI, exigem criação de contas e, eventualmente, aquisição de créditos para uso contínuo de APIs externas.


card-image
Formação

Combo: Python Full + Python Full AI

Garanta agora nossas duas formações completas em Desenvolvimento Web com Python e Django + a nova Formação em Inteligência Artificial com Python!