Pular para o conteúdo principal

Conversas

Uma conversa representa uma execucao de agente com estado, eventos e sandbox.

Fluxo recomendado​

  1. Iniciar conversa via POST /api/v1/app-conversations.
  2. Acompanhar start task ate READY.
  3. Usar app_conversation_id para listar dados e eventos.

Iniciar conversa​

Endpoint:

POST /api/v1/app-conversations

Campos comuns de entrada:

  • title: titulo da conversa.
  • initial_message: primeira mensagem do usuario.
  • llm_model: modelo desejado (opcional).
  • selected_repository e selected_branch (opcionais).

Exemplo minimo:

{
  "title": "Analise de requisitos",
  "initial_message": {
    "role": "user",
    "content": [
      {"type": "text", "text": "Resuma os requisitos da historia #42"}
    ],
    "run": true
  }
}

Status do start task​

Estados possiveis:

  • WORKING
  • WAITING_FOR_SANDBOX
  • PREPARING_REPOSITORY
  • RUNNING_SETUP_SCRIPT
  • SETTING_UP_GIT_HOOKS
  • SETTING_UP_SKILLS
  • STARTING_CONVERSATION
  • READY
  • ERROR

Consulta por ids:

GET /api/v1/app-conversations/start-tasks?ids=<TASK_ID_1>&ids=<TASK_ID_2>

Obter metadados de conversa​

Consulta em lote por IDs:

GET /api/v1/app-conversations?ids=<CONVERSATION_ID>

A resposta inclui, entre outros campos:

  • sandbox_status
  • execution_status
  • conversation_url