Servidor de simulação de ferramentas

A CLI do Agente 365 inclui um servidor de ferramentas simuladas para fins de teste e desenvolvimento. Este servidor simula interações com servidores MCP (Model Context Protocol), então você pode testar as capacidades das ferramentas do seu agente localmente sem precisar de implementações reais do servidor. Não cobre nenhuma outra funcionalidade do Agente 365.

Benefícios de usar o servidor simulado

O servidor simulado oferece os seguintes benefícios para desenvolvimento e testes locais:

  • Desenvolvimento offline: Teste seu agente sem conectividade à internet ou dependências externas.
  • Testes consistentes: Receba respostas previsíveis para testar casos extremos.
  • Depuração: Visualize todas as solicitações e respostas em tempo real
  • Iteração rápida: Não precisa esperar por chamadas de API externas ou configurar ambientes de teste complexos.

Pré-requisitos

Antes de usar o servidor de ferramentas simuladas, certifique-se de ter os seguintes pré-requisitos:

  • CLI do Agent 365 instalado - Use o servidor de ferramentas de simulação junto com a CLI. Consulte o CLI do Agente 365 para instruções de instalação.
    • Você deve ter pelo menos a versão 1.1.25-preview para usar o servidor de ferramentas simuladas.
  • Projeto de agente de exemplo - Um projeto de agente local que pode se conectar a servidores MCP. Veja nosso repositório Agent365-Samples para os pontos de partida disponíveis.

Inicie o servidor de ferramentas simuladas

Use o comando a365 develop start-mock-tooling-server para iniciar o servidor de ferramentas simuladas.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

Opções de comando

O servidor de ferramentas simuladas suporta as seguintes opções:

Opção Description Default
-p, --port <port> Número da porta para o servidor fictício 5309
-v, --verbose Habilitar o registro em log detalhado falso
-?, -h, --help Mostrar informações de ajuda e uso -
-bg Executar o servidor em um novo terminal -

Exemplos

Os exemplos a seguir mostram formas comuns de iniciar o servidor de ferramentas simuladas:

Comece pelas configurações padrão:

a365 develop start-mock-tooling-server

Comece em uma porta personalizada:

a365 develop start-mock-tooling-server -p 8080

Comece com registros detalhados:

a365 develop start-mock-tooling-server -v

Quando você executa o comando, ele:

  1. Inicia o servidor simulado na porta especificada (padrão: localhost:5309).
  2. Exibe logs do servidor e solicitações recebidas no terminal.

Use servidor simulado com agentes de exemplo

Para conectar seu agente de exemplo ao servidor de ferramentas de simulação:

Passo 1: Iniciar o servidor simulado

a365 develop start-mock-tooling-server

O servidor inicia e exibe a saída de forma semelhante ao seguinte exemplo:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

Passo 2: Configure seu agente

Defina a MCP_PLATFORM_ENDPOINT variável de ambiente no seu agente de amostra para apontar para o servidor simulado:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Se você usar uma porta personalizada, substitua 5309 pelo número de porta escolhido.

Passo 3: Gerencie seu agente

Comece seu agente de amostragem como você costuma fazer. O agente agora se conecta ao servidor mock em vez dos servidores MCP reais.

Passo 4: Monitorar a atividade do servidor

O terminal do servidor simulado exibe:

  • Pedidos recebidos do seu agente
  • Respostas simuladas sendo enviadas de volta
  • Status da conexão e erros (se houver)

Exemplos de logs de servidores:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

Parando o servidor simulado

Para parar o servidor simulado, use Ctrl+C no terminal onde o servidor está rodando, ou feche a janela do terminal.

Solucionando problemas

Esta seção contém informações sobre como solucionar problemas comuns com o servidor de ferramentas de simulação.

Dica

O Guia de Solução de Problemas do Agente 365 contém recomendações de resolução de problemas de alto nível, melhores práticas e links para conteúdo de solução de problemas para cada parte do ciclo de desenvolvimento do Agente 365.

Servidor simulado falha em iniciar

Sintoma:Error: Address already in use

Causa: Outro processo já está usando a porta padrão (5309) ou a porta especificada por você.

Solution:

  • Use uma porta diferente.

    a365 develop start-mock-tooling-server -p 8080

  • Ou parar o processo usando a porta e tentar novamente.

O agente não consegue se conectar ao servidor simulado

Sintoma: Os logs dos agentes mostram erros de conexão ou tempos de espera ao tentar alcançar o servidor simulado.

Causa:

  • O servidor simulado não está rodando.
  • Variável de ambiente incorreta MCP_PLATFORM_ENDPOINT .
  • Problemas de firewall ou configuração de rede.

Solution:

  1. Verifique se o servidor simulado está rodando e mostra "Agora ouvindo em: http://localhost:5309".
  2. Verifique se a MCP_PLATFORM_ENDPOINT variável ambiente corresponde ao endereço do servidor.
  3. Certifique-se de que nenhum firewall bloqueie a conexão na porta especificada.
  • Last updated on