Usar a classe App cliente da guia

A @microsoft/teams.client classe de aplicativo ajuda a resolver desafios comuns ao criar Aplicativos de Página Única hospedados no Microsoft Teams, Outlook e Microsoft 365. É a contrapartida do lado do cliente para o @microsoft/teams.app aplicativo que você pode usar para criar agentes de IA.

Essas duas classes de aplicativo foram projetadas para funcionar bem juntas. Por exemplo, quando você usa o @microsoft/teams.app App para expor uma função do lado do servidor, pode usar o @microsoft/teams.client método App exec para invocar facilmente essa função, pois o aplicativo do lado do cliente sabe como construir uma solicitação HTTP que o aplicativo do lado do servidor pode processar. Ele pode emitir uma solicitação para a URL correta, com o conteúdo esperado e os cabeçalhos contextuais. O aplicativo do lado do cliente inclui até mesmo um token de portador que o aplicativo do lado do servidor usa para autenticar o chamador.

Iniciando o aplicativo

Para usar o @microsoft/teams.client pacote, primeiro crie uma instância de app e, em seguida, chame app.start().


import { App } from '@microsoft/teams.client';

const app = new App(clientId);
await app.start();

O construtor de aplicativo se esforça para facilitar a introdução de um novo aplicativo, ao mesmo tempo em que é flexível o suficiente para se integrar facilmente aos aplicativos existentes.

O construtor usa dois argumentos: uma ID de cliente de aplicativo necessária e um argumento opcional AppOptions . A ID do cliente do aplicativo é a ID do aplicativo de registro de aplicativo do AAD (cliente). As opções podem ser usadas para personalizar a observabilidade, a configuração da Biblioteca de Autenticação da Microsoft (MSAL) e a chamada de função de agente remoto.

Para obter mais detalhes sobre as opções do aplicativo, consulte a página Opções do aplicativo .

O que acontece durante a inicialização

O construtor do aplicativo faz o seguinte:

  • Ele cria um logger de aplicativo, se nenhum for fornecido nas opções do aplicativo.
  • Ele cria um cliente HTTP usado para chamar o agente remoto.
  • Ele cria um cliente do Graph que pode ser usado assim que o aplicativo é iniciado.

A app.start() chamada faz o seguinte:

  • ele inicializa o TeamsJS.
  • Ele cria uma instância MSAL, se nenhuma for fornecida nas opções do aplicativo.
  • ele conecta a instância MSAL ao cliente do graph.
  • ele solicita ao usuário o consentimento do token MSAL, se necessário e se o pré-aquecimento não estiver desabilitado por meio das opções do aplicativo.

Usando o aplicativo

Quando a app.start() chamada for concluída, você poderá usar a instância do aplicativo para chamar APIs do Graph e chamar funções de agente remoto usando a exec() função ou diretamente usando o app.http cliente HTTP. O TeamsJS agora é inicializado, para que você possa interagir com o aplicativo de hospedagem. O app.msalInstance agora está preenchido, caso você precise usar o mesmo MSAL para outros fins.


import * as teamsJs from '@microsoft/teams-js';
import { App } from '@microsoft/teams.client';
import * as endpoints from '@microsoft/teams.graph-endpoints';

const app = new App(clientId);
await app.start();

// you can now get the TeamsJS context...
const context = await teamsJs.app.getContext();

// ...call Graph end points...
const presenceResult = await app.graph.call(endpoints.me.presence.get);

// ...and call remote agent functions...
const agentResult = await app.exec<string>('hello-world');