Programma Lezione 173 di 250 · Costruire agenti (uso di strumenti e ReAct)
Costruire agenti (uso di strumenti e ReAct)

Dall'intento allo strumento + estrazione degli argomenti

Prima che il ciclo possa agire, deve decidere quale strumento chiamare ed estrarre gli argomenti dalla richiesta. Questo è l'instradatore, ed è la parte più soggetta a errori di un vero agente: sbaglia l'intento o pasticcia con gli argomenti e ogni passo a valle è sbagliato. Un sistema di produzione spesso usa l'LLM per questo, ma un instradatore che puoi leggere, testare e capire è più veloce, più economico e deterministico, e dovresti averne sempre uno come ripiego.

Costruirai route(query) che associa una richiesta in testo libero a una decisione strutturata {"tool": ..., "args": {...}}. Tre strumenti veri più uno di ripiego:

  • calculator: una richiesta come "12 * 3" contiene due numeri intorno a un operatore. Trasformala in {"a": 12, "op": "*", "b": 3}.
  • weather: compare la parola weather. Estrai la città da "... in <City>" in {"city": "Paris"}.
  • dictionary: formulazioni come define X o meaning of X. Estrai il termine in {"term": "photosynthesis"}.
  • fallback: niente ha corrisposto, quindi instrada verso il default sicuro con il testo originale in {"query": ...}.

Le espressioni regolari fanno il lavoro pesante. Lo schema della calcolatrice cattura un numero, un operatore e un altro numero:

import re
m = re.search(r"(-?\d+(?:\.\d+)?)\s*([+\-*/])\s*(-?\d+(?:\.\d+)?)", text)
if m:
    a, op, b = m.group(1), m.group(2), m.group(3)
    # turn "12" into 12 (an int) so the calculator gets real numbers

Per la città, cerca la parola in seguita da parole con la maiuscola; per il termine, cerca dopo define / meaning of / definition of. L'ordine conta: controlla prima lo schema della calcolatrice, poi weather, poi dictionary, e ricadi sul fallback se nessuno corrisponde.

Tieni i numeri come semplici int quando sono interi (quindi 12, non 12.0): i test controllano il dict esatto. In un agente completo questa decisione di instradamento va dritta nello smistatore del modulo sugli strumenti strutturati. Premi Run per instradare quattro richieste diverse.

Tocca a te

Scrivi route(query) che restituisce {"tool": ..., "args": {...}}. Riconosci, in ordine: una richiesta di calcolo ("12 * 3" -> {"a": 12, "op": "*", "b": 3}, numeri interi come int), una richiesta sul meteo (estrai la città dopo in), una richiesta di dizionario (estrai il termine dopo define/meaning of), e un fallback per qualsiasi altra cosa con il testo originale in {"query": ...}.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.