Cursor

Cursor é uma plataforma inteligente baseada em nuvem que permite iniciar e gerenciar agentes de IA capazes de colaborar nos seus repositórios do GitHub. Os agentes do Cursor foram criados para ajudar a automatizar fluxos de desenvolvimento de software, acelerar mudanças de código e oferecer assistência poderosa diretamente no seu stack de controle de versão.

Com o Cursor, você pode:

  • Iniciar agentes em nuvem: Comece imediatamente agentes de IA para executar tarefas nos seus repositórios — da geração e refatoração de código à documentação e correção de bugs.
  • Colaborar em pull requests e branches: Os agentes podem trabalhar em feature branches, propor mudanças e ajudar em code reviews.
  • Orientar e refinar o trabalho da IA: Envie instruções de follow-up aos agentes, permitindo direcionar de forma iterativa suas ações e resultados.
  • Monitorar progresso e resultados: Verifique o status do agente, revise a saída e inspecione threads de conversa — tudo em um dashboard unificado ou via API.
  • Controlar o ciclo de vida do agente: Inicie, pare, reinicie ou arquive agentes conforme necessário para gerenciar recursos de computação e estados do fluxo.
  • Integrar ao seu fluxo de trabalho: Use a API para conectar agentes do Cursor a pipelines de CI/CD, chatbots ou ferramentas internas para automações.

Integrar o Cursor às suas automações no Zoen libera o poder da assistência de IA nos seus projetos de software. Deixe os agentes contribuírem com código, resolverem issues e concluírem tarefas repetitivas de desenvolvimento para que você e sua equipe foquem em trabalho de engenharia de mais alto nível.

Usage Instructions

Interact with Cursor Cloud Agents API to launch AI agents that can work on your GitHub repositories. Supports launching agents, adding follow-up instructions, checking status, viewing conversations, and managing agent lifecycle.

Actions

cursor_list_agents

List all cloud agents for the authenticated user with optional pagination. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
limitnumberNoNumber of agents to return (default: 20, max: 100)
cursorstringNoPagination cursor from previous response
prUrlstringNoFilter agents by pull request URL

Output

ParameterTypeDescription
agentsarrayArray of agent objects
nextCursorstringPagination cursor for next page

cursor_get_agent

Retrieve the current status and results of a cloud agent. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
idstringAgent ID
namestringAgent name
statusstringAgent status
sourcejsonSource repository info
targetjsonTarget branch/PR info
summarystringAgent summary
createdAtstringCreation timestamp

cursor_get_conversation

Retrieve the conversation history of a cloud agent, including all user prompts and assistant responses. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
idstringAgent ID
messagesarrayArray of conversation messages

cursor_launch_agent

Start a new cloud agent to work on a GitHub repository with the given instructions. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
repositorystringYesGitHub repository URL (e.g., https://github.com/your-org/your-repo\)
refstringNoBranch, tag, or commit to work from (defaults to default branch)
promptTextstringYesThe instruction text for the agent
promptImagesstringNoJSON array of image objects with base64 data and dimensions
modelstringNoModel to use (leave empty for auto-selection)
branchNamestringNoCustom branch name for the agent to use
autoCreatePrbooleanNoAutomatically create a PR when the agent finishes
openAsCursorGithubAppbooleanNoOpen the PR as the Cursor GitHub App
skipReviewerRequestbooleanNoSkip requesting reviewers on the PR

Output

ParameterTypeDescription
idstringAgent ID
urlstringAgent URL

cursor_add_followup

Add a follow-up instruction to an existing cloud agent. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)
followupPromptTextstringYesThe follow-up instruction text for the agent
promptImagesstringNoJSON array of image objects with base64 data and dimensions (max 5)

Output

ParameterTypeDescription
idstringAgent ID

cursor_stop_agent

Stop a running cloud agent. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
idstringAgent ID

cursor_delete_agent

Permanently delete a cloud agent. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
idstringAgent ID

cursor_list_artifacts

List generated artifact files for a cloud agent. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)

Output

ParameterTypeDescription
artifactsarrayList of artifact files
pathstringArtifact file path
sizenumberFile size in bytes

cursor_download_artifact

Download a generated artifact file from a cloud agent. Returns the file for execution storage.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key
agentIdstringYesUnique identifier for the cloud agent (e.g., bc_abc123)
pathstringYesAbsolute path of the artifact to download (e.g., /src/index.ts)

Output

ParameterTypeDescription
filefileDownloaded artifact file stored in execution files

cursor_list_models

List the models available for launching cloud agents. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key

Output

ParameterTypeDescription
modelsarrayArray of available model names

cursor_list_repositories

List the GitHub repositories accessible to the authenticated user. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key

Output

ParameterTypeDescription
repositoriesarrayArray of accessible repositories
ownerstringRepository owner
namestringRepository name
repositorystringRepository URL

cursor_get_api_key_info

Retrieve details about the API key currently in use. Returns API-aligned fields only.

Input

ParameterTypeRequiredDescription
apiKeystringYesCursor API key

Output

ParameterTypeDescription
apiKeyNamestringName of the API key
createdAtstringAPI key creation timestamp
userEmailstringEmail of the key owner

On this page