Agentes de Nuvem Cursor
Conecte o AI SmartTalk com Agentes de Nuvem Cursor para lançar assistentes de codificação autônomos de IA diretamente de suas conversas ou fluxos de trabalho. Os Agentes de Nuvem Cursor podem ler repositórios, gerar código, criar commits e abrir pull requests automaticamente.
Visão Geral
A integração dos Agentes de Nuvem Cursor permite que você:
- Lance agentes de codificação de IA em seus repositórios do GitHub
- Automatize a geração de código através de instruções em linguagem natural
- Crie pull requests automaticamente quando as tarefas estiverem completas
- Monitore o progresso do agente e veja o histórico de conversas
- Adicione instruções de acompanhamento a agentes em execução
- Acione tarefas de codificação a partir de fluxos de trabalho do SmartFlow
Pré-requisitos
Antes de começar, certifique-se de que você possui:
- Uma conta ativa no AI SmartTalk
- Uma conta Cursor com acesso aos Agentes de Nuvem
- Uma chave de API do Cursor (obtida no seu painel do Cursor)
- Repositórios do GitHub acessíveis a partir da sua conta do Cursor
Configuração Passo a Passo
Passo 1: Obtenha sua Chave de API do Cursor
- Vá para o seu painel de Agentes de Nuvem Cursor
- Navegue até suas configurações de API
- Gere uma nova chave de API para o AI SmartTalk
- Copie a chave de API
Passo 2: Acesse a Integração do Cursor
- Faça login na sua conta do AI SmartTalk
- Navegue até Administração → Meus Assistentes → [Seu Nome de Assistente]
- Clique em Conectores na barra lateral esquerda
- Localize Agentes de Nuvem Cursor e clique nele
Passo 3: Configure a Conexão
- Clique em Configuração de Setup
- Insira sua Chave de API do Cursor
- Clique em Salvar Configuração
- O AI SmartTalk valida sua chave de API automaticamente
Passo 4: Sincronize Repositórios
Uma vez conectado, o AI SmartTalk sincroniza automaticamente os repositórios do GitHub acessíveis a partir da sua conta do Cursor. Você também pode atualizar manualmente a lista de repositórios a qualquer momento.
Painel
Uma vez conectado, o painel de integração do Cursor fornece uma visão completa:
Visão Geral das Estatísticas
| Métrica | Descrição |
|---|---|
| Total de Agentes | Número de agentes lançados |
| Em Execução | Agentes atualmente ativos |
| Finalizados | Agentes concluídos |
| Modelos Disponíveis | Modelos de IA disponíveis para agentes |
Assistentes Recentes
O painel lista seus agentes mais recentes com:
- ID do Agente para referência
- Status: Em Execução, Concluído, Falhou, Criando ou Cancelado
- Repositório em que o agente está trabalhando
- Data de Criação
- Ações rápidas: Ver Detalhes e Ver PR
O painel atualiza automaticamente a cada 30 segundos quando os agentes estão em execução.
Lançando um Agente
A partir do Painel
- Clique em Lançar Novo Assistente
- Preencha o formulário de lançamento:
| Campo | Necessário | Descrição |
|---|---|---|
| Repositório | Sim | Selecione um repositório do GitHub no dropdown |
| Descrição da Tarefa | Sim | Descreva o que o agente deve fazer em linguagem natural |
| Branch | Não | Branch do Git para trabalhar (padrão: main) |
| Modelo de IA | Não | Selecione um modelo de IA específico para o agente |
| Criar PR automaticamente | Não | Criar automaticamente um pull request quando concluído (padrão: habilitado) |
| Nome da Branch | Não | Nome da branch personalizada para o pull request |
- Clique em Lançar Agente
Exemplos de Descrição de Tarefa
- "Adicionar testes unitários para o módulo de autenticação"
- "Refatorar o pool de conexão do banco de dados para usar reciclagem de conexões"
- "Corrigir o bug onde as sessões de usuário expiram prematuramente em dispositivos móveis"
- "Adicionar definições de tipo TypeScript para todos os objetos de resposta da API"
- "Criar um endpoint de API REST para preferências do usuário"
Gerenciando Agentes
Ver Detalhes do Agente
Clique em Ver Detalhes em qualquer agente para ver:
Aba de Visão Geral:
- ID do Agente e status atual
- Informações sobre repositório e branch
- Link do pull request (se criado)
- Resumo do trabalho realizado
- Timestamp de criação
Aba de Conversa:
- Histórico completo de mensagens do trabalho do agente
- Instruções do usuário e respostas da IA
- Registro de progresso passo a passo
Adicionar Instruções de Acompanhamento
Você pode enviar instruções adicionais a um agente em execução:
- Abra os detalhes do agente
- Insira sua instrução de acompanhamento (por exemplo, "Adicione também tratamento de erros para o caso extremo quando o usuário não for encontrado")
- O agente continua seu trabalho com o novo contexto
Excluir um Agente
Para limpar recursos:
- Clique na ação de exclusão no cartão do agente
- Confirme a exclusão
- O agente e seus recursos são removidos
Integração SmartFlow
Os Agentes de Nuvem Cursor podem ser usados como ações em fluxos de trabalho do SmartFlow, permitindo cenários de automação poderosos.
Ações Disponíveis do SmartFlow
| Ação | Descrição |
|---|---|
| Lançar Agente de Codificação | Iniciar um agente em um repositório com instruções específicas |
| Adicionar Acompanhamento | Enviar instruções adicionais a um agente em execução |
| Obter Status do Agente | Verificar o progresso e status de um agente |
| Excluir Agente | Remover um agente e limpar recursos |
Exemplo: Correção Automática em Relatório de Bug
Trigger: Chat Service (quando o usuário relata um bug)
Actions:
1. AI Request:
Prompt: Extrair a descrição do bug e o repositório afetado
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Corrigir este bug: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Lancei um agente de codificação para corrigir isso. Avisarei quando o PR estiver pronto."
4. Wait / Poll:
Check Agent Status periodically
5. Send Message:
Text: "A correção está pronta! Revise o PR aqui: {{pr_url}}"
Exemplo: Melhorias de Código Agendadas
Trigger: Scheduled Workflow (semanal)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Revisar e atualizar todas as dependências obsoletas"
Branch: chore/update-deps
Auto-create PR: true
Para parâmetros detalhados das ações do SmartFlow, veja Ações do SmartFlow Cursor.
Casos de Uso
Bot de Suporte ao Desenvolvedor
Permita que os usuários solicitem alterações de código através do chat:
- "Você pode adicionar validação de entrada ao formulário de inscrição?"
- "Por favor, crie um script de migração para os novos campos de usuário"
Correção Automática de Bugs
Acione agentes de codificação a partir de relatórios de bugs ou alertas de monitoramento para gerar automaticamente PRs de correção.
Automação de Revisão de Código
Lance agentes para revisar código, adicionar testes ou melhorar a documentação com base no feedback do PR.
Manutenção Agendada
Configure fluxos de trabalho recorrentes para atualizar dependências, executar correções de linting ou gerar relatórios.
Solução de Problemas
| Problema | Solução |
|---|---|
| "Chave de API inválida" | Regere sua chave de API a partir do painel do Cursor |
| "Repositório não encontrado" | Clique em Atualizar para re-sincronizar repositórios. Certifique-se de que o repositório é acessível a partir da sua conta do Cursor |
| Agente preso em "Criando" | O agente pode estar na fila. Aguarde alguns minutos e verifique o status novamente |
| Agente falhou | Abra os detalhes do agente para ver a conversa e mensagens de erro |
| PR não criado | Verifique se a criação automática de PR estava habilitada e se o agente foi concluído com sucesso |
| Nenhum repositório disponível | Certifique-se de que sua conta do Cursor tenha repositórios do GitHub conectados |
Gerenciando a Integração
| Ação | Como |
|---|---|
| Conectar | Insira a chave de API na configuração da integração |
| Ver painel | Abra a página de integração do Cursor |
| Sincronizar repositórios | Clique em Atualizar para atualizar a lista de repositórios |
| Desconectar | Remova a chave de API da configuração |
Melhores Práticas
- Escreva descrições de tarefas claras: Quanto mais específicas forem suas instruções, melhor será a saída do agente.
- Use branches apropriadas: Não lance agentes diretamente no
main— deixe-os criar PRs para revisão. - Ative a criação automática de PR: Facilita a revisão e a fusão do trabalho do agente.
- Monitore agentes em execução: Verifique o painel regularmente ou configure notificações do SmartFlow.
- Revise antes de mesclar: Sempre revise PRs gerados por agentes antes de mesclar na produção.
- Comece pequeno: Comece com tarefas bem definidas antes de tentar grandes refatorações.