Ponto final de mensagens do agente

O ponto final de mensagens do agente é o ponto final para o qual envia mensagens de notificação por meio de agentes ao seu agente.

Eliminar ponto final de mensagens do agente

Utilize o comando a365 cleanup blueprint --endpoint-only para limpar o registo do ponto final de mensagens do agente. Este comando não afeta o código do seu agente nem o ponto final implementado. Apenas remove a entrada de registo via Teams Graph (Plataforma MCP).

a365 cleanup blueprint --endpoint-only

Configurar o ponto final de mensagens em a365.config.json

Antes de configurar o ponto final de mensagens, especifique-o no seu ficheiro de configuração a365.config.json. Este ficheiro contém a configuração principal para a implementação do seu agente.

Adicione ou atualize estas propriedades de configuração do ponto final de mensagens:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Especifique o URL exato do ponto final para o qual pode enviar mensagens ao agente.

  • deploymentProjectPath: Caminho para o diretório do projeto do seu agente. Esta propriedade não é relevante se o seu agente já estiver implementado e não for necessário atualizar a configuração do ambiente. Defina deploymentProjectPath como . apenas se o código do agente não estiver localizado na sua máquina.

Propriedades de configuração

Propriedade Descrição Necessário Predefinição Exemplo
messagingEndpoint O URL onde o seu agente recebe mensagens Sim Nenhum https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Caminho para o diretório do projeto do agente para atualizações de configuração Não . ./my-agent ou .

Opções de configuração do ponto final

O valor do messagingEndpoint depende do seu cenário de implementação:

Para implementações em Azure:

  • Aplicações Web do Azure: https://your-app-name.azurewebsites.net/api/messages

Para implementações que não são do Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Outros fornecedores de cloud: o URL do ponto final personalizado

Para testes locais com Túneis de Desenvolvimento:

  • URL do Túnel de Desenvolvimento: https://abc123xyz.devtunnels.ms:3978/api/messages

Importante

O deploymentProjectPath define onde a CLI procura ficheiros de projeto e onde atualiza a configuração do ambiente, como ficheiros .env.

Nota

Ao utilizar Túneis de Desenvolvimento para testes locais, atualize o messagingEndpoint no a365.config.json com o URL do seu Túnel de Desenvolvimento antes de executar o comando de configuração. Para mais informações, consulte testes com Túneis de Desenvolvimento.

Definir ponto final de mensagens do agente

Depois de atualizar o seu ficheiro a365.config.json, utilize este comando para registar o ponto final de mensagens para que o serviço Agent 365 possa enviar notificações ao seu agente. A operação --endpoint-only regista o ponto final através do Teams Graph (Plataforma MCP).

a365 setup blueprint --endpoint-only

Também pode passar o URL diretamente com --messaging-endpoint, em vez de editar a365.config.json:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Durante os testes locais, pode definir este ponto final como um ponto final de Túnel de Desenvolvimento antes de implementar o agente na cloud. Para mais informações, consulte testes com Túneis de Desenvolvimento.

Para atualizar um URL de ponto final existente:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages

Implementação do ponto final

Se ainda não tiver o seu agente implementado na cloud, saiba como implementar o agente no Azure.

Se já tiver o seu agente implementado na cloud, pode definir o ponto final de mensagens conforme explicado anteriormente.

Saiba como configurar o ponto final de mensagens noutras clouds populares:

  • Last updated on