Rechercher

Cette page présente les assistants de portée orientés développeur ainsi que le type concret de résultat de recherche Oracle.

Portées

classe oracleagentmemory.apis.scope.Scope

Bases : object

Représente une étendue pour l'insertion ou la recherche d'informations.

• Paramètres :
  • user_id str | None
  • agent_id str | None
  • thread_id str | None

ID utilisateur

ID d'utilisateur final. NOT_SET_MARKER signifie que le champ a été omis et doit être résolu par la valeur par défaut propre à l'opération. None explicite est conservé et interprété par les règles propres à l'opération. Les API client de niveau supérieur telles que OracleAgentMemory.search() peuvent nécessiter que la portée utilisateur soit explicite. Dans ces API, None ne peut être utilisé que pour cibler les enregistrements sans portée.

• Type : str | None

agent_id;

ID agent. NOT_SET_MARKER signifie que le champ a été omis et doit être résolu par la valeur par défaut propre à l'opération. None explicite est conservé et interprété par les règles propres à l'opération.

• Type : str | None

thread_id;

ID unité d'exécution. NOT_SET_MARKER signifie que le champ a été omis et doit être résolu par la valeur par défaut propre à l'opération. None explicite est conservé et interprété par les règles propres à l'opération.

• Type : str | None

classe oracleagentmemory.apis.searchscope.SearchScope

Bases : Scope

Représente la portée d'une interrogation de recherche et restreint donc ce qui peut être retourné.

• Paramètres :
  • user_id str | None
  • agent_id str | None
  • thread_id str | None
  • exact_user_match bool
  • exact_agent_match bool
  • exact_thread_match bool

ID utilisateur

ID d'utilisateur final. Lorsque la valeur exact_user_match résolue est True, cet ID correspond exactement, y compris None. Lorsqu'il s'agit de False, la dimension utilisateur n'est pas contrainte. NOT_SET_MARKER est remplacé par une valeur par défaut propre à l'opération. Les API client de niveau supérieur telles que OracleAgentMemory.search() peuvent nécessiter que la portée utilisateur soit explicite. Dans ces API, None cible uniquement les enregistrements sans portée lorsque exact_user_match se résout à True.

• Type : str | None

agent_id;

ID agent. Lorsque la valeur exact_agent_match résolue est True, cet ID correspond exactement, y compris None. Lorsqu'il s'agit de False, la dimension d'agent n'est pas contrainte. NOT_SET_MARKER est remplacé par une valeur par défaut selon l'opération utilisant la portée.

• Type : str | None

thread_id;

ID unité d'exécution. Lorsque la valeur exact_thread_match résolue est True, cet ID correspond exactement, y compris None. Lorsqu'il s'agit de False, la dimension d'unité d'exécution n'est pas contrainte. NOT_SET_MARKER est remplacé par une valeur par défaut selon l'opération utilisant la portée.

• Type : str | None

exact_user_match;

Indique si le user_id résolu doit correspondre exactement. True correspond exactement, y compris None. False laisse la dimension d'utilisateur sans contrainte. NOT_SET_MARKER est remplacé par une valeur par défaut selon l'opération. Les API client de niveau supérieur telles que OracleAgentMemory.search() peuvent nécessiter le maintien de True.

• Type : bool

exact_agent_match

Indique si le agent_id résolu doit correspondre exactement. True correspond exactement, y compris None. False laisse la dimension d'agent sans contrainte. NOT_SET_MARKER est remplacé par une valeur par défaut selon l'opération.

• Type : bool

exact_thread_match;

Indique si le thread_id résolu doit correspondre exactement. True correspond exactement, y compris None. False laisse la dimension d'unité d'exécution sans contrainte. NOT_SET_MARKER est remplacé par une valeur par défaut selon l'opération.

• Type : bool

résultats

classe oracleagentmemory.core.OracleSearchResult

Bases : SearchResult

Résultat de recherche retourné par une unité d'exécution Oracle.

• Paramètres :
  • distance float – Distance par rapport au vecteur d'interrogation (plus petite est préférable).
  • record Record – Objet d'enregistrement contenant les informations de métadonnées sur l'entrée persistante.
  • id str | None – Identificateur facultatif associé à l'enregistrement stocké.

biens content

• Type de retour : str
• Description : Retourne le contenu textuel principal de l'enregistrement mis en correspondance.

biens formatted_content

• Type de retour : str
• Description : Retourne le rendu XML par défaut utilisé dans les invites.

propriété id

• Type de retour : str

  Aucune

• Description : Retourne l'identificateur stable de l'enregistrement mis en correspondance, lorsqu'il est disponible.

biens metadata

• Type de retour : dict[str, Any]

  Aucune

• Description : Retourne les métadonnées d'enregistrement, si elles sont disponibles.

biens record

• Type de retour : Enregistrement
• Description : Retourne l'enregistrement mis en correspondance.

méthode render_formatted_content

Retourne une représentation structurée et sécurisée XML du contenu du résultat.

• Paramètres :
  • show_thread_id bool
  • show_distance bool
  • show_timestamp bool
  • show_role bool
  • show_user_id bool
  • show_agent_id bool
• Type de retour : str

biens timestamp

• Type de retour : str

  Aucune

• Description : Retourne l'horodatage de l'enregistrement, s'il est disponible.