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.
Le Microsoft Bot Framework envoie des activités vers un point de terminaison que vous hébergez. Crew :
- Enregistre une route entrante :
POST /api/messaging/teams - 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 - 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
- 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
- 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 - Ouvrez Settings → Canaux de messagerie → Teams dans le tableau de bord
- Collez l'App ID, l'App Password (secret client) et le Tenant ID (ou laissez vide pour le multilocataire)
- Ajoutez votre courriel Azure AD ou votre ID d'objet à la liste Allowed emails
- 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.
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
| Commande | Effet |
|---|---|
/new | Nouvelle conversation |
/compact | Compresser le contexte |
/help | Lister les commandes |
- 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é
- 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)
| Clé | Défaut | Objectif |
|---|---|---|
teams.enabled | false | Active le canal |
teams.allowed_emails | [] | UPN/courriels/ID d'objet autorisés (vide = personne) |
teams.soft_threshold_pct | 80 | % de contexte où le bot suggère /compact |
teams.hard_threshold_pct | 95 | Seuil de compression forcée |
| Problème | Solution |
|---|---|
| 401 sur les requêtes entrantes | L'App ID ou le secret est incorrect; vérifiez l'enregistrement Azure Bot |
| Le bot ne répond pas | Confirmez que allowed_emails inclut votre UPN ou ID d'objet |
kirocrew[teams] non installé | Installez avec pip install "kirocrew[teams]" |
| Aucun badge vert dans Settings | La validation des identifiants sortants a échoué — vérifiez l'App ID/Password |
Page mise à jour : 25 septembre 2026
Teams