Servidor de ferramentas fictícias

A CLI do Agent 365 inclui um servidor de ferramentas fictício para fins de teste e desenvolvimento. Este servidor simula interações de servidor MCP (Model Context Protocol), permitindo que teste as capacidades de ferramentas do agente localmente, sem necessidade de implementações reais de servidores. Não abrange nenhuma outra funcionalidade do Agent 365.

Benefícios de utilizar o servidor fictício

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

Desenvolvimento offline: Teste o seu agente sem conectividade Internet ou dependências externas.
Testes consistentes: Receba respostas previsíveis para testar casos extremos.
Depuração: Ver todos os pedidos e respostas em tempo real
Iteração rápida: não é necessário aguardar chamadas de API externas ou configurar ambientes de teste complexos.

Pré-requisitos

Antes de utilizar o servidor de ferramentas fictício, certifique-se de que tem os seguintes pré-requisitos:

CLI do Agent 365 instalado - Utilize o servidor de ferramentas fictício juntamente com a CLI. Consulte a CLI do Agent 365 para obter instruções de instalação.
- Deve ter pelo menos a versão 1.1.25-preview para usar o servidor de ferramentas fictício.
Projeto de agente de exemplo - Um projeto de agente local que pode ligar-se a servidores MCP. Consulte o nosso repositório Agent365-Samples para obter pontos de partida disponíveis.

Iniciar o servidor de ferramentas fictício

Utilize o comando a365 develop start-mock-tooling-server para iniciar o servidor de ferramentas fictício.

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

# Short alias
a365 develop mts

Opções de comando

O servidor de ferramentas fictício suporta as seguintes opções:

Opção	Descrição	Predefinição
`-p, --port <port>`	Número da porta para o servidor fictício	5309
`-v, --verbose`	Ativar registo verboso	falso
`-?, -h, --help`	Mostrar informações de ajuda e de utilização	-
`-bg`	Executar o servidor num novo terminal	-

Exemplos

Os exemplos seguintes mostram formas comuns de iniciar o servidor de ferramentas fictício:

Começar com predefinições:

a365 develop start-mock-tooling-server

Começar numa porta personalizada:

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

Começar com registo verboso:

a365 develop start-mock-tooling-server -v

Quando executa o comando, este:

Inicia o servidor fictício na porta especificada (predefinição: localhost:5309).
Mostra registos do servidor e pedidos recebidos no terminal.

Utilizar servidor fictício com agentes de exemplo

Para ligar o agente de exemplo ao servidor de ferramentas fictício:

Passo 1: Iniciar o servidor fictício

a365 develop start-mock-tooling-server

O servidor é iniciado e apresenta uma saída semelhante ao exemplo seguinte:

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: Configurar o seu agente

Defina a variável de ambiente MCP_PLATFORM_ENDPOINT no agente de exemplo para apontar para o servidor fictício:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Se utilizar uma porta personalizada, substitua 5309 pelo número da porta escolhido.

Passo 3: Executar o seu agente

Inicie o seu agente de exemplo como faz normalmente. O agente agora liga-se ao servidor fictício em vez dos servidores MCP reais.

Passo 4: Monitorizar a atividade do servidor

O terminal do servidor fictício apresenta:

Pedidos recebidos do seu agente
Respostas fictícias a serem enviadas de volta
Estado da ligação e erros (se houver)

Exemplo de registos 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

Parar o servidor fictício

Para parar o servidor fictício, utilize Ctrl+C no terminal onde o servidor está em execução ou feche a janela do terminal.

Resolução de Problemas

Esta secção contém informações sobre como resolver problemas comuns com o servidor de ferramentas fictício.

Sugestão

O Guia de Resolução de Problemas do Agent 365 inclui recomendações de resolução de problemas de alto nível, melhores práticas e ligações para conteúdo de resolução de problemas para cada parte do ciclo de vida de desenvolvimento do Agent 365.

Falha ao iniciar o servidor fictício

Sintoma:Error: Address already in use

Causa: Outro processo já está a utilizar a porta predefinida (5309) ou a porta especificada.

Solução:

Utilize uma porta diferente.

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

Ou termine o processo que está a utilizar a porta e tente novamente.

O agente não consegue ligar-se ao servidor fictício

Sintoma: Os registos do agente mostram erros de ligação ou tempos limite ao tentar ligar-se ao servidor fictício.

Causa:

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