Slack Agent Skill : monter un agent Slack sur Vercel avec eve

Pour qui

Cette skill s'adresse à ceux qui veulent construire et déployer un agent Slack sur Vercel. Elle s'utilise avec eve (le framework d'agents persistants de Vercel) et Vercel Connect (qui héberge les identifiants Slack). Documentation eve : https://eve.dev/docs Notes Connect : https://vercel.com/kb/guide/vercel-connect Le dépôt insiste : vous n'avez pas à manipuler vous-même le bot token ni le signing secret.

L'usage le plus adapté : vous comptez utiliser /slack-agent pour créer un projet ou configurer un projet existant, tester d'abord localement outils, instructions et conversations dans l'interface texte eve dev, et laisser les événements Slack pour après le déploiement. Elle ne convient pas à ceux qui veulent garder eux-mêmes le signing secret Slack, ou qui espèrent parcourir tous les événements dans l'interface Slack sans déployer.

N'appliquez pas cette commande d'installation dans un environnement sans prise en charge des skills. Ne traitez pas non plus un tunnel ngrok comme une étape obligatoire : la documentation indique que les événements Slack transitent par Connect vers le projet déployé ; ngrok n'est pas nécessaire.

Premier essai en 3 minutes

La commande d'installation officielle est : npx skills add vercel-labs/slack-agent-skill. L'adresse du dépôt est https://github.com/vercel-labs/slack-agent-skill Suivez uniquement cette page. N'écrivez pas d'installateurs non documentés.

Préconditions : l'assistant actuel prend en charge les skills, et vous avez un répertoire vide jetable ou un projet eve existant. L'emplacement d'installation est le répertoire de skills de l'assistant. Après installation, vérifiez que vous voyez /slack-agent new, /slack-agent configure, /slack-agent deploy et /slack-agent test.

Première tâche à faible risque : ne déployez pas d'abord. Si vous partez de zéro, lancez d'abord /slack-agent new (eve pose l'échafaudage), mais confirmez avant d'écrire des fichiers que le répertoire sert à l'exercice. Si un projet existe déjà, utilisez /slack-agent configure (détection automatique d'eve). Le signal de succès : l'échafaudage ou la configuration est terminée, et vous n'avez pas encore exécuté /slack-agent deploy.

La vérification locale passe par le TUI de eve dev : tester outils, instructions et conversations. Les événements de l'interface Slack attendent le déploiement, puis atteignent le projet via Vercel Connect. Les notes sur les variables d'environnement Slack ne citent que SLACK_CONNECTOR ; n'inventez pas d'autres espaces réservés de secrets. /slack-agent test sert à préparer les tests ; attendez que les conversations locales fonctionnent avant d'y penser.

Cas d'usage

Cas 1 : échafaudage depuis zéro. /slack-agent new construit un nouveau projet avec eve. Adapté si vous n'avez pas encore de dépôt et voulez d'abord voir la structure de l'agent en local. La documentation ne liste pas les fichiers générés, donc vous ne pouvez vérifier que « la commande a réussi et un projet eve est apparu ». Confirmez le répertoire avant d'écrire. Page de référence : https://github.com/vercel-labs/slack-agent-skill

Cas 2 : configurer un projet existant et séparer les vérifications locale et en production. /slack-agent configure détecte eve automatiquement. En local, utilisez eve dev pour tester outils, instructions et conversations ; les événements Slack arrivent via Connect après déploiement, sans ngrok. /slack-agent deploy déploie en production et doit venir après un TUI local réussi. Connect héberge OAuth, la rotation des jetons et la vérification des webhooks ; la seule variable d'environnement Slack nommée est SLACK_CONNECTOR. La documentation n'explique ni comment renseigner cette variable, ni le rollback de production ; ne déployez pas avant la fin de la configuration Connect.

Limites d'usage

Limite d'installation : l'officiel n'indique que npx skills add vercel-labs/slack-agent-skill. Limite de commandes : on peut vérifier /slack-agent new, configure, deploy, test. Limite des identifiants : vous n'avez pas à gérer vous-même le bot token ni le signing secret ; la seule variable Slack nommée est SLACK_CONNECTOR. Limite de test : le TUI local teste outils, instructions et conversations ; les événements Slack sont vérifiés via Connect après déploiement, sans ngrok. Limite de framework : eve et Vercel Connect sont les dépendances documentées, docs sur https://eve.dev/docs et https://vercel.com/kb/guide/vercel-connect Aucune garantie que d'autres plateformes d'hébergement s'appliquent telles quelles.