SearchMemories - PolarDB - Centro de documentación de Alibaba Cloud

Obtiene las memorias de una aplicación especificada.

Descripción de la operación

Obtiene los datos de memoria de una aplicación especificada.

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

polardb:SearchMemories

none

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ApplicationId	string	Sí	El ID de la aplicación. Ejemplo: pa-**************.	pa-**************
Query	string	No	La consulta de búsqueda.	¿Quién es usted?
MemoryUserId	string	Sí	El ID del usuario de memoria.	user1
MemoryAgentId	string	No	El ID del agente de memoria.	agent1
TopK	string	No	Especifica el número de resultados principales que se devolverán.	3
CreateTimeBegin	string	No	La hora de inicio de la creación de memorias.	yyyy-MM-ddTHH:mm:ssZ
CreateTimeEnd	string	No	La hora de finalización de la creación de memorias.	yyyy-MM-ddTHH:mm:ssZ
Page	integer	No	El número de página.
PageSize	integer	No	El número de registros por página.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El esquema de respuesta.
RequestId	string	El ID de la solicitud.	3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF
Results	array<object>	La lista de resultados.
	object	La lista de resultados.
Id	string	El ID de la memoria.	423
Memory	string	El contenido de la memoria.	xxx
Metadata	string	Los metadatos.	{\"tags\":\"Issue_date_2023-11-30,VD_现行有效\"}
Score	string	La puntuación.	12
CreateTime	string	La hora de creación. La hora está en formato ISO 8601 en UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2025-09-26T08:25:44Z
UpdateTime	string	La hora de actualización. La hora está en formato ISO 8601 en UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2025-10-16T02:27:33Z
MemoryUserId	string	El usuario al que pertenece la memoria.	user1
MemoryAgentId	string	El agente al que pertenece la memoria.	agent1
Total	string
Page	string
PageSize	string
TotalPages	string

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF",
  "Results": [
    {
      "Id": "423",
      "Memory": "xxx",
      "Metadata": "{\\\"tags\\\":\\\"Issue_date_2023-11-30,VD_现行有效\\\"}",
      "Score": "12",
      "CreateTime": "2025-09-26T08:25:44Z",
      "UpdateTime": "2025-10-16T02:27:33Z",
      "MemoryUserId": "user1",
      "MemoryAgentId": "agent1"
    }
  ],
  "Total": "",
  "Page": "",
  "PageSize": "",
  "TotalPages": ""
}

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.