Búsqueda

Esta página presenta los ayudantes de ámbito orientados al desarrollador junto con el tipo concreto de resultados de búsqueda de Oracle.

Ámbitos

clase oracleagentmemory.apis.scope.Scope

Bases: object

Representa un ámbito para la inserción o búsqueda de información.

• Parámetros:
  • ID_usuario str | None
  • agent_id str | None
  • thread_id str | None

user_id (ID de usuario)

ID del usuario final. NOT_SET_MARKER significa que el campo se ha omitido y se debe resolver mediante el valor por defecto específico de la operación. None explícito se conserva e interpreta mediante las reglas específicas de la operación. Las API de cliente de nivel superior, como OracleAgentMemory.search(), pueden requerir que el ámbito de usuario sea explícito. En esas API, None se puede utilizar solo para dirigir registros sin ámbito.

• Tipo: str | Ninguno

agent_id (ID de agente)

ID de Agente. NOT_SET_MARKER significa que el campo se ha omitido y se debe resolver mediante el valor por defecto específico de la operación. None explícito se conserva e interpreta mediante las reglas específicas de la operación.

• Tipo: str | Ninguno

ID_subproceso

Identificador de Thread. NOT_SET_MARKER significa que el campo se ha omitido y se debe resolver mediante el valor por defecto específico de la operación. None explícito se conserva e interpreta mediante las reglas específicas de la operación.

• Tipo: str | Ninguno

clase oracleagentmemory.apis.searchscope.SearchScope

Bases: Scope

Representa el ámbito de una consulta de búsqueda y, por lo tanto, restringe lo que se puede devolver.

• Parámetros:
  • ID_usuario str | None
  • agent_id str | None
  • thread_id str | None
  • exact_user_match bool
  • exact_agent_match bool
  • exact_thread_match bool

user_id (ID de usuario)

ID del usuario final. Cuando el valor exact_user_match resuelto es True, este ID coincide exactamente, incluido None. Cuando es False, la dimensión de usuario no tiene restricciones. NOT_SET_MARKER se sustituye por un valor por defecto específico de la operación. Las API de cliente de nivel superior, como OracleAgentMemory.search(), pueden requerir que el ámbito de usuario sea explícito. En esas API, None solo tiene como destino registros sin ámbito cuando exact_user_match se resuelve en True.

• Tipo: str | Ninguno

agent_id (ID de agente)

ID de Agente. Cuando el valor exact_agent_match resuelto es True, este ID coincide exactamente, incluido None. Cuando es False, la dimensión de agente no tiene restricciones. NOT_SET_MARKER se sustituye por un valor por defecto según la operación que utilice el ámbito.

• Tipo: str | Ninguno

ID_subproceso

Identificador de Thread. Cuando el valor exact_thread_match resuelto es True, este ID coincide exactamente, incluido None. Cuando es False, la dimensión de thread no tiene restricciones. NOT_SET_MARKER se sustituye por un valor por defecto según la operación que utilice el ámbito.

• Tipo: str | Ninguno

exact_user_match

Si coincide exactamente con el user_id resuelto. True coincide exactamente, incluido None. False deja la dimensión de usuario sin restricciones. NOT_SET_MARKER se sustituye por un valor por defecto según la operación. Las API de cliente de nivel superior, como OracleAgentMemory.search(), pueden necesitar que esto siga siendo True.

• Tipo: bool

exacto_agente_coincidencia

Si coincide exactamente con el agent_id resuelto. True coincide exactamente, incluido None. False deja la dimensión de agente sin restricciones. NOT_SET_MARKER se sustituye por un valor por defecto según la operación.

• Tipo: bool

exact_thread_match

Si coincide exactamente con el thread_id resuelto. True coincide exactamente, incluido None. False deja la dimensión de thread sin restricciones. NOT_SET_MARKER se sustituye por un valor por defecto según la operación.

• Tipo: bool

Resultados

clase oracleagentmemory.core.OracleSearchResult

Bases: SearchResult

Resultado de búsqueda devuelto por un thread de Oracle.

• Parámetros:
  • distance float: distancia del vector de consulta (más pequeño es mejor).
  • record Record: objeto de registro que contiene la información de metadatos sobre la entrada guardada.
  • id str | None: identificador opcional asociado con el registro almacenado.

propiedad content

• Tipo de devolución: str
• Descripción: devuelve el contenido textual principal del registro coincidente.

propiedad formatted_content

• Tipo de devolución: str
• Descripción: devuelve la representación segura de XML por defecto utilizada en las peticiones de datos.

propiedad id

• Tipo de devolución: str

  ninguno

• Descripción: devuelve el identificador estable del registro coincidente, cuando esté disponible.

propiedad metadata

• Tipo de devolución: dict[str, Any]

  ninguno

• Descripción: devuelve los metadatos del registro, si están disponibles.

propiedad record

• Tipo de valor devuelto: Registro
• Descripción: devuelve el registro coincidente.

método render_formatted_content

Devolver una representación estructurada y segura en XML del contenido del resultado.

• Parámetros:
  • show_thread_id bool
  • show_distance bool
  • show_timestamp bool
  • show_role bool
  • show_user_id bool
  • show_agent_id bool
• Tipo de devolución: str

propiedad timestamp

• Tipo de devolución: str

  ninguno

• Descripción: devuelve el registro de hora, si está disponible.