Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Parâmetros Dinâmicos Definidos pela IA

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Parâmetros dinâmicos definidos pela IA são campos de uma chamada externa que, em vez de terem valor fixo no fluxo, são preenchidos pelo próprio agente em tempo de execução. O que orienta esse preenchimento é o tipo e a descrição declarados para o campo.

O recurso existe para resolver um impasse de quem monta ferramentas em fluxo visual. A alternativa manual é extrair o dado da resposta do modelo, guardá-lo em uma variável e montar a chamada nó a nó — trabalhoso e frágil. Marcando o campo como dinâmico, o agente entrega o valor já pronto e a plataforma faz a substituição na hora do disparo da ferramenta.

Como o campo passa a ser preenchido pelo agente

Em um nó de requisição HTTP, cada campo editável tem ao lado um controle que ativa o preenchimento pela IA e troca o conteúdo por uma referência ao agente. Como a ativação substitui o que estava escrito, o valor literal anterior precisa ser copiado antes, ou se perde.

Ativado o recurso, o campo passa a ter três declarações: o nome do parâmetro, o tipo do valor e uma descrição. Essa descrição não é documentação — ela é lida pelo modelo como instrução e determina o que aparece ali. Escrevê-la em inglês foi apontado como preferível, pela mesma razão que vale para o restante do prompt.

Por que descrever o valor inteiro, e não só o dado

O erro comum é pedir ao agente apenas o dado bruto e esperar que a plataforma monte o resto. Funciona de maneira intermitente: às vezes a chamada sai correta, às vezes não, sem que a diferença entre os dois casos seja evidente. A prática que estabiliza o comportamento é ensinar ao agente como construir o valor completo — declarar qual é o endereço base e que o dado recebido deve ser concatenado a ele, de modo que o campo já chegue pronto.

Nomear a própria ferramenta ajuda pelo mesmo motivo. Um nó deixado com o nome padrão dá ao agente pouca base para decidir quando usá-lo; um nome que descreve a função, citado no prompt do agente, torna a escolha muito mais assertiva. Ferramenta sem nome e sem descrição é ferramenta que o modelo chama por acaso.

Nem todo campo pode ser inventado

A descrição de um parâmetro é um prompt, e o valor produzido é uma geração. Identificadores, chaves de registro e valores monetários não devem sair daí: se o dado não estiver disponível no contexto, o modelo tende a preencher com algo plausível em vez de falhar. Campo desse tipo continua vindo de uma variável do fluxo; o preenchimento dinâmico fica para o que o agente de fato deduz do pedido.

O que degrada a confiabilidade da escolha

O comportamento observado piora à medida que cresce o que está misturado no contexto do agente. Com poucas ferramentas e perguntas diretas, a escolha e o preenchimento saem corretos com regularidade; com muito conteúdo fora de contexto disputando atenção no mesmo agente, aparecem chamadas erradas e valores inventados. Isso empurra o desenho na mesma direção da especialização: menos ferramentas por agente, cada uma bem nomeada e bem descrita, com o encaminhamento ficando a cargo de um classificador antes.