Ignora e passa al contenuto principale

Questo browser non è più supportato.

Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.

Scarica Microsoft Edge Scopri di più su Internet Explorer e Microsoft Edge
microsoft-foundry.rest.security.o-auth2-auth

Memory Stores

Search memories

POST /memory_stores/{name}:search_memories

Searches the specified memory store for memories relevant to the provided conversation context.

Parametri di intestazione

Foundry-Features enum necessario

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

MemoryStores=V1Preview

Parametri del percorso

name string necessario

The name of the memory store to search.

Parametri di query

api-version string necessario

The API version to use for this operation.

Corpo della richiesta

Content-Type: application/json
scope string necessario

The namespace that logically groups and isolates memories, such as a user ID.

items OpenAI.InputItem[]

Items for which to search for relevant memories.

previous_search_id string

The unique ID of the previous search request, enabling incremental memory search from where the last operation left off.

options MemorySearchOptions

Memory search options.

max_memories integer

Maximum number of memory items to return.

Risposte

The request has succeeded.

Corpo

Content-Type: application/json
search_id string necessario

The unique ID of this search request. Use this value as previous_search_id in subsequent requests to perform incremental searches.

memories MemorySearchItem[] necessario

Related memory items found during the search operation.

usage MemoryStoreOperationUsage necessario

Usage statistics of a memory store operation.

embedding_tokens integer necessario

The number of embedding tokens.

input_tokens integer necessario
input_tokens_details OpenAI.ResponseUsageInputTokensDetails necessario
cached_tokens integer necessario
cache_write_tokens integer necessario
output_tokens integer necessario
output_tokens_details OpenAI.ResponseUsageOutputTokensDetails necessario
reasoning_tokens integer necessario
total_tokens integer necessario

Client error

Corpo

Content-Type: application/json
error OpenAI.Error necessario
code string | null necessario
message string necessario
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
Uno qualsiasi dei seguenti:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string necessario

The public continuation instruction.

details OpenAI.Error[]
additionalInfo object
debugInfo object

Server error

Corpo

Content-Type: application/json
error OpenAI.Error necessario
code string | null necessario
message string necessario
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
Uno qualsiasi dei seguenti:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string necessario

The public continuation instruction.

details OpenAI.Error[]
additionalInfo object
debugInfo object

Richiedi

POST /memory_stores/{name}:search_memories HTTP/1.1

Response

Status: 200
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
it-it
Scelte sulla privacy
  • Dichiarazione di non responsabilità relativa all'intelligenza artificiale
  • Versioni precedenti
  • Blog
  • Collabora
  • Riservatezza
  • Privacy dei dati sanitari dei consumatori
  • Condizioni per l'utilizzo
  • Accessibilità
  • Marchi
  • © Microsoft 2026