Simple Log Service:CreateChat

Antes de começar

• Você deve primeiro criar um DataAgent e obter o ID do thread de sessão chamando CreateThread.

Resposta de streaming

• Esta operação é uma operação de streaming. O Content-Type da resposta é text/event-stream. Após o código de status HTTP 200 ser retornado, os eventos são continuamente enviados por push até que um evento com o tipo stream_done seja recebido.

• O campo data de cada evento é um documento JSON independente, e não uma substituição para toda a resposta. Processe os eventos na ordem de chegada: as respostas de texto são fornecidas como fragmentos incrementais, e os processos de execução de ferramentas e subagentes são fornecidos como eventos de mensagem separados.

Duas formas de falhas

• Se ocorrer uma falha antes da chegada do primeiro evento, uma resposta de falha JSON padrão será retornada com o código de status HTTP correspondente.

• Se ocorrer uma falha durante o procedimento de saída de streaming, um evento chamado error será recebido. O campo data deste evento contém um campo error, e o código de status HTTP permanece 200. O cliente deve realizar o processamento simultâneo para ambos os cenários.

Três usos de action

• create (padrão): Inicia uma nova rodada de conversa com mensagens.

• reconnect: Reconecta-se a uma conversa não concluída no thread atual sem mensagens para continuar recebendo a saída.

• stop: Encerra a geração de resposta em andamento.

Cenários que requerem entrada adicional

• Quando o agente exige que você confirme ou complemente informações, um evento com o tipo interactive é enviado por push. Após concluir a interação no lado do cliente, continue a sessão enviando uma solicitação com action definido como create e incluindo os resultados da interação.

Inicia uma nova rodada de conversa:

{
  "name": "my-agent",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "action": "create",
  "messages": [
    {
      "role": "user",
      "contents": [
        { "type": "text", "value": "Count the top 10 URLs with the highest number of requests in the nginx-access-log over the last hour" }
      ]
    }
  ],
  "variables": {
    "region": "cn-hangzhou",
    "project": "nginx-demo",
    "language": "zh"
  }
}

Encerra a geração de resposta em andamento (messages não é obrigatório):

{
  "name": "my-agent",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "action": "stop"
}

A resposta é enviada por push por eventos. Cada evento consiste em event, id e data. O campo data é um documento JSON completo:

event: message
id: 1
data: {"messages":[{"parentCallId":"","callId":"thread-t709p8-s24hgl7ug8jw","role":"assistant","seq":4,"timestamp":"1765289004","contents":[{"type":"text","value":"Analyzing...","append":true}]}],"traceId":"88b50db22437400fa9c16c5399722310"}

Concatene os campos value com o tipo text na mesma mensagem na ordem de chegada para obter o texto completo da resposta. O conteúdo com o tipo spin_text representa os prompts de pensamento e processo de execução do agente e não precisa ser exibido como o texto principal. Quando a tarefa terminar, você receberá sequencialmente eventos com o tipo task_finished (o payload contém success) e stream_done.