Ações do Cursor
Execute tarefas do Cursor Cloud Agent a partir dos seus fluxos de trabalho do SmartFlow. Inicie agentes de codificação AI, monitore seu progresso, adicione instruções de acompanhamento e gerencie o ciclo de vida do agente — tudo a partir de fluxos de trabalho automatizados.
Pré-requisitos
- A integração do Cursor Cloud Agents deve estar conectada
- Pelo menos um repositório do GitHub sincronizado
Ações Disponíveis
Iniciar Agente de Codificação
Inicie um novo Cursor Cloud Agent para realizar uma tarefa de codificação em um repositório do GitHub.
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Repositório | Sim | Texto | URL ou nome do repositório do GitHub (ex.: owner/repo) |
| Descrição da Tarefa | Sim | Área de Texto | Descreva o que o agente deve fazer |
| Branch | Não | Texto | Branch ou ref do Git para trabalhar (padrão: main) |
| Modelo | Não | Texto | Modelo de AI a ser usado para o agente |
| Criar PR Automaticamente | Não | Booleano | Criar automaticamente uma pull request quando concluído (padrão: true) |
| Nome da Branch | Não | Texto | Nome da branch personalizada para a pull request |
Variáveis de Saída:
| Variável | Descrição |
|---|---|
agentId | ID do agente iniciado |
status | Status atual do agente |
repository | Repositório no qual o agente está trabalhando |
Adicionar Acompanhamento
Envie instruções adicionais para um agente de codificação em execução.
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| ID do Agente | Sim | Texto | ID do agente para o qual adicionar acompanhamento |
| Prompt de Acompanhamento | Sim | Área de Texto | Instrução adicional para o agente |
Variáveis de Saída:
| Variável | Descrição |
|---|---|
agentId | ID do agente |
Obter Status do Agente
Verifique o status detalhado e o progresso de um agente de codificação.
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| ID do Agente | Sim | Texto | ID do agente a ser verificado |
Variáveis de Saída:
| Variável | Descrição |
|---|---|
agentId | ID do agente |
status | Status atual: RUNNING, COMPLETED, FAILED, CREATING ou CANCELLED |
summary | Resumo do trabalho do agente |
prUrl | URL para a pull request (se criada) |
createdAt | Quando o agente foi criado |
Deletar Agente
Deletar um agente de codificação e limpar seus recursos.
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| ID do Agente | Sim | Texto | ID do agente a ser deletado |
Variáveis de Saída:
| Variável | Descrição |
|---|---|
agentId | ID do agente deletado |
Valores de Status do Agente
| Status | Descrição |
|---|---|
CREATING | O agente está sendo inicializado |
RUNNING | O agente está trabalhando ativamente na tarefa |
COMPLETED | O agente terminou seu trabalho |
FAILED | O agente encontrou um erro |
CANCELLED | O agente foi cancelado |
Exemplos de Fluxo de Trabalho
Correção Automática de Relatórios de Bugs
Trigger: Chat Service (quando o usuário relata um bug)
Actions:
1. AI Request:
Prompt: "Extrair o nome do repositório e a descrição do bug"
Input: {{message}}
2. Cursor Launch Agent:
Repository: {{repository}}
Task: "Corrigir este bug: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Iniciei um agente de codificação. Avisarei quando a PR estiver pronta."
Iniciar e Monitorar
Trigger: Conversation Tool
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: {{user_instruction}}
Auto-create PR: true
2. Cursor Get Agent Status:
Agent ID: {{agentId}}
3. Send Message:
Text: "Status do agente: {{status}}. PR: {{prUrl}}"
Agente Iterativo com Acompanhamento
Trigger: Conversation Tool
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Implementar a funcionalidade inicial"
2. Cursor Add Followup:
Agent ID: {{agentId}}
Followup: "Adicione também testes unitários para a nova funcionalidade"
Configuração
- Vá para Integrações → Cursor Cloud Agents
- Configure sua chave de API (guia de configuração)
- Sincronize seus repositórios
- As ações do Cursor aparecem na Biblioteca de Nós do SmartFlow sob Conectores