Kurrikulum Leson 140 van 250 · Gestruktureerde Uitsettes & Funksie/Gereedskap Roeping
Gestruktureerde Uitsettes & Funksie/Gereedskap Roeping

Funksie -> Tool Skema (Introspeksie)

Tool calling (ook bekend as function calling) laat 'n model jou program vra om 'n function uit te voer: jy adverteer 'n stel tools, die model antwoord met 'n tool name en arguments, en jy execute dit. Maar die model kan nie jou Python sien nie. Dit sien net 'n schema: 'n JSON beskrywing van elke tool se name en parameters. Om daardie schemas by hand te skryf vir elke function is vervelend en dit raak uit sin die oomblik wanneer jy 'n signature verander. Die oplossing is introspection: genereer die schema direk vanaf die function.

Python se inspect module lees 'n funksie se handtekening tydens uitvoering. Die skema wat die tool-calling APIs verwag, lyk soos dit:

{
  "name": "get_weather",
  "parameters": {
    "type": "object",
    "properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
    "required": ["city"]
  }
}

Jy bou tool_schema(func) wat presies dit produseer. Twee idees doen al die werk:

  • Map Python-tipes na JSON-schema-tipes. Lees elke parameter se annotasie en vertaal: int -> "integer", float -> "number", str -> "string", bool -> "boolean". Stel alles anders na aan as "string".
  • Derive word uit defaults verkry. 'n parameter met geen default is verpligtend; 'n parameter met 'n default is opsioneel. inspect.Parameter.empty is die sentinel vir "geen default".
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

Gebruik func.__name__ vir die hulpbronnaam. Bou dit sodat twee verskillend ge-aannotaerde funksies twee duidelik verskillende skemasasies produseer, 'n int param verskyn as "integer" en 'n str as "string", 'n parameter met 'n standaardwaarde word uit required weggela, en een sonder 'n standaardwaarde is daarin. Dit is die kontrak waarop elke hulpbron-oproep integrasie staat.

Jou beurt

Skryf tool_schema(func) wat 'n funksie met inspect.signature inspekteer en {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}} teruggee. Map int->"integer", float->"number", str->"string", bool->"boolean" (standaard "string"), en sit 'n parameter in required net wanneer dit geen standaard het nie.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.