Estenda as capacidades do agente com ferramentas

  • 9 minutos

Uma das funcionalidades mais poderosas dos agentes de IA é a sua capacidade de usar ferramentas que expandem as suas capacidades para além da geração de texto. As ferramentas permitem aos agentes realizar ações, aceder a dados e integrar-se com sistemas externos. A Microsoft Foundry fornece ferramentas integradas e suporta integrações personalizadas, transformando agentes de interfaces de chat simples em sistemas sofisticados de automação.

Noções básicas sobre as ferramentas do agente

As ferramentas são funções programáticas que os agentes podem invocar para completar tarefas. Quando um agente determina que uma ferramenta é necessária para responder a um pedido de utilizador, chama automaticamente a ferramenta apropriada, processa os resultados e incorpora-os na sua resposta. Esta capacidade permite aos agentes trabalhar com dados em tempo real, executar código, pesquisar bases de conhecimento e interagir com serviços externos.

O ciclo de vida da chamada de uma ferramenta acontece automaticamente.

  1. O utilizador envia uma mensagem ao agente
  2. O agente analisa o pedido e determina quais as ferramentas (se existem) necessárias
  3. O agente invoca as ferramentas apropriadas com parâmetros relevantes
  4. Ferramentas executam e devolvem resultados
  5. O agente incorpora resultados numa resposta em linguagem natural
  6. A resposta é devolvida ao utilizador

Esta integração perfeita significa que pode adicionar capacidades poderosas aos agentes sem precisar de escrever código de orquestração complexo.

Visão geral das ferramentas integradas

A Microsoft Foundry fornece um catálogo de ferramentas que organiza as ferramentas disponíveis em três categorias: Configuradas (ferramentas integradas prontas a usar), Catálogo (ferramentas adicionais que pode adicionar a partir de um registo, incluindo servidores MCP) e Personalizadas (as suas próprias ferramentas através de especificações OpenAPI ou implementações personalizadas). Pode aceder ao catálogo de ferramentas através das Ferramentas de Construção > no portal ou através da extensão VS Code.

A seguir estão algumas das ferramentas mais usadas.

Intérprete de código

O Code Interpreter permite que os agentes escrevam e executem código Python num ambiente seguro e sandbox. Utilize-o para cálculos matemáticos, análise de dados, geração de gráficos, processamento de ficheiros e resolução de problemas complexos. Por exemplo, se um utilizador pedir a um agente para "calcular os juros compostos de um investimento de 10.000 dólares a uma taxa anual de 5% ao longo de 10 anos", o agente escreve e executa Python código para calcular o resultado exato.

A Pesquisa de Ficheiros proporciona geração aumentada por recuperação (RAG) ao permitir que os agentes pesquisem entre os documentos que carregaste. A ferramenta indexa os seus documentos num armazenamento vetorial e recupera informações relevantes quando necessário, apoiando as respostas dos agentes na sua base de conhecimento específica.

A Pesquisa de Ficheiros suporta PDF, Word (.docx), texto simples (.txt), Markdown (.md) e outros formatos. Quando adiciona a Pesquisa de Ficheiros a um agente, cria ou seleciona uma loja vetorial, carrega documentos e o sistema indexa-os automaticamente para pesquisa semântica.

O Bing Web Search liga o seu agente a informação da internet em tempo real, permitindo acesso a eventos atuais, temas em tendência e informações para além dos dados de treino. Inclui geração automática de citações, para que os agentes possam consultar as suas fontes.

O Azure AI Search oferece recuperação avançada de conhecimento a partir dos seus índices de pesquisa existentes. Ao contrário do File Search (que trabalha com documentos carregados diretamente para o agente), o Azure AI Search liga-se a fontes de dados indexadas em escala empresarial para cenários de pesquisa estruturados e não estruturados.

Ferramentas OpenAPI

As ferramentas OpenAPI permitem que os agentes interajam com APIs externas definidas pelas especificações OpenAPI 3.0, ligando os seus agentes a serviços web e sistemas empresariais. Tu forneces a especificação, e a Microsoft Foundry trata do mapeamento de parâmetros e da análise de respostas.

Ferramentas adicionais incorporadas

O catálogo de ferramentas inclui muitas mais ferramentas para cenários especializados:

Tool Descrição
Automação do navegador Interagir com páginas web, preencher formulários e extrair conteúdo
Utilização de computadores Interagir com aplicações de ambiente de trabalho
Geração de Imagem Crie imagens com base em descrições de texto
SharePoint Aceder a bibliotecas de conteúdos e documentos do SharePoint
Microsoft Fabric Liga-te aos agentes de dados Fabric para análise de dados
Investigação Aprofundada Realizar investigação aprofundada em múltiplas fontes
Interação de Agente para Agente Delegar tarefas a outros agentes
Interpretador de Código Personalizado Execução de código personalizável para ambientes especializados

O catálogo de ferramentas continua a expandir-se. Consulte o portal da Foundry para as ferramentas mais recentes disponíveis.

Adicionar ferramentas no Visual Studio Code

A extensão Microsoft Foundry oferece uma interface intuitiva para adicionar e configurar ferramentas. Podes adicionar ferramentas através do designer visual ou editando diretamente o ficheiro YAML.

Usando o designer visual

Para adicionar ferramentas através do Designer de Agentes:

  1. Abra o seu agente no Designer de Agentes
  2. Navegue até à secção Ferramentas no painel de configuração
  3. Selecione Adicionar Ferramenta ou o + ícone
  4. Navegue pelas ferramentas disponíveis na biblioteca de ferramentas
  5. Seleciona a ferramenta que queres adicionar
  6. Configure definições específicas da ferramenta, se necessário
  7. Guarda as tuas alterações

Captura de ecrã da interface do catálogo de ferramentas na extensão Microsoft Foundry VS Code.

Quando adicionas certas ferramentas, a extensão pede-te para configurar assets relacionados. Por exemplo, adicionar Pesquisa de Ficheiros permite-lhe criar ou selecionar uma loja vetorial para indexação de documentos.

Adição de ferramentas através do YAML

Também pode adicionar ferramentas editando diretamente o ficheiro YAML do agente. Esta abordagem funciona bem quando sabes exatamente que ferramentas precisas ou queres aplicar alterações a partir dos templates.

Aqui está um exemplo de configuração YAML com múltiplas ferramentas:

version: 1.0.0
name: research-assistant
description: Helps with research tasks using code analysis and web search
model:
  id: 'gpt-4o-deployment'
instructions: |
  You're a research assistant helping users gather and analyze information.
  Use Code Interpreter for data analysis and Bing Search for current information.
tools:
  - type: code_interpreter
  - type: bing_grounding
    bing_grounding:
      connection_id: "your-connection-id"
  - type: file_search
    file_search:
      vector_store_ids:
        - "vectorstore-123"

O array de ferramentas lista cada ferramenta ativada com a sua configuração. Algumas ferramentas requerem parâmetros adicionais como IDs de ligação ou referências de armazenamento vetorial.

Servidores MCP (Model Context Protocol)

O Protocolo de Contexto de Modelo (MCP) fornece uma forma padronizada de adicionar ferramentas personalizadas aos agentes. Os servidores MCP estão disponíveis através da secção Catálogo do catálogo de ferramentas e oferecem interfaces de ferramentas reutilizáveis que funcionam de forma consistente entre diferentes implementações de agentes.

Tipos de servidores MCP

O catálogo de ferramentas Foundry suporta três tipos de servidores MCP:

  • Servidores MCP remotos - Alojados externamente e acedidos através da rede. Estes são os tipos mais comuns para cenários de produção.
  • Servidores MCP locais - Funcionem na sua máquina local durante o desenvolvimento. Útil para testar ferramentas personalizadas antes de serem implementadas.
  • Servidores MCP personalizados - As suas próprias implementações de servidores MCP adaptadas a necessidades específicas.

Vantagens dos servidores MCP

Os servidores MCP oferecem várias vantagens:

Protocolo padronizado - Padrões consistentes de comunicação de ferramentas tornam a integração previsível e fiável.

Componentes reutilizáveis - Construa ferramentas uma vez e use-as em vários agentes e projetos.

Ferramentas orientadas pela comunidade - Aceder a ferramentas construídas pela comunidade através dos registos MCP, expandindo capacidades sem desenvolvimento personalizado.

Integração simplificada - Interfaces consistentes reduzem a complexidade da integração e a carga de manutenção.

Utilização de servidores MCP no VS Code

A extensão Microsoft Foundry suporta integração com servidores MCP:

  1. Navegue pelos servidores MCP disponíveis através do registo de ferramentas da extensão
  2. Adicione servidores MCP à configuração do seu agente
  3. Configurar definições e parâmetros específicos do servidor
  4. Teste a funcionalidade do servidor MCP no playground integrado
  5. Desenvolver agentes com integrações de servidores MCP para o ambiente de produção

Os servidores MCP ampliam as capacidades do seu agente com funções especializadas, mantendo uma experiência de desenvolvimento consistente.

Melhores práticas de configuração de ferramentas

Uma gestão eficaz das ferramentas assegura um desempenho fiável dos agentes:

  • Comece com ferramentas integradas antes de construir soluções personalizadas. As ferramentas integradas são testadas, mantidas e otimizadas para a plataforma.
  • Ajuste as ferramentas aos requisitos – Liste o que o seu agente precisa de fazer e selecione as ferramentas em conformidade. Não adicione ferramentas sem propósitos claros, pois cada ferramenta adiciona latência.
  • Forneça instruções claras - Informe o seu agente quando e como deve usar cada ferramenta (por exemplo, "Use Code Interpreter para quaisquer cálculos matemáticos") e quando não deve usá-las.
  • Mantenha as bases de conhecimento atualizadas - Ao usar a Pesquisa de Ficheiros, atualize documentos regularmente. Informação desatualizada leva a respostas incorretas.
  • Teste o comportamento da ferramenta de forma minuciosa usando o playground integrado. Envie mensagens que deverão desencadear o uso da ferramenta, verificar a invocação correta e testar cenários de erro.

Os agentes podem usar múltiplas ferramentas em conjunto para lidar com cenários complexos. Por exemplo, um agente de investigação pode usar o Bing Web Search para recolher informações atuais, o Code Interpreter para analisar dados e o File Search para referenciar documentação interna — tudo orquestrado automaticamente com base no pedido do utilizador.

Expandir as capacidades dos agentes com ferramentas transforma interfaces simples de chat em sistemas de automação poderosos. Ao combinar ferramentas integradas com integrações personalizadas e servidores MCP, pode criar agentes que interagem de forma fluida com os seus dados, sistemas e serviços, mantendo a segurança e fiabilidade de nível empresarial.

Discussões mais aprofundadas sobre ambas as ferramentas e servidores MCP podem ser encontradas em módulos posteriores.