Cerca

Questa pagina presenta gli strumenti di supporto per l'ambito rivolti agli sviluppatori insieme al tipo di risultati di ricerca Oracle concreto.

Ambiti

classe oracleagentmemory.apis.scope.Scope

Basi: object

Rappresenta un ambito per l'inserimento o le ricerche di informazioni.

• Parametri:
  • ID_utente str | None
  • id_agente str | None
  • id_thread str | None

ID_utente

ID dell'utente finale. NOT_SET_MARKER indica che il campo è stato omesso e deve essere risolto in base all'impostazione predefinita specifica dell'operazione. L'espressione None esplicita viene conservata e interpretata dalle regole specifiche dell'operazione. Le API client di livello superiore, ad esempio OracleAgentMemory.search(), possono richiedere che l'ambito utente sia esplicito. In tali API, è possibile utilizzare None per indirizzare solo record con ambito non definito.

• Tipo: str | None

ID_agente

ID agente. NOT_SET_MARKER indica che il campo è stato omesso e deve essere risolto in base all'impostazione predefinita specifica dell'operazione. L'espressione None esplicita viene conservata e interpretata dalle regole specifiche dell'operazione.

• Tipo: str | None

ID_thread

ID thread. NOT_SET_MARKER indica che il campo è stato omesso e deve essere risolto in base all'impostazione predefinita specifica dell'operazione. L'espressione None esplicita viene conservata e interpretata dalle regole specifiche dell'operazione.

• Tipo: str | None

classe oracleagentmemory.apis.searchscope.SearchScope

Basi: Scope

Rappresenta l'ambito di una query di ricerca e quindi limita gli elementi che possono essere restituiti.

• Parametri:
  • ID_utente str | None
  • id_agente str | None
  • id_thread str | None
  • exact_user_match bool
  • exact_agent_match bool
  • corrispondenza_thread_exact bool

ID_utente

ID dell'utente finale. Quando il valore exact_user_match risolto è True, viene trovata una corrispondenza esatta con questo ID, incluso None. Quando si tratta di False, la dimensione utente non è vincolata. NOT_SET_MARKER viene sostituito da un valore predefinito specifico dell'operazione. Le API client di livello superiore, ad esempio OracleAgentMemory.search(), possono richiedere che l'ambito utente sia esplicito. In tali API, None è destinato solo ai record con ambito non definito quando exact_user_match viene risolto in True.

• Tipo: str | None

ID_agente

ID agente. Quando il valore exact_agent_match risolto è True, viene trovata una corrispondenza esatta con questo ID, incluso None. Quando si tratta di False, la dimensione agente non è vincolata. NOT_SET_MARKER viene sostituito da un valore predefinito a seconda dell'operazione che utilizza l'ambito.

• Tipo: str | None

ID_thread

ID thread. Quando il valore exact_thread_match risolto è True, viene trovata una corrispondenza esatta con questo ID, incluso None. Quando è False, la dimensione thread non è vincolata. NOT_SET_MARKER viene sostituito da un valore predefinito a seconda dell'operazione che utilizza l'ambito.

• Tipo: str | None

esatta_utente_corrispondenza

Indica se corrispondere esattamente al valore user_id risolto. True corrisponde esattamente, incluso None. False lascia la dimensione utente non vincolata. NOT_SET_MARKER viene sostituito da un valore predefinito a seconda dell'operazione. Le API client di livello superiore come OracleAgentMemory.search() potrebbero richiedere che rimangano True.

• Tipo: bolla

esatta_agente_corrispondenza

Indica se corrispondere esattamente al valore agent_id risolto. True corrisponde esattamente, incluso None. False lascia la dimensione agente non vincolata. NOT_SET_MARKER viene sostituito da un valore predefinito a seconda dell'operazione.

• Tipo: bolla

corrispondenza esatta_thread_

Indica se corrispondere esattamente al valore thread_id risolto. True corrisponde esattamente, incluso None. False lascia la dimensione thread non vincolata. NOT_SET_MARKER viene sostituito da un valore predefinito a seconda dell'operazione.

• Tipo: bolla

Risultati

classe oracleagentmemory.core.OracleSearchResult

Basi: SearchResult

Risultato della ricerca restituito da un thread Oracle.

• Parametri:
  • distance float: la distanza dal vettore di query (più piccolo è meglio).
  • record Record: oggetto record contenente le informazioni sui metadati relative alla voce persistente.
  • id str | None: identificativo facoltativo associato al record memorizzato.

proprietà content

• Tipo restituito: str
• Descrizione: restituisce il contenuto testuale principale per il record corrispondente.

proprietà formatted_content

• Tipo restituito: str
• Descrizione: restituisce il rendering sicuro XML predefinito utilizzato nei prompt.

proprietà id

• Tipo restituito: str

  Nessuno.

• Descrizione: restituisce l'identificativo stabile del record corrispondente, se disponibile.

proprietà metadata

• Tipo restituito: dett[str, Any]

  Nessuno.

• Descrizione: restituisce i metadati dei record, se disponibili.

proprietà record

• Tipo restituito: record
• Descrizione: restituisce il record corrispondente.

metodo render_formatted_content

Restituisce una rappresentazione strutturata e sicura per XML del contenuto dei risultati.

• Parametri:
  • show_thread_id bool
  • show_distance bool
  • show_timestamp bool
  • show_role bool
  • show_user_id bool
  • show_agent_id bool
• Tipo restituito: str

proprietà timestamp

• Tipo restituito: str

  Nessuno.

• Descrizione: restituire l'indicatore orario del record, se disponibile.