Funções

Funções codificadas como ferramentas de agente, permitindo que um agente execute código Python personalizado como uma ferramenta determinística baseada em processos ao lado de automações e fluxos de trabalho de API.

A ferramenta de função codificada permite que um agente execute código Python personalizado como uma ferramenta. Uma função encapsula a lógica determinística — transformações de dados, cálculos ou chamadas para sistemas externos — que o agente invoca quando seu raciocínio o chama e, em seguida, raciocina sobre o resultado retornado.

Uma função codificada comporta-se como as outras ferramentas baseadas em processos disponíveis para um agente, como fluxos de trabalho de API, automações ou ferramentas de agente. O agente passa argumentos de entrada para a função, a função executa seu código Python e o agente recebe a saída estruturada.

As funções são criadas no Studio Web. Para obter detalhes sobre como escrever, empacotar e publicar funções, consulte o guia do usuário de Funções.

Como os Agents usam funções

Depois que uma função estiver disponível em sua solução, ela aparecerá como uma ferramenta selecionável dentro da seção Ferramentas de uma definição de agente no Studio Web. Cada ferramenta carrega uma descrição que ajuda o agente a entender sua finalidade e quando usá-la.

No runtime, o agente passa parâmetros de entrada para a função, a função executa sua lógica do Python e o resultado retorna ao agente como saída estruturada para a próxima etapa em seu plano. Como a lógica é um código determinístico, uma função retorna a mesma saída para a mesma entrada, o que a torna adequada para operações precisas que o modelo de idioma não deve realizar apenas com raciocínio.

Como outros tipos de ferramentas, as funções codificadas são compatíveis com os controles de governança da plataforma. Você pode configurar proteções para controlar quando e como uma função é invocada, e simulações de ferramentas para testar o raciocínio do agente sem executar o código real.

Adição de uma função como uma ferramenta

Você pode adicionar uma função existente a partir de seus recursos disponíveis ou criar uma nova sem sair do agente.

1. Do painel Definição, na seção Ferramentas, selecione Adicionar ferramenta.
2. Selecione Função.
3. Adicione a função:
   • Para usar uma função existente, pesquise por ela ou selecione-a entre os recursos disponíveis.
   • Para criar uma nova função, selecione Criar novo. O assistente de criação de função é aberto dentro da solução.
4. Use a solicitação do sistema para descrever a finalidade da função e quando o agente deve usá-la. Para quaisquer argumentos, forneça uma descrição para ajudar o agente a usá-los de forma eficaz.

Monitoramento da execução da função

Quando um agente executa uma ferramenta de função codificada, você pode inspecionar a execução em dois locais:

• Trace de agente — Após uma execução de depuração, a trilha de execução inclui uma chamada de ferramenta para a função, mostrando os argumentos de entrada passados para ela e a saída que ela retornou.
• Orchestrator — A função é executada como um processo. Em Monitoramento > Trabalhos no Orchestrator, a função aparece como um trabalho, ao lado de outras execuções de trabalho do agente.