Servidor de ferramentas simuladas

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

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 Agente 365 instalado - Use o servidor de ferramentas simuladas 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órioAgent365-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	Padrão
`-p, --port <port>`	Número da porta para o servidor fictício	5309
`-v, --verbose`	Habilitar o registro em log detalhado	false
`-?, -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:

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

Use servidor simulado com agentes de exemplo

Para conectar seu agente de amostra ao servidor de ferramentas simuladas:

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 mock:

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

Resolução de problemas

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

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