CreateChat - STAROps: Central de Documentação do Alibaba Cloud

Inicia uma nova conversa.

Descrição da operação

Inicia uma sessão.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

starops:CreateChat

none

*DigitalEmployee

acs:starops:{#regionId}:{#accountId}:digitalemployee/{#name}

Nenhuma

Sintaxe da solicitação

POST /chat HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	O corpo da solicitação.
digitalEmployeeName	string	Não	O nome do funcionário digital.	test
threadId	string	Não	O ID do thread da sessão.	thread_id01
action	string	Não	O tipo de operação. Valores válidos: create (padrão), reconnect e stop.	create
variables	object	Não	O conjunto de variáveis.	{ "workspace": "test", "region": "cn-beijing", "project": "test", "language": "zh", "timeZone": "Asia/Shanghai", "timeStamp": "1768893948", "startTime": 1768887171, "endTime": 1768890771, "skill": "trace" }
messages	array<object>	Não	A lista de mensagens.
	array<object>	Não	Uma mensagem.
messageId	string	Não	Um identificador exclusivo para a mensagem.	message_id02
role	string	Não	A função da mensagem.	system
contents	array<object>	Não	O conteúdo multimodal da mensagem.
	object	Não	Um bloco de conteúdo multimodal.
type	string	Não	The content type.	text
value	string	Não	The value of the content.	test
tools	array<object>	Não	A lista de chamadas de ferramenta.
	object	Não	Uma chamada de ferramenta.	{ "arguments": { "confidence": "high", "intent": "analyser", "is_new_turn": true, "language": "en", "title": "Root Cause of Alert" }, "id": "IntentRecognition", }

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema da resposta.
messages	array<object>	Uma lista de objetos de mensagem na sessão.
	array<object>	A estrutura detalhada de um objeto de mensagem.
version	string	A versão da mensagem.	v0.1.0
parentCallId	string	O ID da chamada pai.	sess_abc123
callId	string	O ID da chamada atual.	call_search_001
role	string	A função do remetente da mensagem.	tool
seq	integer	O número de sequência da mensagem.	1
timestamp	string	O timestamp, em nanossegundos.	1765000005
type	string	O tipo de mensagem.	done
detail	string	Os detalhes da mensagem.	test
contents	array<object>	Uma lista de objetos de conteúdo.
	object	A estrutura detalhada de um objeto de conteúdo.	{ "append": false, "lastChunk": false, "type": "text", "value": "result output chunk" }
tools	array<object>	Uma lista de chamadas de ferramenta.
	object	A estrutura detalhada de uma chamada de ferramenta.	{ "arguments": { "confidence": "high", "intent": "analyser", "is_new_turn": true, "language": "en", "title": "Root Cause of Alert" }, "id": "IntentRecognition", "name": "IntentRecognition", "status": "start", "toolCallId": "019bc1cb-adad" }
agents	array<object>	Uma lista de agentes invocados.
	object	A estrutura detalhada de um agente invocado.	{ "callId": "019bc1cb-adad", "id": "analyser", "inputs": [ { "append": false, "lastChunk": false, "type": "text", "value": "Analyze this trace: TraceID=xxx" } ], "name": "analyser", "status": "start" }
events	array<object>	Uma lista de eventos.
	object	A estrutura detalhada de um evento.	{ "payload": { "error": { "code": "TASK_FAILED", "message": "Invalid task parameter", "suggestion": "" }, "statistics": { "duration": 300000 }, "success": false }, "type": "task_finished" }
artifacts	array<object>	Uma lista de artefatos gerados.
	object	A estrutura detalhada de um artefato.	{ "artifactId": "019bc1cb-9600-703axxx", "name": "sql output", "description": "sql generation task result", "extensions": ["sql_generation_tool", "sql_diagnosis"], "metadata": { "model": "qwen3-coder-plus" }, "parts": [ { "text": "select * from table", "kind": "text" } ] }
traceId	string	Identifica exclusivamente a cadeia de solicitações para rastreamento.	21504600000008405622576e3b48
requestId	string	Um identificador exclusivo para a solicitação de API, útil para solução de problemas.	0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0

Exemplos

Resposta de sucesso

JSON formato

{
  "messages": [
    {
      "version": "v0.1.0",
      "parentCallId": "sess_abc123",
      "callId": "call_search_001",
      "role": "tool",
      "seq": 1,
      "timestamp": "1765000005",
      "type": "done",
      "detail": "test",
      "contents": [
        {
          "append": false,
          "lastChunk": false,
          "type": "text",
          "value": "result output chunk"
        }
      ],
      "tools": [
        {
          "arguments": {
            "confidence": "high",
            "intent": "analyser",
            "is_new_turn": true,
            "language": "en",
            "title": "Root Cause of Alert"
          },
          "id": "IntentRecognition",
          "name": "IntentRecognition",
          "status": "start",
          "toolCallId": "019bc1cb-adad"
        }
      ],
      "agents": [
        {
          "callId": "019bc1cb-adad",
          "id": "analyser",
          "inputs": [
            {
              "append": false,
              "lastChunk": false,
              "type": "text",
              "value": "Analyze this trace: TraceID=xxx"
            }
          ],
          "name": "analyser",
          "status": "start"
        }
      ],
      "events": [
        {
          "payload": {
            "error": {
              "code": "TASK_FAILED",
              "message": "Invalid task parameter",
              "suggestion": ""
            },
            "statistics": {
              "duration": 300000
            },
            "success": false
          },
          "type": "task_finished"
        }
      ],
      "artifacts": [
        {
          "artifactId": "019bc1cb-9600-703axxx",
          "name": "sql output",
          "description": "sql generation task result",
          "extensions": [
            "sql_generation_tool",
            "sql_diagnosis"
          ],
          "metadata": {
            "model": "qwen3-coder-plus"
          },
          "parts": [
            {
              "text": "select * from table",
              "kind": "text"
            }
          ]
        }
      ]
    }
  ],
  "traceId": "21504600000008405622576e3b48",
  "requestId": "0CEC5375-XXXX-XXXX-XXXX-9A629907C1F0"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.