O que PowerSkills faz?
Permite que agentes de IA controlem tarefas do Windows usando habilidades do PowerShell para Outlook, Edge, automação de desktop e comandos de shell estruturados em formato JSON.
Visão Geral
O PowerSkills fornece um conjunto de comandos PowerShell predefinidos que agentes de IA podem invocar para automatizar ações no Windows. As habilidades incluem:
- Outlook: Enviar, ler e gerenciar emails.
- Edge: Navegar, extrair dados e interagir com páginas da web.
- Automação de desktop: Abrir aplicativos, simular teclas e gerenciar janelas.
- Comandos de shell: Executar scripts e comandos arbitrários via PowerShell.
Como Funciona
Os agentes de IA recebem um prompt de sistema que descreve as habilidades disponíveis no formato JSON. Quando o agente decide executar uma ação, ele gera um objeto JSON com a estrutura esperada, que é então processado por um script PowerShell no host local.
Exemplo de Comando
{
"skill": "outlook",
"action": "sendEmail",
"parameters": {
"to": "[email protected]",
"subject": "Assunto do Email",
"body": "Este é um email automatizado pelo PowerSkills."
}
}
Pré-requisitos
- Windows 10 ou superior
- PowerShell 5.1+ (PowerShell 7+ recomendado)
- Permissões de execução para scripts PowerShell (
Set-ExecutionPolicy RemoteSigned) - Outlook configurado para habilidades relacionadas a email
- Microsoft Edge instalado para habilidades de navegação
Instalação
- Clone ou baixe este repositório.
- Adicione o script
powerskills.ps1ao seu PATH do Windows ou coloque-o em um local acessível. - No prompt do agente de IA, inclua as instruções de habilidade definidas em
skill-prompt.md. - Configure o agente para executar
powerskills.ps1sempre que uma ação JSON for gerada.
Exemplo de Configuração do Prompt
Você tem acesso ao PowerSkills. Use o seguinte formato JSON para executar ações:
{
"skill": "outlook|edge|desktop|shell",
"action": "nomeDaAcao",
"parameters": { ... }
}
Habilidades Disponíveis
Outlook
| Ação | Descrição | Parâmetros |
|---|---|---|
| sendEmail | Envia um email | to, subject, body |
| readInbox | Lê emails da caixa de entrada | maxItems (opcional) |
| searchEmails | Pesquisa emails por palavra-chave | query, maxItems |
Edge
| Ação | Descrição | Parâmetros |
|---|---|---|
| openUrl | Abre uma URL no Edge | url |
| getPageText | Extrai texto da página atual | (nenhum) |
| clickElement | Clica em um elemento da página por seletor | selector |
Desktop
| Ação | Descrição | Parâmetros |
|---|---|---|
| launchApp | Inicia um aplicativo | appName, args (opcional) |
| simulateKeys | Simula pressionamento de teclas | keys |
| getWindowTitle | Obtém o título da janela ativa | (nenhum) |
Shell
| Ação | Descrição | Parâmetros |
|---|---|---|
| run | Executa um comando PowerShell | command |
| runScript | Executa um arquivo de script | scriptPath, args |
Segurança
- Sempre valide os comandos JSON antes de executá-los.
- Use permissões mínimas para o usuário que executa os scripts.
- Evite expor o PowerSkills a entradas não confiáveis sem sanitização.
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests para adicionar novas habilidades ou melhorar as existentes.
Licença
Este projeto está licenciado sob a licença MIT.