Agentes

Iniciar a execução de um agente

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

POST /api/public/v1/agents

Iniciar a execução de um agente

curl --request POST \
  --url 'https://api.buildprint.ai/api/public/v1/agents' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "agentId": "<string>",
  "kind": "<string>",
  "status": "queued",
  "appId": "<string>",
  "projectId": "<string>",
  "createdAt": 1
}

Agente aceito

Authorizations

  • Authorization string obrigatório header

    Token da API REST do workspace prefixado com bp_

Request Body

application/json
  • appId string obrigatório

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

  • prompt string obrigatório

    Prompt do usuário para enviar ao modelo.

  • model string enum obrigatório enum

    Identificador do modelo a ser usado para a execução. 10 allowed enum values.

  • reasoningEffort string enum enum

    Esforço de raciocínio solicitado para o modelo selecionado. Allowed values: none, low, medium, high.

  • permission string enum enum

    Se a execução pode apenas inspecionar o app ou se também tem permissão para fazer edições. Allowed values: read_only, allow_edits.

  • permittedBranches[] string array

    Branches que a execução tem permissão para acessar quando restrições de branch se aplicam.

  • completionWebhookUrl string (uri)

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

  • userEmail string (email)

    E-mail do usuário Buildprint cujas credenciais do provedor devem ser usadas.

Response

application/json
  • agentId string

    Identificador opaco para a conversa do agente vinculada.

  • kind string

    Discriminador que descreve o tipo de objeto retornado.

  • status string enum enum

    Estado atual do ciclo de vida de alto nível para a execução assíncrona. Allowed values: queued, running, completed, error.

  • appId string

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

  • projectId string

    Identificador opaco para o projeto do workspace.

  • createdAt number

    Timestamp Unix em milissegundos de quando o recurso foi criado.