Conteúdo do curso Lição 173 de 250 · Construindo Agentes (Uso de Ferramentas e ReAct)
Construindo Agentes (Uso de Ferramentas e ReAct)

Intenção -> Extração de Ferramenta + Argumento

Antes do loop poder agir, ele tem que decidir qual ferramenta chamar e extrair os arguments da requisição. Esse é o roteador, e é a parte mais propensa a erros de um agente real: rotear mal a intenção ou errar os arguments e cada step seguinte estará errado. Um sistema de produção costuma usar o LLM para isso, mas um roteador que você pode ler, testar e raciocinar é mais rápido, mais barato e determinístico e você deve sempre ter um como fallback.

Você vai construir route(query) que mapeia um pedido de texto livre para uma decisão {"tool": ..., "args": {...}} estruturada. Três ferramentas reais mais uma de captura geral:

  • calculator - um pedido como "12 * 3" contém dois números ao redor de um operador. Analise em {"a": 12, "op": "*", "b": 3}.
  • weather - a palavra weather aparece. Puxe a cidade de "... in <City>" para {"city": "Paris"}.
  • dictionary - frases como define X ou meaning of X. Extraia o termo para {"term": "photosynthesis"}.
  • fallback - nada correspondeu, então direcione para o padrão seguro com o texto original em {"query": ...}.

Expressões regulares fazem o trabalho pesado. O padrão da calculadora captura um número, um operador e outro número:

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

Para a cidade, procure pela palavra in seguida de palavras com letra maiúscula; para o termo, procure após define / meaning of / definition of. Order matters: verifique o padrão da calculadora primeiro, depois o clima, depois o dicionário, e caia no fallback se nenhum corresponder.

Mantenha números como int quando forem inteiros (então 12, não 12.0) - os testes verificam o dict exato. Em um agente completo, essa decisão roteada alimenta diretamente o dispatcher do módulo structured-tools. Pressione Run para rotear quatro requisições diferentes.

Sua vez

Escreva route(query) que retorna {"tool": ..., "args": {...}}. Reconheça, em ordem: um pedido de calculadora ("12 * 3" -> {"a": 12, "op": "*", "b": 3}, números inteiros como ints), um pedido de clima (extraia a cidade após in), um pedido de dicionário (extraia o termo após define/meaning of), e um fallback para qualquer outra coisa com o texto original em {"query": ...}.

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.