Conteúdo do curso Lição 140 de 250 · Saídas estruturadas e chamada de funções/ferramentas
Saídas estruturadas e chamada de funções/ferramentas

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.annotation

Use 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.

Sua vez

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.