Référence de l'API mémoire

Cette page est la référence de l'API REST pour la mémoire gérée de l'agent. Il couvre les Endpoint, les champs de requête et les champs de réponse pour la mémoire gérée :

Un magasin de mémoire est une ressource sécurisable Unity Catalog qui agit comme un conteneur pour les entrées de mémoire. Utilisez les APIs de magasin de mémoire pour créer et gérer des magasins.
Une **entrée de mémoire** est un élément de contenu individuel stocké dans un magasin de mémoire. Utilisez les APIs d'entrée mémoire pour lire et écrire des entrées.
Une conversation est un état de conversation compatible avec OpenAI — messages et appels d’outils — soutenu par un magasin de mémoire et pin à une étendue. Utilisez les APIs de conversation pour créer et gérer des conversations et leurs éléments.

Prérequis

Générer un jeton OAuth à l’aide de l’interface de ligne de commande Databricks pour appeler les APIs :

Bash
databricks auth login --host ${DATABRICKS_HOST}
databricks auth token

APIs du magasin de mémoire

Un magasin de mémoire est une ressource sécurisable de Unity Catalog qui agit comme un conteneur pour les entrées de mémoire. Les magasins de mémoire utilisent une nomenclature à trois niveaux : catalog.schema.memory_store_name.

Opérations	Point de terminaison	Privilège requis
Créer	`POST /api/2.1/unity-catalog/memory-stores`	`CREATE MEMORY STORE` sur le schéma parent
Obtenir	`GET /api/2.1/unity-catalog/memory-stores/{full_name}`	`READ MEMORY STORE` sur la boutique
Liste	`GET /api/2.1/unity-catalog/memory-stores`	`USE SCHEMA` sur le schéma parent
Mettre à jour	`PATCH /api/2.1/unity-catalog/memory-stores/{full_name}`	`MANAGE` sur la boutique
Supprimer	`DELETE /api/2.1/unity-catalog/memory-stores/{full_name}`	`MANAGE` sur la boutique

Opérations	Point de terminaison	Privilège requis
Créer	`POST /api/2.1/unity-catalog/memory-stores`	`CREATE MEMORY STORE` sur le schéma parent
Obtenir	`GET /api/2.1/unity-catalog/memory-stores/{full_name}`	`READ MEMORY STORE` sur la boutique
Liste	`GET /api/2.1/unity-catalog/memory-stores`	`USE SCHEMA` sur le schéma parent
Mettre à jour	`PATCH /api/2.1/unity-catalog/memory-stores/{full_name}`	`MANAGE` sur la boutique
Supprimer	`DELETE /api/2.1/unity-catalog/memory-stores/{full_name}`	`MANAGE` sur la boutique

Créer un magasin de mémoire

Crée un nouveau magasin de mémoire sous un schéma parent.

Endpoint : POST /api/2.1/unity-catalog/memory-stores
**Privilège requis** : CREATE MEMORY STORE sur le schéma parent

Bash
curl -X POST "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "agent_memory",
    "catalog_name": "main",
    "schema_name": "default",
    "description": "Memory store for customer support agents"
  }'

Champs de requête :

Champ	Type	Obligatoire	Description
`name`	`string`	Oui	Nom abrégé du magasin de mémoire. Doit correspondre à `[A-Za-z0-9_-]+`, de 1 à 255 caractères. Unique au sein du schéma parent.
`catalog_name`	`string`	Oui	Nom du catalogue parent.
`schema_name`	`string`	Oui	Nom du schéma parent, par rapport au catalogue.
`description`	`string`	Non	Description lisible par l'homme du magasin de mémoire.

Champ	Type	Obligatoire	Description
`name`	`string`	Oui	Nom abrégé du magasin de mémoire. Doit correspondre à `[A-Za-z0-9_-]+`, de 1 à 255 caractères. Unique au sein du schéma parent.
`catalog_name`	`string`	Oui	Nom du catalogue parent.
`schema_name`	`string`	Oui	Nom du schéma parent, par rapport au catalogue.
`description`	`string`	Non	Description lisible par l'homme du magasin de mémoire.

Obtenir un stockage en mémoire

Récupère un magasin de mémoire par son nom complet en trois parties.

Endpoint : GET /api/2.1/unity-catalog/memory-stores/{full_name}
Privilège requis : READ MEMORY STORE sur le magasin

Bash
curl -X GET \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Lister les stockages de mémoire

Répertorie les magasins de mémoire dans un schéma. Les résultats sont filtrés en fonction des magasins que l'appelant peut lire.

Endpoint : GET /api/2.1/unity-catalog/memory-stores
**Privilège requis** : USE SCHEMA sur le schéma parent

Bash
curl -X GET \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores?catalog_name=main&schema_name=default" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Parameters de query :

parameter	Type	Obligatoire	Description
`catalog_name`	`string`	Oui	Nom du catalogue parent.
`schema_name`	`string`	Oui	Nom du schéma parent.
`page_token`	`string`	Non	Jeton de pagination d’une réponse précédente.
`max_results`	`integer`	Non	Nombre maximal de magasins par page. default à 100, max 1 000.

parameter	Type	Obligatoire	Description
`catalog_name`	`string`	Oui	Nom du catalogue parent.
`schema_name`	`string`	Oui	Nom du schéma parent.
`page_token`	`string`	Non	Jeton de pagination d’une réponse précédente.
`max_results`	`integer`	Non	Nombre maximal de magasins par page. default à 100, max 1 000.

Mettre à jour un magasin de mémoire

Met à jour les champs mutables dans un magasin de mémoire. Actuellement, seul description est mutable.

Endpoint : PATCH /api/2.1/unity-catalog/memory-stores/{full_name}
Privilège requis : MANAGE sur le magasin

Bash
curl -X PATCH \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "memory_store": {
      "description": "Updated description for the memory store"
    },
    "update_mask": "description"
  }'

Supprimer un magasin de mémoire

Supprime un magasin de mémoire et toutes ses entrées de mémoire.

Endpoint : DELETE /api/2.1/unity-catalog/memory-stores/{full_name}
Privilège requis : MANAGE sur le magasin

Bash
curl -X DELETE \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Champs de réponse du magasin de mémoire

Champ	Type	Description
`name`	`string`	Nom abrégé du magasin de mémoire.
`catalog_name`	`string`	Nom du catalogue parent.
`schema_name`	`string`	Nom du schéma parent.
`description`	`string`	Description lisible par l'homme.
`owner`	`string`	Principal UC propriétaire du magasin. Paramétré à la création.
`full_name`	`string`	Nom complet en trois parties : `catalog.schema.name`.
`memory_store_id`	`string`	UUID attribué par le serveur.
`securable_type`	`string`	Toujours `MEMORY_STORE`.
`created_at`	`integer`	Heure de création en millisecondes Unix epoch.
`updated_at`	`integer`	Heure de la dernière mise à jour en millisecondes d'époque Unix.
`created_by`	`string`	Principal qui a créé le store.

Champ	Type	Description
`name`	`string`	Nom abrégé du magasin de mémoire.
`catalog_name`	`string`	Nom du catalogue parent.
`schema_name`	`string`	Nom du schéma parent.
`description`	`string`	Description lisible par l'homme.
`owner`	`string`	Principal UC propriétaire du magasin. Paramétré à la création.
`full_name`	`string`	Nom complet en trois parties : `catalog.schema.name`.
`memory_store_id`	`string`	UUID attribué par le serveur.
`securable_type`	`string`	Toujours `MEMORY_STORE`.
`created_at`	`integer`	Heure de création en millisecondes Unix epoch.
`updated_at`	`integer`	Heure de la dernière mise à jour en millisecondes d'époque Unix.
`created_by`	`string`	Principal qui a créé le store.

APIs d’entrée de mémoire

Les entrées de mémoire sont les éléments de contenu individuels stockés dans un magasin de mémoire. Chaque entrée est identifiée par une portée et un chemin : scope est une clé de partition que l'appelant attribue (par exemple, un ID d'utilisateur final), et path est un chemin souple dans cette portée qui doit commencer par /memories/ (par exemple, /memories/preferences.md). scope est requis pour chaque requête d'entrée de mémoire.

Opérations	Point de terminaison	Privilège requis
Créer	`POST /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`WRITE MEMORY STORE` sur la boutique
Obtenir	`GET /api/2.1/unity-catalog/memory-stores/{full_name}/entries:get`	`READ MEMORY STORE` sur la boutique
Liste	`GET /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`READ MEMORY STORE` sur la boutique
Mettre à jour	`PATCH /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`WRITE MEMORY STORE` sur la boutique
Supprimer	`DELETE /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`WRITE MEMORY STORE` sur la boutique
Rechercher	`POST /api/2.1/unity-catalog/memory-stores/{full_name}/entries:search`	`READ MEMORY STORE` sur la boutique

Opérations	Point de terminaison	Privilège requis
Créer	`POST /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`WRITE MEMORY STORE` sur la boutique
Obtenir	`GET /api/2.1/unity-catalog/memory-stores/{full_name}/entries:get`	`READ MEMORY STORE` sur la boutique
Liste	`GET /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`READ MEMORY STORE` sur la boutique
Mettre à jour	`PATCH /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`WRITE MEMORY STORE` sur la boutique
Supprimer	`DELETE /api/2.1/unity-catalog/memory-stores/{full_name}/entries`	`WRITE MEMORY STORE` sur la boutique
Rechercher	`POST /api/2.1/unity-catalog/memory-stores/{full_name}/entries:search`	`READ MEMORY STORE` sur la boutique

Créer une entrée de mémoire

Crée une nouvelle entrée de mémoire dans un magasin de mémoire.

Endpoint : POST /api/2.1/unity-catalog/memory-stores/{full_name}/entries?scope=<scope>
Privilège requis : WRITE MEMORY STORE sur le magasin

scope est un parameter de query ; le corps de la requête est l'entrée elle-même.

Bash
curl -X POST \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory/entries?scope=user-42" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "/memories/preferences.md",
    "contents": "The user prefers responses in English and uses formal tone.",
    "description": "User language and tone preferences"
  }'

Champs de requête :

Champ	Dans	Type	Obligatoire	Description
`scope`	Saisir une requête	`string`	Oui	Partition à laquelle appartient l’entrée, attribuée par l’appelant (par exemple, un ID d’utilisateur final).
`path`	corps	`string`	Oui	Chemin identifiant l'entrée dans le cadre. Doit start par `/memories/`. Immutable.
`contents`	corps	`string`	Non	Contenu textuel de la mémoire en texte libre.
`description`	corps	`string`	Non	Résumé en une ligne de l'entrée de mémoire. Sert de point d'ancrage d'index dans les réponses de liste.

Champ	Dans	Type	Obligatoire	Description
`scope`	Saisir une requête	`string`	Oui	Partition à laquelle appartient l’entrée, attribuée par l’appelant (par exemple, un ID d’utilisateur final).
`path`	corps	`string`	Oui	Chemin identifiant l'entrée dans le cadre. Doit start par `/memories/`. Immutable.
`contents`	corps	`string`	Non	Contenu textuel de la mémoire en texte libre.
`description`	corps	`string`	Non	Résumé en une ligne de l'entrée de mémoire. Sert de point d'ancrage d'index dans les réponses de liste.

Obtenir une entrée de mémoire

Récupère une seule entrée de mémoire par scope et path.

Endpoint : GET /api/2.1/unity-catalog/memory-stores/{full_name}/entries:get
Privilège requis : READ MEMORY STORE sur le magasin

Bash
curl -X GET \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory/entries:get?scope=user-42&path=/memories/preferences.md" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Lister les entrées de mémoire

Répertorie les entrées de mémoire dans une portée.

Endpoint : GET /api/2.1/unity-catalog/memory-stores/{full_name}/entries
Privilège requis : READ MEMORY STORE sur le magasin

Bash
curl -X GET \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory/entries?scope=user-42" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Parameters de query :

parameter	Type	Obligatoire	Description
`scope`	`string`	Oui	Portée (partition) pour répertorier les entrées.
`path_prefix`	`string`	Non	Retourner uniquement les entrées dont le chemin start par ce préfixe.
`page_size`	`integer`	Non	Nombre maximal d'entrées par page. Le serveur limite la taille de la page.
`page_token`	`string`	Non	Jeton de pagination d’une réponse précédente.

parameter	Type	Obligatoire	Description
`scope`	`string`	Oui	Portée (partition) pour répertorier les entrées.
`path_prefix`	`string`	Non	Retourner uniquement les entrées dont le chemin start par ce préfixe.
`page_size`	`integer`	Non	Nombre maximal d'entrées par page. Le serveur limite la taille de la page.
`page_token`	`string`	Non	Jeton de pagination d’une réponse précédente.

Les réponses de liste omettent contents (métadonnées uniquement) et incluent un next_page_token lorsqu'il reste plus de pages.

Mettre à jour une entrée de mémoire

Applique une seule opération de modification à l’ contents d’une entrée existante, identifiée par scope et path. Fournissez exactement un de str_replace, insert, ou replace_all. description est modifiable : définissez-le pour remplacer la description de l'entrée, ou omettez-le pour laisser la description inchangée.

Endpoint : PATCH /api/2.1/unity-catalog/memory-stores/{full_name}/entries
Privilège requis : WRITE MEMORY STORE sur le magasin

Bash
curl -X PATCH \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory/entries" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "user-42",
    "path": "/memories/preferences.md",
    "replace_all": { "contents": "The user prefers responses in Spanish and uses casual tone." }
  }'

Modifier les Opérations (définir exactement une) :

Opérations	Champs	Comportement
`replace_all`	`contents`	Remplacer le contenu complet de l'entrée.
`str_replace`	`old_str`, `new_str`	Remplacez l'occurrence unique de `old_str` par `new_str` (doit correspondre exactement une seule fois).
`insert`	`insert_line`, `insert_text`	Insérer `insert_text`; `insert_line` 0 = en haut, omis = ajouter à la fin.

Opérations	Champs	Comportement
`replace_all`	`contents`	Remplacer le contenu complet de l'entrée.
`str_replace`	`old_str`, `new_str`	Remplacez l'occurrence unique de `old_str` par `new_str` (doit correspondre exactement une seule fois).
`insert`	`insert_line`, `insert_text`	Insérer `insert_text`; `insert_line` 0 = en haut, omis = ajouter à la fin.

Supprimer une entrée mémoire

Supprime une entrée de mémoire, identifiée par scope et path.

Endpoint : DELETE /api/2.1/unity-catalog/memory-stores/{full_name}/entries
Privilège requis : WRITE MEMORY STORE sur le magasin

Bash
curl -X DELETE \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory/entries?scope=user-42&path=/memories/preferences.md" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Rechercher les entrées de mémoire

Recherche des entrées de mémoire par mot-clé dans les champs chemin, contenu et description.

Endpoint : POST /api/2.1/unity-catalog/memory-stores/{full_name}/entries:search
Privilège requis : READ MEMORY STORE sur le magasin

Bash
curl -X POST \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/memory-stores/main.default.agent_memory/entries:search" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "user-42",
    "query": "language preferences"
  }'

Champs de la requête : scope (obligatoire), query (obligatoire), path_prefix (facultatif), top_k (facultatif ; default 10, max. 50).

Champs de réponse d'entrée de mémoire

Champ	Type	Description
`path`	`string`	Chemin souple de l'entrée dans sa portée.
`contents`	`string`	Texte de la mémoire. Omis dans les réponses de liste.
`description`	`string`	Résumé d'une ligne.
`scope`	`string`	Définir la portée (partition) à laquelle l'entrée appartient.
`memory_store_name`	`string`	Nom en trois parties du magasin de mémoire parent.
`has_contents`	`boolean`	Indique si l'entrée contient des `contents` non vides (utile dans une liste).
`create_time`	`string`	Timestamp de création (RFC 3339).
`update_time`	`string`	Timestamp de la dernière mise à jour (RFC 3339).

Champ	Type	Description
`path`	`string`	Chemin souple de l'entrée dans sa portée.
`contents`	`string`	Texte de la mémoire. Omis dans les réponses de liste.
`description`	`string`	Résumé d'une ligne.
`scope`	`string`	Définir la portée (partition) à laquelle l'entrée appartient.
`memory_store_name`	`string`	Nom en trois parties du magasin de mémoire parent.
`has_contents`	`boolean`	Indique si l'entrée contient des `contents` non vides (utile dans une liste).
`create_time`	`string`	Timestamp de création (RFC 3339).
`update_time`	`string`	Timestamp de la dernière mise à jour (RFC 3339).

Conversation APIs

Une conversation stocke l'état de la conversation compatible avec OpenAI — messages, appels d'outils et autres — dans un magasin de mémoire sous une portée unique. Avec une conversation, un agent conserve et recharge l'état de la session côté serveur. Vous créez chaque conversation dans un magasin de mémoire (nom en trois parties) et un scope, et les Opérations de conversation nécessitent les mêmes privilèges que le magasin de mémoire sous-jacent.

Opérations	Point de terminaison	Privilège requis
Créer	`POST /api/2.1/unity-catalog/conversations`	`WRITE MEMORY STORE` sur la boutique
Obtenir	`GET /api/2.1/unity-catalog/conversations/{conversation_id}`	`READ MEMORY STORE` sur la boutique
Mettre à jour	`POST /api/2.1/unity-catalog/conversations/{conversation_id}`	`WRITE MEMORY STORE` sur la boutique
Supprimer	`DELETE /api/2.1/unity-catalog/conversations/{conversation_id}`	`WRITE MEMORY STORE` sur la boutique

Opérations	Point de terminaison	Privilège requis
Créer	`POST /api/2.1/unity-catalog/conversations`	`WRITE MEMORY STORE` sur la boutique
Obtenir	`GET /api/2.1/unity-catalog/conversations/{conversation_id}`	`READ MEMORY STORE` sur la boutique
Mettre à jour	`POST /api/2.1/unity-catalog/conversations/{conversation_id}`	`WRITE MEMORY STORE` sur la boutique
Supprimer	`DELETE /api/2.1/unity-catalog/conversations/{conversation_id}`	`WRITE MEMORY STORE` sur la boutique

Créer une conversation

Crée une conversation liée à un magasin de mémoire et à une portée.

Endpoint : POST /api/2.1/unity-catalog/conversations
Privilège requis : WRITE MEMORY STORE sur le magasin

Bash
curl -X POST "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/conversations" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "memory_store": { "name": "main.default.support_agent_memory" },
    "scope": { "kind": "user", "value": "user-123" },
    "metadata": { "source": "support-chat" }
  }'

Champs de requête :

Champ	Type	Obligatoire	Description
`memory_store`	`object`	Oui	Magasin de mémoire prenant en charge la conversation.
`memory_store.name`	`string`	Oui	Nom entièrement qualifié en trois parties du stockage de la mémoire : `catalog.schema.memory_store`.
`scope`	`object`	Oui	Portée à laquelle la conversation est pin.
`scope.kind`	`string`	Oui	Type de portée, par exemple : `user` ou `user_defined`.
`scope.value`	`string`	Oui	Valeur de portée spécifique au type, par exemple un ID d'utilisateur final.
`metadata`	`object`	Non	Métadonnées clé-valeur contrôlées par l'appelant. Jusqu'à 16 clés ; clés jusqu'à 64 caractères, valeurs jusqu'à 512 caractères.
`items`	`array`	Non	Éléments de conversation OpenAI initiaux pour amorcer la conversation (jusqu'à 20). Les éléments sans `type` sont stockés en tant qu'éléments de message.

Champ	Type	Obligatoire	Description
`memory_store`	`object`	Oui	Magasin de mémoire prenant en charge la conversation.
`memory_store.name`	`string`	Oui	Nom entièrement qualifié en trois parties du stockage de la mémoire : `catalog.schema.memory_store`.
`scope`	`object`	Oui	Portée à laquelle la conversation est pin.
`scope.kind`	`string`	Oui	Type de portée, par exemple : `user` ou `user_defined`.
`scope.value`	`string`	Oui	Valeur de portée spécifique au type, par exemple un ID d'utilisateur final.
`metadata`	`object`	Non	Métadonnées clé-valeur contrôlées par l'appelant. Jusqu'à 16 clés ; clés jusqu'à 64 caractères, valeurs jusqu'à 512 caractères.
`items`	`array`	Non	Éléments de conversation OpenAI initiaux pour amorcer la conversation (jusqu'à 20). Les éléments sans `type` sont stockés en tant qu'éléments de message.

Obtenir une conversation

Récupère une conversation par son ID.

Endpoint : GET /api/2.1/unity-catalog/conversations/{conversation_id}
Privilège requis : READ MEMORY STORE sur le magasin

Bash
curl -X GET \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/conversations/${CONVERSATION_ID}" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Mettre à jour une conversation

Met à jour le metadata d'une conversation.

Endpoint : POST /api/2.1/unity-catalog/conversations/{conversation_id}
Privilège requis : WRITE MEMORY STORE sur le magasin

Bash
curl -X POST \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/conversations/${CONVERSATION_ID}" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "source": "support-chat", "resolved": "true" } }'

Supprimer une conversation

Supprime une conversation et ses éléments.

Endpoint : DELETE /api/2.1/unity-catalog/conversations/{conversation_id}
Privilège requis : WRITE MEMORY STORE sur le magasin

Bash
curl -X DELETE \
  "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/conversations/${CONVERSATION_ID}" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

Champs de réponse de la conversation

Champ	Type	Description
`id`	`string`	ID de conversation attribué par le serveur.
`object`	`string`	Toujours `conversation`.
`created_at`	`integer`	Heure de création en secondes d'époque Unix.
`metadata`	`object`	Métadonnées clé-valeur fournies par l’appelant.

Champ	Type	Description
`id`	`string`	ID de conversation attribué par le serveur.
`object`	`string`	Toujours `conversation`.
`created_at`	`integer`	Heure de création en secondes d'époque Unix.
`metadata`	`object`	Métadonnées clé-valeur fournies par l’appelant.

APIs des éléments de conversation

Les éléments sont les messages individuels et les appels d'outils au sein d'une conversation. Ils suivent le format des éléments de conversation OpenAI et utilisent une pagination compatible avec OpenAI (after, limit, has_more).

Opérations	Point de terminaison	Privilège requis
Créer des éléments	`POST /api/2.1/unity-catalog/conversations/{conversation_id}/items`	`WRITE MEMORY STORE` sur la boutique
Obtenir l'élément	`GET /api/2.1/unity-catalog/conversations/{conversation_id}/items/{item_id}`	`READ MEMORY STORE` sur la boutique
Éléments de liste	`GET /api/2.1/unity-catalog/conversations/{conversation_id}/items`	`READ MEMORY STORE` sur la boutique
Supprimer l'élément	`DELETE /api/2.1/unity-catalog/conversations/{conversation_id}/items/{item_id}`	`WRITE MEMORY STORE` sur la boutique

Opérations	Point de terminaison	Privilège requis
Créer des éléments	`POST /api/2.1/unity-catalog/conversations/{conversation_id}/items`	`WRITE MEMORY STORE` sur la boutique
Obtenir l'élément	`GET /api/2.1/unity-catalog/conversations/{conversation_id}/items/{item_id}`	`READ MEMORY STORE` sur la boutique
Éléments de liste	`GET /api/2.1/unity-catalog/conversations/{conversation_id}/items`	`READ MEMORY STORE` sur la boutique
Supprimer l'élément	`DELETE /api/2.1/unity-catalog/conversations/{conversation_id}/items/{item_id}`	`WRITE MEMORY STORE` sur la boutique

Prérequis​

APIs du magasin de mémoire​

Créer un magasin de mémoire​

Obtenir un stockage en mémoire​

Lister les stockages de mémoire​

Mettre à jour un magasin de mémoire​

Supprimer un magasin de mémoire​

Champs de réponse du magasin de mémoire​

APIs d’entrée de mémoire​

Créer une entrée de mémoire​

Obtenir une entrée de mémoire​

Lister les entrées de mémoire​

Mettre à jour une entrée de mémoire​

Supprimer une entrée mémoire​

Rechercher les entrées de mémoire​

Champs de réponse d'entrée de mémoire​

Conversation APIs​

Créer une conversation​

Obtenir une conversation​

Mettre à jour une conversation​

Supprimer une conversation​

Champs de réponse de la conversation​

APIs des éléments de conversation​

Prérequis

APIs du magasin de mémoire

Créer un magasin de mémoire

Obtenir un stockage en mémoire

Lister les stockages de mémoire

Mettre à jour un magasin de mémoire

Supprimer un magasin de mémoire

Champs de réponse du magasin de mémoire

APIs d’entrée de mémoire

Créer une entrée de mémoire

Obtenir une entrée de mémoire

Lister les entrées de mémoire

Mettre à jour une entrée de mémoire

Supprimer une entrée mémoire

Rechercher les entrées de mémoire

Champs de réponse d'entrée de mémoire

Conversation APIs

Créer une conversation

Obtenir une conversation

Mettre à jour une conversation

Supprimer une conversation

Champs de réponse de la conversation

APIs des éléments de conversation