Pular para o conteúdo principal

​
Visão Geral

Agentes CrewAI podem ser estendidos com cinco tipos distintos de capacidades, cada um servindo a um propósito diferente. Entender quando usar cada um — e como eles funcionam juntos — é fundamental para construir agentes eficazes.

Ferramentas

Funções chamáveis — permitem que agentes tomem ações. Buscas na web, operações com arquivos, chamadas de API, execução de código.

Servidores MCP

Servidores de ferramentas remotos — conectam agentes a servidores de ferramentas externos via Model Context Protocol. Mesmo efeito de ferramentas, mas hospedados externamente.

Apps

Integrações com plataformas — conectam agentes a aplicativos SaaS (Gmail, Slack, Jira, Salesforce) via plataforma CrewAI. Executa localmente com um token de integração.

Skills

Expertise de domínio — injetam instruções, diretrizes e material de referência nos prompts dos agentes. Skills dizem aos agentes como pensar.

Knowledge

Fatos recuperados — fornecem aos agentes dados de documentos, arquivos e URLs via busca semântica (RAG). Knowledge dá aos agentes o que saber.

​
A Distinção Fundamental

O mais importante a entender: essas capacidades se dividem em duas categorias.

​
Capacidades de Ação (Ferramentas, MCPs, Apps)

Estas dão aos agentes a capacidade de fazer coisas — chamar APIs, ler arquivos, buscar na web, enviar emails. No momento da execução, os três tipos se resolvem no mesmo formato interno (instâncias de BaseTool) e aparecem em uma lista unificada de ferramentas que o agente pode chamar. 
from crewai import Agent
from crewai_tools import SerperDevTool, FileReadTool

agent = Agent(
    role="Researcher",
    goal="Find and compile market data",
    backstory="Expert market analyst",
    tools=[SerperDevTool(), FileReadTool()],  # Ferramentas locais
    mcps=["https://mcp.example.com/sse"],     # Ferramentas de servidor MCP remoto
    apps=["gmail", "google_sheets"],           # Integrações com plataformas
)

​
Capacidades de Contexto (Skills, Knowledge)

Estas modificam o prompt do agente — injetando expertise, instruções ou dados recuperados antes do agente começar a raciocinar. Não dão aos agentes novas ações; elas moldam como os agentes pensam e a quais informações têm acesso. 
from crewai import Agent

agent = Agent(
    role="Security Auditor",
    goal="Audit cloud infrastructure for vulnerabilities",
    backstory="Expert in cloud security with 10 years of experience",
    skills=["./skills/security-audit"],        # Instruções de domínio
    knowledge_sources=[pdf_source, url_source], # Fatos recuperados
)

​
Quando Usar o Quê

Você precisa…UseExemplo
Agente buscar na webFerramentastools=[SerperDevTool()]
Agente chamar uma API remota via MCPMCPsmcps=["https://api.example.com/sse"]
Agente enviar emails pelo GmailAppsapps=["gmail"]
Agente seguir procedimentos específicosSkillsskills=["./skills/code-review"]
Agente consultar documentos da empresaKnowledgeknowledge_sources=[pdf_source]
Agente buscar na web E seguir diretrizes de revisãoFerramentas + SkillsUse ambos juntos

​
Combinando Capacidades

Na prática, agentes frequentemente usam múltiplos tipos de capacidades juntos. Aqui está um exemplo realista: 
from crewai import Agent
from crewai_tools import SerperDevTool, FileReadTool, CodeInterpreterTool

# Um agente de pesquisa totalmente equipado
researcher = Agent(
    role="Senior Research Analyst",
    goal="Produce comprehensive market analysis reports",
    backstory="Expert analyst with deep industry knowledge",

    # AÇÃO: O que o agente pode FAZER
    tools=[
        SerperDevTool(),         # Buscar na web
        FileReadTool(),          # Ler arquivos locais
        CodeInterpreterTool(),   # Executar código Python para análise
    ],
    mcps=["https://data-api.example.com/sse"],  # Acessar API de dados remota
    apps=["google_sheets"],                      # Escrever no Google Sheets

    # CONTEXTO: O que o agente SABE
    skills=["./skills/research-methodology"],    # Como conduzir pesquisas
    knowledge_sources=[company_docs],            # Dados específicos da empresa
)

​
Tabela Comparativa

CaracterísticaFerramentasMCPsAppsSkillsKnowledge
Dá ações ao agente✅✅✅❌❌
Modifica o prompt❌❌❌✅✅
Requer códigoSimApenas configApenas configApenas MarkdownApenas config
Executa localmenteSimDependeSim (com variável de ambiente)N/ASim
Precisa de chaves APIPor ferramentaPor servidorToken de integraçãoNãoApenas embedder
Definido no Agenttools=[]mcps=[]apps=[]skills=[]knowledge_sources=[]
Definido no Crew❌❌❌skills=[]knowledge_sources=[]

​
Aprofundamentos

Pronto para aprender mais sobre cada tipo de capacidade?

Ferramentas

Crie ferramentas personalizadas, use o catálogo OSS com 75+ opções, configure cache e execução assíncrona.

Integração MCP

Conecte-se a servidores MCP via stdio, SSE ou HTTP. Filtre ferramentas, configure autenticação.

Skills

Construa pacotes de skills com SKILL.md, injete expertise de domínio, use divulgação progressiva.

Knowledge

Adicione conhecimento de PDFs, CSVs, URLs e mais. Configure embedders e recuperação.