Adicionar ferramentas ao agente de IA do Azure

Concluído

No Microsoft Agent Framework, as ferramentas permitem que seu agente de IA use APIs e serviços existentes para executar tarefas que não poderia fazer por conta própria. As ferramentas funcionam por meio da chamada de função, permitindo que a IA solicite e use automaticamente funções específicas. A estrutura roteia a solicitação para a função apropriada em sua base de código e retorna os resultados de volta para o LLM (modelo de linguagem grande) para que ele possa gerar uma resposta final.

Para habilitar a chamada automática de função, as ferramentas precisam fornecer detalhes que descrevam como funcionam. A entrada, a saída e a finalidade da função devem ser descritas de uma maneira que a IA possa entender, caso contrário, a IA não poderá chamar a função corretamente.

Como usar ferramentas com o Microsoft Foundry Agent

O Microsoft Agent Framework dá suporte a ferramentas de função personalizadas e ferramentas internas que estão prontas para uso imediato.

Ferramentas integradas

Os Microsoft Foundry Agents vêm com várias ferramentas internas que você pode usar imediatamente:

• Interpretador de Código – executa o código Python para cálculos, análise de dados e muito mais
• Pesquisa de Arquivos – pesquisa e analisa documentos
• Pesquisa na Web – recupera informações da Internet

Essas ferramentas estão disponíveis automaticamente e não exigem nenhuma configuração extra.

Ferramentas de função personalizadas

Ao criar ferramentas personalizadas para o Microsoft Foundry Agent, você precisa entender vários conceitos importantes:

1. Definição e anotações de função

   Crie sua ferramenta definindo uma função Python regular com anotações de tipo adequadas. Use Annotated e Field do Pydantic para fornecer descrições detalhadas que ajudam a IA a entender a finalidade da função e como usar seus parâmetros. Quanto mais descritivas suas anotações, melhor a IA poderá entender quando e como chamar sua função.

2. Adicionando ferramentas ao seu agente

   Passe suas funções personalizadas para o ChatAgent durante a criação usando o tools parâmetro. Você pode adicionar uma única função ou uma lista de várias funções. A estrutura registra automaticamente essas funções e as disponibiliza para a IA chamar.

3. Invocação de ferramenta por meio da conversa

   Depois que suas ferramentas estiverem registradas no agente, você não precisará invocá-las manualmente. Em vez disso, faça perguntas ao agente ou dê tarefas que naturalmente exigiriam a funcionalidade da sua ferramenta. A IA determina automaticamente quando chamar suas ferramentas com base no contexto da conversa e nas descrições da ferramenta fornecidas.

4. Várias ferramentas e orquestração

   Você pode adicionar várias ferramentas a um único agente e a IA escolhe automaticamente qual ferramenta usar com base na solicitação do usuário. A estrutura manipula a orquestração, chamando as funções apropriadas e combinando seus resultados para fornecer uma resposta abrangente.

Práticas recomendadas para o desenvolvimento de ferramentas

• Descrições claras: escreva descrições claras e detalhadas para suas funções e parâmetros para ajudar a IA a entender sua finalidade
• Anotações de tipo: use dicas de tipo python adequadas para especificar os tipos de entrada e saída esperados
• Tratamento de erros: implemente o tratamento de erros apropriado em suas funções de ferramenta para lidar normalmente com entradas inesperadas
• Retornar dados significativos: verifique se suas funções retornam dados que a IA pode usar efetivamente em suas respostas
• Manter as funções focadas: projete cada ferramenta para lidar com uma tarefa específica em vez de tentar fazer muitas coisas em uma única função

Seguindo esses conceitos, você pode estender seu Microsoft Foundry Agent com ferramentas internas e personalizadas, permitindo que ele interaja com APIs e execute tarefas avançadas. Essa abordagem torna sua IA mais poderosa e capaz de lidar com aplicativos do mundo real com eficiência.