Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Come funziona Valkey MCP Server
<a name="agent-tools-valkey-mcp-how-it-works"></a>

Il server Valkey MCP offre al tuo agente una serie di strumenti strutturati per lavorare con il datastore Valkey configurato. Quando si effettua una richiesta, l'agente seleziona lo strumento appropriato, fornisce i parametri richiesti e riceve il risultato direttamente da Valkey. Il server gestisce la costruzione e la convalida dei comandi, quindi l'agente non deve generare codice client o formattare manualmente i comandi Valkey.

Il server MCP Valkey offre le seguenti aree di funzionalità:


| Area di capacità | Scopo | 
| --- | --- | 
| Operazioni Valkey | Leggi e modifica stringhe, hash, elenchi, set, set ordinati, flussi e altre strutture di dati Valkey. | 
| Operazioni JSON | Archivia, recupera e aggiorna documenti e array JSON utilizzando percorsi strutturati. | 
| Carichi di lavoro di ricerca e intelligenza artificiale | Crea indici di ricerca, aggiungi documenti, esegui ricerche testuali, semantiche, vettoriali e ibride e aggrega i risultati. | 
| Misure di protezione operative | Separa le operazioni di lettura, scrittura e amministrazione. I comandi amministrativi distruttivi sono disabilitati per impostazione predefinita e il server può essere eseguito in modalità di sola lettura. | 

Il server utilizza input JSON strutturati e li traduce nelle operazioni Valkey appropriate. Ciò riduce gli errori di formattazione dei comandi e offre all'agente un'interfaccia coerente tra dati, ricerca e attività operative comuni.

## Accesso completo a Valkey tramite una superficie utensile compatta
<a name="agent-tools-valkey-mcp-full-access"></a>

Il server MCP Valkey offre agli agenti l'accesso al set completo di comandi Valkey tramite tre strumenti strutturati:

1. `valkey_read`gestisce operazioni di sola lettura come`GET`,, e. `HGETALL` `SCAN` `INFO`

1. `valkey_write`supporta mutazioni come`SET`,`HSET`, `DEL` e. `LPUSH`

1. `valkey_admin`copre la configurazione e le operazioni ad alto impatto.

Ciò semplifica la superficie degli strumenti per gli agenti, supportando al contempo le funzionalità di Valkey come stringhe, hash, elenchi, set ordinati, stream pub/sub, bitmap e altro. HyperLogLog

## Flussi di lavoro semplificati per intelligenza artificiale, ricerca e analisi
<a name="agent-tools-valkey-mcp-search-ai"></a>

Il server MCP Valkey offre quattro strumenti appositamente progettati per la ricerca vettoriale, semantica, testuale e ibrida, oltre alle aggregazioni. Gli agenti possono interrogare i dati senza creare comandi di basso livello, offrendo agli sviluppatori un percorso diretto da una richiesta in linguaggio naturale a una ricerca Valkey funzionante o a un flusso di lavoro di intelligenza artificiale.

1. `manage_index`consente agli agenti di creare, eliminare, ispezionare o elencare gli indici di ricerca.

1. `add_documents`inserisce i documenti in un indice di ricerca e crea automaticamente l'indice se non esiste. Supporta anche la generazione di incorporamento opzionale per la ricerca semantica, utilizzando pacchetti di incorporamento open source di provider predefiniti e configurabili come Amazon Bedrock, OpenAI o Ollama.

1. `search`fornisce un'interfaccia unificata per ricerche semantiche, testuali, ibride e simili. Rileva automaticamente la modalità di ricerca in base ai parametri forniti.

1. `aggregate`fornisce un generatore di pipeline strutturato per`FT.AGGREGATE`, con supporto per`GROUPBY`,, `SORTBY` `APPLY``FILTER`, e fasi. `LIMIT`

Durante il debug, `aggregate` gli strumenti `search` e gli strumenti consentono agli agenti di ispezionare il contenuto effettivo del datastore. Gli agenti possono esaminare i dati indicizzati, campionare i documenti corrispondenti e convalidare i risultati di ricerca e aggregazione direttamente nella conversazione.