Servidor de ferramentas de simulação

O Agent 365 CLI inclui um servidor simulado de ferramentas para teste e desenvolvimento. Este servidor simula interações com o servidor MCP (Protocolo de Contexto do Modelo), permitindo que você teste as capacidades de ferramentas do seu agente localmente, sem a necessidade de servidores reais. Este servidor não abrange nenhuma outra funcionalidade do Agent 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 é preciso esperar por chamadas de API externas nem 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 simulação de ferramentas junto com a CLI. Consulte Agent 365 CLI para instruções de instalação.
    • Você deve ter pelo menos a versão preliminar 1.1.25 para usar o servidor de ferramentas simuladas.
  • Projeto de agente de exemplo - Um projeto de agente local que pode se conectar a servidores MCP. Consulte nosso repositório Agent365-Samples para os pontos de partida disponíveis.

Iniciar o servidor de ferramentas simulado

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 de simulação suporta as seguintes opções:

Opção Descrição Padrão
-p, --port <port> Número da porta do servidor simulado 5309
-v, --verbose Habilitar 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 maneiras comuns de iniciar o servidor de ferramentas de simulação:

Inicie com as configurações padrão:

a365 develop start-mock-tooling-server

Inicie em uma porta personalizada.

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

Comece com o registro em log detalhado:

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.

Usar servidor simulado com agentes de amostra

Para conectar seu agente de exemplo ao servidor de ferramentas simulado:

Etapa 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.

Etapa 2: Configurar o agente

Defina a variável de ambiente MCP_PLATFORM_ENDPOINT no agente de amostra a fim de 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.

Etapa 3: Gerenciar seu agente

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

Etapa 4: Monitorar a atividade do servidor

O terminal do servidor simulado exibe:

  • Requisições recebidas do seu agente
  • Respostas simuladas sendo enviadas de volta
  • Status de conexão e erros (se houver)

Exemplo de logs do servidor:

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 de simulação

Para parar o servidor de simulação, use Ctrl+C no terminal onde o servidor está em execução, ou feche a janela do terminal.

Solução de Problemas

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

Dica

O Guia de Solução de Problemas do Agent 365 contém recomendações de soluçã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 vida de desenvolvimento do Agent 365.

O servidor simulado não inicia

Sintoma:Error: Address already in use

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

Solução:

  • Use outra porta.

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

  • Ou interrompa o processo usando a porta e tente novamente.

O agente não consegue se conectar ao servidor simulado

Sintoma: Os logs do agente mostram erros de conexão ou timeouts ao tentar se conectar ao servidor simulado.

Causa:

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

Solução:

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