Passer au contenu principal
Afficher en Markdown

Teams

Crew peut fonctionner comme un bot Microsoft Teams. Envoyez un MP à votre agent depuis Teams avec des réponses en diffusion continue et un indicateur de frappe.

Comment ça fonctionne

Le Microsoft Bot Framework envoie des activités vers un point de terminaison que vous hébergez. Crew :

  1. Enregistre une route entrante : POST /api/messaging/teams
  2. Valide l'en-tête Authorization: Bearer <jwt> de chaque requête par rapport aux clés de signature du Bot Framework avant le traitement
  3. Accuse réception rapidement avec 200, exécute le tour de l'agent en arrière-plan, puis envoie la réponse via l'API REST Bot Connector

Prérequis

  • Une URL HTTPS publique atteignant votre passerelle (proxy inverse, tunnel de développement ou VM publique)
  • L'extra Teams installé : pip install "kirocrew[teams]"
  • Un enregistrement Azure Bot avec un Microsoft App ID et un secret

Configuration

Depuis le tableau de bord (recommandé)

  1. Enregistrez un Azure Bot dans le portail Azure — créez une ressource Azure Bot, notez l'App ID, créez un secret client, ajoutez le canal Microsoft Teams et définissez le point de terminaison de messagerie sur https://<your-host>/api/messaging/teams
  2. Ouvrez Settings → Canaux de messagerie → Teams dans le tableau de bord
  3. Collez l'App ID, l'App Password (secret client) et le Tenant ID (ou laissez vide pour le multilocataire)
  4. Ajoutez votre courriel Azure AD ou votre ID d'objet à la liste Allowed emails
  5. Cliquez sur Save — le badge d'état devient vert lorsque les identifiants sont validés

Ensuite, chargez latéralement un paquet d'application Teams (Developer Portal → nouvelle application → Bot avec votre App ID, portée Personal) et envoyez un MP au bot.

Depuis la CLI

Dans ~/.kiro/crew/.env :

MICROSOFT_APP_ID=<your app id> MICROSOFT_APP_PASSWORD=<your client secret> MICROSOFT_APP_TENANT_ID=<tenant id or leave unset>

Dans ~/.kiro/crew/config.json :

json
{ "teams": { "enabled": true, "allowed_emails": ["you@yourcompany.com"] } }

Installez l'extra Teams : pip install "kirocrew[teams]"

Puis : kirocrew restart

Commandes

CommandeEffet
/newNouvelle conversation
/compactCompresser le contexte
/helpLister les commandes

Sécurité

  • Le webhook est exempté de la barrière de témoins du tableau de bord — effectue sa propre validation JWT Bot Framework
  • L'autorisation refuse par défaut à la fois sur la liste d'autorisation de courriels et sur la portée de conversation (personnelle seulement)
  • Tous les refus sont enregistrés dans le journal des événements de sécurité
  • L'App Password est marqué comme sensible et n'est jamais journalisé

Limitations

  • Clavardage personnel 1:1 seulement — aucun canal d'équipe, clavardage de groupe ou gestion des mentions @
  • Aucune Adaptive Card / bouton pressable (les options sont livrées en texte brut)
  • Aucune diffusion continue jeton par jeton — l'indicateur de frappe est affiché, la réponse finale est livrée en un seul message (fragmenté si long)

Configuration

CléDéfautObjectif
teams.enabledfalseActive le canal
teams.allowed_emails[]UPN/courriels/ID d'objet autorisés (vide = personne)
teams.soft_threshold_pct80% de contexte où le bot suggère /compact
teams.hard_threshold_pct95Seuil de compression forcée

Dépannage

ProblèmeSolution
401 sur les requêtes entrantesL'App ID ou le secret est incorrect; vérifiez l'enregistrement Azure Bot
Le bot ne répond pasConfirmez que allowed_emails inclut votre UPN ou ID d'objet
kirocrew[teams] non installéInstallez avec pip install "kirocrew[teams]"
Aucun badge vert dans SettingsLa validation des identifiants sortants a échoué — vérifiez l'App ID/Password
Page mise à jour : 25 septembre 2026