Declarar parâmetros com dicas de tipo
Use dicas de tipo do Python para definir o esquema da ferramenta.
Declarar parâmetros com dicas de tipo é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Parâmetros Tornam-se um Esquema
Cada argumento da função da sua ferramenta torna-se parte de um esquema de entrada que o modelo deve seguir ao chamá-la. 🧩
As Anotações de Tipo Fazem o Trabalho
O FastMCP lê as anotações de tipo do seu código Python e cria o esquema JSON para você. Assim, raramente é necessário escrever o esquema manualmente.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
Os tipos básicos são mapeados diretamente: str torna-se string, int e float tornam-se number, e bool torna-se boolean no esquema.
Sem Tipo, Fica Incerto
Se você deixar de usar a anotação de tipo, o modelo verá apenas um valor genérico, sem regras, o que favorece entradas erradas ou inválidas.
def add(a, b):
return a + bObrigatório por Padrão
Um parâmetro sem valor padrão é tratado como obrigatório, portanto o modelo sempre deverá fornecê-lo ao chamar a ferramenta.
Valores Padrão Tornam-no Opcional
Forneça um valor padrão a um parâmetro para torná-lo opcional. O modelo pode omiti-lo, e sua função usará o valor de fallback.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Listas e Dicionários
Você também pode indicar coleções. Um argumento list é mapeado para uma matriz JSON, e um dicionário é mapeado para um objeto que o modelo pode preencher.
def tag(items: list[str]) -> int:
return len(items)Valores Opcionais
Use Optional quando um argumento puder ser um valor ou None, sinalizando que o modelo pode deixá-lo vazio intencionalmente.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Dê Nomes Claros aos Parâmetros
O modelo vê o nome de cada parâmetro no esquema. Portanto, city é melhor que c, e start_date é melhor que arg2. Nomes claros orientam chamadas melhores.
As Anotações Permitem a Validação
Como as anotações definem o esquema, o MCP pode rejeitar chamadas com o tipo errado antes que seu código seja executado, detectando erros antecipadamente.
Mantenha a Assinatura Pequena
Poucos parâmetros bem tipados são mais fáceis de o modelo preencher corretamente do que uma longa lista de argumentos pouco relacionados.
Verificação Rápida
O que torna um parâmetro de ferramenta opcional no FastMCP?
Recapitulação
Suas anotações de tipo criam o esquema da ferramenta: os tipos básicos são mapeados diretamente, os valores padrão indicam que algo é opcional e nomes claros orientam o modelo. ✅
Perguntas Frequentes
A aula “Declarar parâmetros com dicas de tipo” é grátis?
Sim — o texto completo de “Declarar parâmetros com dicas de tipo” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Declarar parâmetros com dicas de tipo”?
Use dicas de tipo do Python para definir o esquema da ferramenta. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Declarar parâmetros com dicas de tipo”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Dê um bom nome e uma boa descrição à ferramenta
- Declarar parâmetros com dicas de tipo
- Retornar resultados úteis
- Uma ferramenta de calculadora, do início ao fim