Primeiros passos
Instalação
- Vá para Settings > Integrations e selecione Microsoft Teams
- Clique em “Connect”
- Você será solicitado a instalar o aplicativo Devin para Microsoft Teams no seu tenant e/ou equipe de destino
- Certifique-se de vincular seu usuário. Todos os usuários da sua organização precisarão concluir esta etapa para usar o Devin
- Mencione
@Devinem um canal ou chat de uma equipe para iniciar uma sessão
Observação: Para que o Devin funcione para cada usuário, cada pessoa deve conectar a própria conta no painel do Devin (Settings > Integrations). Isso permite que o Devin associe a identidade do Microsoft Teams desse usuário à sua conta no Devin.
Como usar o Devin a partir do Microsoft Teams
@Devin em qualquer canal do Teams.
O Devin responderá em uma thread à sua sessão. Você pode se comunicar normalmente, como na interface de chat padrão do Devin.
Observe que o Devin pode cometer erros. Verifique as respostas com atenção.
Palavras-chave e funções inline no Teams
| Palavra-chave | Função |
|---|---|
!ask | Comece sua mensagem com !ask para obter uma resposta rápida sobre a base de código sem iniciar um agente completo |
!deep | Obtenha uma resposta de pesquisa mais detalhada usando busca avançada |
mute | Impede que Devin veja novas mensagens no tópico |
unmute | Reverte o comportamento acima |
(aside), !aside | Faz com que Devin ignore a mensagem (útil para comentários sobre a execução do Devin diretamente no tópico) |
sleep | Coloca Devin em modo de suspensão; para acordá-lo, envie qualquer mensagem no tópico |
archive | Coloca Devin em modo de suspensão e arquiva a sessão |
EXIT | Encerra a sessão |
help | Mostra uma mensagem de ajuda com as palavras-chave e funções disponíveis |
Preços
Privacidade
Fluxo de autenticação
Detalhes de permissões
Visão geral rápida
- Graph (aplicativo, em todo o tenant): descoberta e orquestração de instalação.
- Bot do Teams RSC (por equipe/chat): acesso restrito a mensagens/membros/configurações apenas onde o bot está instalado ou presente.
Permissões de Microsoft Graph (Aplicativo) em todo o tenant
| Permission | O que ela permite | Por que precisamos dela |
|---|---|---|
Organization.Read.All | Ler o perfil básico da organização | Validar o tenant onde o aplicativo está sendo instalado |
User.ReadBasic.All | Ler perfis básicos de todos os usuários | Mapear identidades de membros e resolver menções em Teams vinculados |
AppCatalog.Read.All | Ler o catálogo de aplicativos do Teams | Localizar nosso aplicativo e buscar o teamsAppId necessário para a instalação |
TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All | Instalar/desinstalar nosso próprio aplicativo; conceder RSC ao aplicativo | Instalar/remover o bot em um Team selecionado a partir do painel do Devin |
Observação: não usamos o Graph em nível de tenant para ler conteúdo de mensagens. O acesso a mensagens é concedido somente via RSC e somente onde o bot está instalado.
Permissões de Resource-Specific Consent (RSC) do bot do Teams
| Permission | Scope | O que permite | Por que precisamos disso |
|---|---|---|---|
ChannelMessage.Read.Group | Team/Channel | Ler mensagens de canais onde o aplicativo está instalado | Processar conversas de canal (resumos, gatilhos, sincronização) |
ChannelMessage.Send.Group | Team/Channel | Enviar mensagens em canais (novas postagens e respostas em threads) onde o aplicativo está instalado | Responder a mensagens em threads de canal e postar atualizações de forma proativa em canais |
Member.Read.Group | Team/Channel | Ler a lista de membros da equipe | Mapear identidades, realizar verificações de permissão, roteamento de menções |
TeamSettings.Read.Group | Team/Channel | Ler configurações da equipe | Respeitar políticas em nível de equipe e ajustar o comportamento |
ChatMember.Read.Chat | Chat | Ler os participantes do chat | Direcionar/responder corretamente e oferecer registros de auditoria |
ChatMessage.Read.Chat | Chat | Ler mensagens em chats onde o bot participa | Processar prompts, contexto e interações de acompanhamento |
ChatMessage.Send.Chat | Chat | Enviar mensagens em chats 1:1 e em grupo (DMs) onde o bot participa; não para canais | Responder a usuários em DMs e chats em grupo, postar notificações e respostas interativas em threads de chat |
ChatSettings.Read.Chat | Chat | Ler configurações do chat (por exemplo, moderação) | Alinhar o comportamento com as políticas do chat (limites de frequência, quem pode postar, etc.) |
Salvaguardas de RSC: o acesso é limitado à equipe/chat específico onde o aplicativo está instalado ou participa. Remover o aplicativo de uma equipe/chat revoga esse acesso.
Exemplo: autenticação baseada em certificado para descoberta de Teams
Observação sobre credenciais: usamos um certificado X.509 (client assertion) em vez de um client secret para autenticação entre serviços. Isso se aplica a chamadas ao Microsoft Graph, comunicações do bot com o adaptador do Bot Framework e quaisquer chamadas de API somente de aplicativo feitas pela integração.
Fluxo completo de processamento de mensagens (Teams → Cognition)
Observação sobre credenciais: usamos um certificado X.509 (client assertion) em vez de um client secret para autenticação entre serviços. Isso se aplica a chamadas ao Microsoft Graph, comunicações do bot com o adaptador do Bot Framework e a quaisquer chamadas de API somente aplicativo feitas a partir da integração.
Fluxo de consentimento e instalação
- Consentimento de administrador (em todo o locatário)
- Um administrador do Entra ID concede as permissões de aplicativo do Graph listadas acima.
- Descoberta do aplicativo
- A integração consulta o catálogo de aplicativos do Teams para localizar nosso app e obter o
teamsAppId.
- A integração consulta o catálogo de aplicativos do Teams para localizar nosso app e obter o
- Instalação direcionada
- A partir do nosso painel, instalamos o bot em uma equipe específica.
- Durante a instalação, os escopos de RSC são concedidos apenas para aquela equipe (ou para o chat específico quando invocado em um chat).
- Operação
- A descoberta (organização/equipes/canais/catálogo de aplicativos) usa permissões de aplicativo do Graph.
- A leitura/envio de mensagens e a leitura de membros/configurações dependem de RSC nos contextos em que o app está instalado.
Observações sobre privilégio mínimo
- Apenas leitores básicos:
User.ReadBasic.All(sem leitura de mensagens em todo o tenant). - O conteúdo das mensagens é acessado exclusivamente por meio de RSC e somente onde o bot estiver instalado/presente.
- Nenhuma permissão de caixa de correio, arquivos ou calendário é solicitada.
Revogação e desinstalação
- Revogar consentimento de administrador: Um administrador do locatário pode remover as permissões do aplicativo empresarial no Entra ID.
- Desinstalar do Teams: Remova o aplicativo de uma Equipe/Chat para revogar o RSC para esse recurso.
- Tratamento de dados: Na desinstalação, nossa integração interrompe o processamento de eventos para essa Equipe/Chat e limpa as assinaturas/vínculos relacionados.