# Terminologia Standardizzata Questo documento fornisce un riferimento per la terminologia preferita da utilizzare quando si discutono le funzionalità e i concetti di Rememberizer. Seguire questi standard aiuta a mantenere la coerenza nella documentazione. ## Termini e Definizioni Preferiti | Termine Preferito | Termini Alternativi | Definizione | | --------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vector Store | Database Vettoriale | Il termine preferito per l'implementazione del database vettoriale di Rememberizer è "Vector Store". Sebbene "Database Vettoriale" sia tecnicamente accurato, "Vector Store" dovrebbe essere utilizzato per coerenza. | | Vector Embeddings | Embeddings | Il termine completo "Vector Embeddings" è preferito nei contenuti educativi, mentre "Embeddings" è accettabile in contesti tecnici e esempi di codice. | | Data Source | Fonte di Dati, Integrazione | "Data Source" è il termine preferito per riferirsi alle origini dei dati (Slack, Google Drive, ecc.). | | Common Knowledge | Conoscenza Condivisa | Utilizzare "Common Knowledge" quando ci si riferisce alla funzionalità che consente di condividere conoscenze con altri utenti e applicazioni. | | Memento | Filtro Memento | Utilizzare "Memento" come termine principale, sebbene "Filtro Memento" sia accettabile nei contesti UI. | | Memory Integration | Memoria Condivisa, Memoria | "Memory Integration" è il nome completo preferito della funzionalità; "Memoria Condivisa" è accettabile nei contenuti rivolti agli utenti. | | OAuth2 Authentication | OAuth | Utilizzare il termine completo "OAuth2 Authentication" nella documentazione formale, sebbene "OAuth" sia accettabile in contesti meno formali. | | Search Your Knowledge | Cerca in Rememberizer | "Search Your Knowledge" dovrebbe essere utilizzato quando ci si riferisce al nome della funzionalità nei titoli e nella navigazione. | | Memorize | Memorizza | Utilizzare "Memorize" per il punto finale API e il nome della funzionalità, mentre "Memorizza" può essere utilizzato in contesti esplicativi. | | X-API-Key | x-api-key | Utilizzare "X-API-Key" in maiuscolo nella documentazione, sebbene il minuscolo sia accettabile negli esempi di codice. | ## Convenzioni API ### Directory della Documentazione API Il percorso ufficiale della documentazione API è `/en/developer/api-docs/`. Il percorso legacy `/en/developer/api-documentations/` dovrebbe essere dismesso. ### Intestazioni API Le seguenti convenzioni per le intestazioni devono essere utilizzate in modo coerente: * **Intestazione di autorizzazione**: `Authorization: Bearer YOUR_JWT_TOKEN` * **Intestazione della chiave API**: `X-API-Key: YOUR_API_KEY` * **Intestazione Content-Type**: `Content-Type: application/json` ### Stile degli Endpoint API Gli endpoint API devono essere stilizzati in modo coerente: * URL di base: `https://api.rememberizer.ai/api/v1/` * Percorsi degli endpoint in minuscolo con trattini se necessario: `/documents/search/` * Percorsi del negozio vettoriale con segnaposto per i parametri: `/vector-stores/{vector_store_id}/documents/search` ## Convenzioni di Nomenclatura delle Funzionalità ### Nomi delle integrazioni I nomi delle integrazioni devono seguire il modello: * Integrazione {Nome dell'integrazione} di Rememberizer (ad es., "Integrazione Slack di Rememberizer") ### Nominazione del Server MCP I tipi di server MCP devono essere chiaramente distinti: * **Server MCP Rememberizer**: Server di uso generale * **Server MCP Rememberizer Vector Store**: Server specificamente per operazioni di archiviazione vettoriale ## Convenzioni sui Titoli dei Documenti I titoli dei documenti devono seguire queste convenzioni: * Capitalizzare le parole importanti (Title Case) * Utilizzare una terminologia coerente per le funzionalità * Evitare acronimi nei titoli a meno che non siano ampiamente riconosciuti (ad es., API) * Mantenere i titoli concisi e descrittivi ## Utilizzare Questa Guida Quando si crea o si aggiorna la documentazione, fare riferimento a questa guida per garantire una terminologia coerente. Quando si incontrano termini varianti nella documentazione, dare priorità all'aggiornamento ai termini preferiti elencati qui quando si apportano altre modifiche a quei documenti. Ricordare che mantenere l'integrità dei link e dei nomi dei file è fondamentale, quindi concentrarsi sull'aggiornamento della terminologia all'interno del testo preservando gli URL e le strutture dei file. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.rememberizer.ai/it/background/standardized-terminology.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.