Função -> schema de ferramenta (introspecção)
A chamada de ferramentas (também chamada de chamada de funções) permite que um modelo peça ao seu programa para rodar uma função: você anuncia um conjunto de ferramentas, o modelo responde com o nome de uma ferramenta e os argumentos, e você a executa. Mas o modelo não consegue ver o seu Python -> ele só vê um schema: uma descrição JSON do nome e dos parâmetros de cada ferramenta. Escrever esses schemas à mão para cada função é cansativo e sai de sincronia no momento em que você muda uma assinatura. A correção é a introspecção: gerar o schema direto da função.
O módulo inspect do Python lê a assinatura de uma função em tempo de execução. O schema que as APIs de chamada de ferramentas esperam é assim:
{
"name": "get_weather",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
"required": ["city"]
}
}Você vai construir tool_schema(func), que produz exatamente isso. Duas ideias fazem todo o trabalho:
- Associe tipos Python a tipos de JSON Schema. Leia a anotação de cada parâmetro e traduza:
int->"integer",float->"number",str->"string",bool->"boolean". Para qualquer outra coisa, use"string"como padrão. - Deduza os obrigatórios a partir dos padrões. Um parâmetro sem padrão é obrigatório; um parâmetro com padrão é opcional.
inspect.Parameter.emptyé a sentinela para "sem padrão".
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
is_required = param.default is inspect.Parameter.empty
json_type = ... # from param.annotationUse func.__name__ como nome da ferramenta. Construa de forma que duas funções anotadas de jeitos diferentes produzam dois schemas claramente diferentes, que um parâmetro int apareça como "integer" e um str como "string", que um parâmetro com padrão fique fora de required e que um sem padrão esteja nele. Esse é o contrato em que toda integração de chamada de ferramentas se apoia.
Escreva tool_schema(func), que faz a introspecção de uma função com inspect.signature e retorna {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Associe int->"integer", float->"number", str->"string", bool->"boolean" (padrão "string") e coloque um parâmetro em required só quando ele não tiver padrão.
Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição
Este exercício abre em breve
Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.
Este navegador está bloqueando cookies para learn.floati.life, então as lições que você terminou aqui não podem abrir em ordem. Permita cookies para este site e recarregue.