Agentes

Inicie uma execução de agente

Inicia uma conversa de agente com escopo no workspace para o app Bubble especificado e enfileira imediatamente o prompt inicial.

POST /api/public/v1/agents
Token Bearer

Corpo

· CreateAgentRequest
obrigatório application/json

Configuração para criar a execução do agente.

appId string · min length: 1 obrigatório

ID do app Bubble do projeto do workspace que esta solicitação visa.

prompt string · min length: 1 obrigatório

Prompt do usuário a enviar ao modelo.

model ChatModelId · enumeração obrigatório

Identificador do modelo a usar na execução.

valores

  • claude-fable-5
  • claude-fable-5.1
  • claude-opus-5
  • claude-sonnet-5
  • openai-gpt-6-astra
  • openai-gpt-5.6-sol
reasoningEffort string · enumeração

Esforço de raciocínio solicitado para o modelo selecionado.

valores

  • none
  • low
  • medium
  • high
serviceTier string · enumeração

Velocidade solicitada para o modelo selecionado. Fast está disponível para modelos Codex e Cursor compatíveis.

valores

  • default
  • fast
permission string · enumeração

Se a execução pode apenas inspecionar o app ou também tem permissão para fazer edições.

valores

  • read_only
  • allow_edits
permittedBranches array of string · max items: 50

Branches que a execução pode acessar quando houver restrições de branch.

completionWebhookUrl string · uri

URL do webhook que o Buildprint chamará quando a execução for concluída.

Respostas