MAF + MCP na prática: conecte agentes .NET ao Foundry Toolbox com Semgrep

Introdução ao MAF e ao protocolo MCP

O vídeo apresenta um padrão poderoso para integração de agentes inteligentes em ambientes .NET, combinando o Microsoft Agent Framework (MAF) com o Model Context Protocol (MCP). A abordagem demonstra como conectar agentes criados em C# a ferramentas externas através do Azure AI Foundry, eliminando a necessidade de implementar parsers customizados ou lógicas complexas de análise. O protocolo MCP funciona como um intermediário padronizado que permite que agentes de IA acessem qualquer ferramenta externa de forma simples e escalável, criando uma arquitetura modular e extensível para sistemas Agentic AI modernos.

O que é Foundry Toolbox e sua utilidade

Foundry Toolbox é um componente do Azure AI Foundry que permite criar, gerenciar e disponibilizar ferramentas de forma programática em tempo de execução. Diferentemente de abordagens tradicionais, a criação de um Foundry Toolbox em runtime usando C# oferece flexibilidade para adaptar as capacidades do agente dinamicamente conforme a necessidade. O toolbox atua como um catálogo centralizado de funcionalidades que o agente pode acessar, abstraindo a complexidade da comunicação entre diferentes sistemas. Essa abordagem simplifica significativamente o desenvolvimento de agentes que precisam interagir com múltiplas ferramentas especializadas, permitindo que desenvolvedores foquem na lógica de negócio ao invés de detalhes técnicos de integração.

Conectando agentes via Model Context Protocol

O Model Context Protocol (MCP) é um protocolo aberto que padroniza a comunicação entre agentes de IA e ferramentas externas. Quando o Microsoft Foundry gera um endpoint MCP, ele cria um ponto de entrada único através do qual o agente pode descobrir e invocar ferramentas disponíveis. O vídeo demonstra como utilizar o MCP Client para listar todas as ferramentas disponíveis de forma dinâmica, permitindo que o agente tenha visibilidade completa sobre suas capacidades. Essa abordagem elimina a necessidade de implementação manual de cada integração, acelerando o desenvolvimento e reduzindo a superfície de possíveis erros. A comunicação via MCP é segura, versionada e segue padrões da indústria, tornando-a ideal para ambientes de produção.

Transformando ferramentas MCP em AITools do MAF

Um passo crítico no fluxo de trabalho é converter as ferramentas descobertas pelo MCP Client em objetos AITool que o Microsoft Agent Framework consegue entender e utilizar nativamente. Essa transformação envolve mapear os metadados da ferramenta MCP para o contrato esperado pelo MAF, incluindo parâmetros de entrada, tipos de retorno e descrições funcionais. O vídeo mostra como realizar essa transformação com poucas linhas de código, mantendo a segurança de tipos fornecida pelo C# e facilitando a validação de requisições. Uma vez que as ferramentas estão disponíveis como AITools, o agente pode invocá-las de forma integrada através do seu ciclo de inferência, com suporte nativo para tratamento de erros e serialização de dados.

O ciclo de Tool Calling gerenciado pelo MAF

O Microsoft Agent Framework automatiza todo o processo de tool calling, ou seja, a sequência de passos na qual o agente decide invocar uma ferramenta, coleta os parâmetros necessários, executa a chamada e processa o resultado. Diferentemente de implementações manuais, o MAF gerencia paralelização de chamadas, retry automático em caso de falha, e integração transparente com modelos de linguagem como OpenAI. O vídeo demonstra como esse ciclo funciona na prática quando um agente invoca o servidor MCP do Semgrep para análise estática de código. O MAF cuida de garantir que os resultados da ferramenta sejam corretamente formatados e retornados ao modelo para interpretação, criando um fluxo contínuo de raciocínio e ação.

Autenticação segura com BearerTokenHandler

A segurança é um aspecto crítico na comunicação entre agentes e ferramentas externas. O vídeo demonstra como implementar autenticação segura usando BearerTokenHandler, um mecanismo que injeta tokens Bearer nas requisições HTTP dirigidas ao endpoint MCP. Esse padrão permite que ferramentas externas verifiquem a identidade do agente antes de executar operações sensíveis, especialmente importante quando a ferramenta é um servidor MCP que analisa código em repositórios privados. A implementação do BearerTokenHandler segue as melhores práticas de segurança do .NET, integrando-se nativamente com os clientes HTTP do framework e suportando renovação automática de tokens quando necessário.

Semgrep como ferramenta de análise de código

O exemplo prático utiliza Semgrep, uma ferramenta de análise estática de código de código aberto, como o servidor MCP demonstrado no vídeo. Semgrep identifica automaticamente vulnerabilidades de segurança, problemas de performance e oportunidades de melhoria sem necessidade de escrever regras customizadas manualmente. Quando executado através de um agente MAF, Semgrep permite que o agente realize revisões completas de base de código com poucos comandos, interpretando os resultados e gerando recomendações. A integração via MCP torna essa capacidade acessível a qualquer aplicação .NET sem exigir conhecimento profundo das APIs internas do Semgrep.

Boas práticas e padrões para produção

O vídeo conclui com recomendações de boas práticas para implementar esse padrão em ambientes de produção, incluindo gerenciamento de ciclo de vida de conexões MCP, tratamento robusto de erros, logging estruturado e monitoramento de desempenho. Destaca-se a importância de cachear a lista de ferramentas disponíveis para reduzir latência, implementar timeouts apropriados para chamadas remotas e validar entrada de dados de forma rigorosa. Também são abordadas considerações de escalabilidade, como isolamento de agentes em múltiplas instâncias e garantia de que o endpoint MCP suporte múltiplas conexões simultâneas. Seguindo essas práticas, desenvolvedores podem construir sistemas Agentic AI confiáveis e performáticos que escalam com a demanda.