Agentes

Enviar uma mensagem de acompanhamento para uma conversa de agente existente

Anexa um prompt de acompanhamento a uma execução de agente existente criada via REST e pode atualizar a permissão de edição ou o escopo da branch da execução.

POST /api/public/v1/agents/{agentId}/messages

Enviar uma mensagem de acompanhamento para uma conversa de agente existente

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

Acompanhamento aceito

Authorizations

  • Authorization string obrigatório header

    Token da API REST do workspace prefixado com bp_

Path Parameters

  • agentId string obrigatório

    Identificador da conversa do agente a ser continuada.

Request Body

application/json
  • prompt string obrigatório

    Prompt do usuário para enviar ao modelo.

  • 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.

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.