Slack Agent Skill: montar um agente Slack na Vercel com eve

Para quem

Esta skill é para quem quer construir e implantar um agente Slack na Vercel. Combina com eve (o framework de agentes persistentes da Vercel) e Vercel Connect (que hospeda credenciais do Slack). Documentação do eve: https://eve.dev/docs Notas do Connect: https://vercel.com/kb/guide/vercel-connect O repositório enfatiza: você não precisa manusear o bot token nem o signing secret.

O uso mais adequado: você pretende usar /slack-agent para criar um projeto ou configurar um existente, testar primeiro no local ferramentas, instruções e conversas na interface de texto eve dev, e deixar os eventos do Slack para depois do deploy. Não serve para quem ainda quer guardar o signing secret do Slack ou espera clicar em todos os eventos na interface do Slack sem implantar.

Não aplique este comando de instalação num ambiente sem suporte a skills. Também não trate um túnel ngrok como passo obrigatório: a documentação diz que os eventos do Slack vão pelo Connect até o projeto implantado; ngrok não é necessário.

Primeira tentativa em 3 minutos

O comando oficial de instalação é: npx skills add vercel-labs/slack-agent-skill. O endereço do repositório é https://github.com/vercel-labs/slack-agent-skill Siga apenas esta página. Não escreva instaladores não documentados.

Pré-condições: o assistente atual oferece suporte a skills e você tem um diretório vazio descartável ou um projeto eve existente. O local de instalação é o diretório de skills do assistente. Depois de instalar, confirme que vê /slack-agent new, /slack-agent configure, /slack-agent deploy e /slack-agent test.

Primeira tarefa de baixo risco: não faça deploy primeiro. Se começar do zero, execute primeiro /slack-agent new (monta o andaime com eve), mas confirme antes de escrever arquivos que o diretório é de prática. Se já houver projeto, use /slack-agent configure (detecta eve automaticamente). Sinal de sucesso: o andaime ou a configuração terminou e você ainda não executou /slack-agent deploy.

A verificação local usa o TUI de eve dev: teste ferramentas, instruções e conversas. Eventos na interface do Slack esperam o deploy e chegam ao projeto pelo Vercel Connect. Nas notas de variáveis de ambiente do Slack só aparece SLACK_CONNECTOR; não invente outros marcadores de segredo. /slack-agent test serve para configurar testes; espere as conversas locais funcionarem antes de considerar.

Casos de uso

Caso 1: andaime do zero. /slack-agent new monta um projeto novo com eve. Serve quando você ainda não tem repositório e só quer ver localmente a estrutura do agente. A documentação não lista os arquivos gerados, portanto só dá para confirmar que «o comando funcionou e surgiu um projeto eve». Confirme o diretório antes de escrever. Página de referência: https://github.com/vercel-labs/slack-agent-skill

Caso 2: configurar um projeto existente e separar a verificação local da de produção. /slack-agent configure detecta eve automaticamente. No local, use eve dev para testar ferramentas, instruções e conversas; eventos do Slack chegam pelo Connect após o deploy, sem ngrok. /slack-agent deploy implanta em produção e deve vir depois do TUI local passar. O Connect hospeda OAuth, rotação de tokens e verificação de webhooks; a única variável de ambiente Slack nomeada é SLACK_CONNECTOR. A documentação não descreve como preencher essa variável nem o rollback de produção; não faça deploy antes de concluir a configuração do Connect.

Limites de uso

Limite de instalação: o oficial só registra npx skills add vercel-labs/slack-agent-skill. Limite de comandos: dá para conferir /slack-agent new, configure, deploy, test. Limite de credenciais: você não precisa tratar o bot token nem o signing secret; a única variável Slack nomeada é SLACK_CONNECTOR. Limite de teste: o TUI local testa ferramentas, instruções e conversas; eventos do Slack são verificados pelo Connect após o deploy, sem ngrok. Limite de framework: eve e Vercel Connect são as dependências documentadas, com docs em https://eve.dev/docs e https://vercel.com/kb/guide/vercel-connect Não há garantia de que outras plataformas de hospedagem se apliquem diretamente.