O que gws-workflow faz?
Google Workflow: Fluxos de trabalho de produtividade entre serviços.
Visão Geral
O skill googleworkspace/gws-workflow permite que agentes de IA criem e executem fluxos de trabalho automatizados entre os principais serviços do Google Workspace. Ele combina ações como:
- Criar e gerenciar eventos no Google Calendar
- Pesquisar, mover e organizar arquivos no Google Drive
- Enviar e ler e-mails no Gmail
- Criar e editar documentos no Google Docs e Google Sheets
- Gerenciar tarefas no Google Tasks
Como Funciona
O skill expõe comandos de alto nível que abstraem chamadas de API complexas. Por exemplo, um comando como "Criar um evento no Calendário para amanhã às 14h" resultará em uma série de ações orquestradas.
Comandos Suportados
create_calendar_event: Cria um evento no Google Calendar.search_drive_file: Procura um arquivo no Google Drive.move_drive_file: Move um arquivo para uma pasta específica.send_email: Envia um e-mail via Gmail.create_doc: Cria um novo documento no Google Docs com conteúdo.create_sheet: Cria e popula uma planilha no Google Sheets.
Nota: Todos os comandos exigem autenticação prévia com as permissões apropriadas do Google Workspace.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes compatíveis com skills de IA
Uso Básico
- Configure as credenciais do Google Workspace (via OAuth 2.0).
- Importe o skill no seu agente.
- Utilize comandos como os exemplos abaixo.
Exemplo: Agendar uma Reunião e Enviar Convite
create_calendar_event(
summary="Reunião de Equipe",
start_time="2025-03-10T14:00:00-03:00",
end_time="2025-03-10T14:30:00-03:00",
attendees=["[email protected]"]
)
send_email(
to="[email protected]",
subject="Confirmação: Reunião de Equipe",
body="Sua reunião foi agendada para 10/03 às 14h."
)
Exemplo: Organizar Arquivos no Drive
search_drive_file(query="relatório mensal")
move_drive_file(file_id="12345", folder_id="relatorios/2025")
Configuração do Ambiente
Para usar este skill, você precisa:
- Conta do Google Workspace com acesso ao Google Cloud Console.
- Projeto no Google Cloud com as APIs necessárias ativadas:
- Google Calendar API
- Google Drive API
- Gmail API
- Google Docs API (opcional)
- Google Sheets API (opcional)
- Credenciais OAuth 2.0 configuradas com os escopos adequados.
Variáveis de Ambiente
| Variável | Descrição |
|---|---|
GOOGLE_CLIENT_ID | ID do cliente OAuth |
GOOGLE_CLIENT_SECRET | Segredo do cliente OAuth |
GOOGLE_REFRESH_TOKEN | Token de atualização para acesso persistente |
Autorização
O skill utiliza o fluxo OAuth 2.0 com escopos mínimos necessários para cada operação.
Solução de Problemas
- Certifique-se de que as APIs estão ativadas no Google Cloud Console.
- Verifique se o token de atualização é válido e possui escopos corretos.
- Se um comando falhar, revise as permissões do usuário no Google Workspace.
Contribuição
Relate problemas ou sugira melhorias no repositório oficial do skill.
Skill oficial do Google Workspace para agentes de IA.