ListChatMessages - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Obtiene el historial de mensajes y las URL de descarga temporal para la instantánea del pipeline de una sesión especificada mediante su ID de sesión.

Descripción de la operación

Descripción de la solicitud

Al llamar al servicio V2, establezca el parámetro AgentVersion en V2.
Esta operación solo acepta el SessionId de la sesión del usuario actual. No devuelve directamente una matriz de mensajes, sino que devuelve URL de descarga prefirmadas para session.jsonl y a2a-snapshot.json.
Las URL de descarga son válidas durante 1,800 segundos (30 minutos). Complete la descarga dentro del período de validez.
Las URL en la respuesta contienen parámetros de firma. No las registre, comparta ni almacene en caché durante mucho tiempo.
MaxResults y NextToken son campos de compatibilidad y no se consumen en V2.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ros:ListChatMessages

list

*Todos los recursos.

*

Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
SessionId	string	Sí	El ID de la sesión a consultar. Solo puede consultar sesiones propiedad del usuario actual. Puede llamar a ListChatSessions para obtener un ID de sesión existente, o llamar a StartChat para crear una nueva sesión y obtener el ID de sesión.	7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012
MaxResults	integer	No	El campo de compatibilidad. V2 no devuelve matrices de mensajes por página, y el servicio no consume este campo.	20
NextToken	string	No	El campo de compatibilidad. V2 no devuelve matrices de mensajes por página, y el servicio no consume este campo.	CAES...
AgentVersion	string	No	Establezca este parámetro en V2 para enrutar la solicitud al backend de ROS Agent V2.	V2

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
HistoryReadiness	string	El estado de preparación de los mensajes del historial de la sesión. El historial solo se puede cargar cuando el estado es READY. El historial no se puede cargar cuando el estado es STARTING, RUNNING, STOPPING o FINALIZING (en procesamiento), NOT_READY (no listo), RECOVERY_REQUIRED (recuperación requerida) o UNKNOWN (desconocido).	READY
MaxResults	integer	El campo de compatibilidad. La respuesta de V2 no devuelve MaxResults.	20
Messages	array<object>	El campo de compatibilidad. La respuesta de V2 no devuelve una matriz de mensajes.	[]
	object	El campo de compatibilidad. V2 no devuelve objetos de mensaje.	{}
NextToken	string	El campo de compatibilidad. La respuesta de V2 no devuelve NextToken.	CAES...
PipelineName	string	El nombre del pipeline. Valores válidos: EvaluationFirstSelling y SolutionFirstSelling.	SolutionFirstSelling
PipelineSnapshotDownloadUrl	string	La URL de descarga prefirmada para el archivo a2a-snapshot.json del pipeline. La URL es válida durante 1,800 segundos.	https://oss.example/a2a-snapshot.json?signature=REDACTED
RequestId	string	El ID de la solicitud de OpenAPI.	4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2
SessionMessagesDownloadUrl	string	La URL de descarga prefirmada para el archivo session.jsonl de los mensajes de la sesión. La URL es válida durante 1,800 segundos.	https://oss.example/session.jsonl?signature=REDACTED
Title	string	El título de la sesión. Este campo puede estar vacío.	Create VPC template
Workspace	object	Los datos del espacio de trabajo de la sesión.	{}
WorkspaceTemplates	array<object>	La lista de plantillas de ROS en el espacio de trabajo de la sesión. Este campo solo se devuelve para el flujo solution-first. Si no existen plantillas publicadas, este campo no se devuelve o se devuelve una matriz vacía.
	object	La ruta, el estado de disponibilidad y la URL de descarga temporal de una sola plantilla de ROS.
DownloadUrl	string	La URL de descarga temporal del archivo de plantilla. Este campo solo se devuelve cuando Status es available. La URL es válida durante 300 segundos. Una vez que la URL caduca, debe llamar a la operación nuevamente para obtener una nueva URL.	https://example.com/templates/0-vpc.yml?expires=300
Status	string	El estado de disponibilidad de descarga de la plantilla. Valores válidos: available: La plantilla está lista y se puede descargar. También se devuelve DownloadUrl. not_ready: La ruta de la plantilla está determinada, pero el archivo no está listo. Inténtelo de nuevo más tarde. unavailable: La plantilla no se puede descargar. Por ejemplo, el archivo es demasiado grande o no se puede generar la URL de descarga temporal.	available
TemplatePath	string	La ruta relativa de la plantilla en el espacio de trabajo de la sesión. Se admiten los formatos .yml, .yaml y .json.	templates/0-vpc.yml

Ejemplos

Respuesta exitosa

JSON Formato

{
  "HistoryReadiness": "READY",
  "MaxResults": 20,
  "Messages": [
    {}
  ],
  "NextToken": "CAES...",
  "PipelineName": "SolutionFirstSelling",
  "PipelineSnapshotDownloadUrl": "https://oss.example/a2a-snapshot.json?signature=REDACTED",
  "RequestId": "4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2",
  "SessionMessagesDownloadUrl": "https://oss.example/session.jsonl?signature=REDACTED",
  "Title": "Create VPC template",
  "Workspace": {},
  "WorkspaceTemplates": [
    {
      "DownloadUrl": "https://example.com/templates/0-vpc.yml?expires=300",
      "Status": "available",
      "TemplatePath": "templates/0-vpc.yml"
    }
  ]
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.