As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como funciona o Valkey MCP Server
<a name="agent-tools-valkey-mcp-how-it-works"></a>

O servidor Valkey MCP fornece ao seu agente um conjunto de ferramentas estruturadas para trabalhar com o armazenamento de dados Valkey configurado. Quando você faz uma solicitação, o agente seleciona a ferramenta apropriada, fornece os parâmetros necessários e recebe o resultado diretamente do Valkey. O servidor gerencia a construção e a validação do comando, portanto, o agente não precisa gerar o código do cliente ou formatar manualmente os comandos do Valkey.

O servidor Valkey MCP fornece as seguintes áreas de capacidade:


| Área de capacidade | Finalidade | 
| --- | --- | 
| Operações do Vale | Leia e modifique strings, hashes, listas, conjuntos, conjuntos classificados, fluxos e outras estruturas de dados do Valkey. | 
| Operações JSON | Armazene, recupere e atualize documentos e matrizes JSON usando caminhos estruturados. | 
| Cargas de trabalho de pesquisa e IA | Crie índices de pesquisa, adicione documentos, execute pesquisas de texto, semânticas, vetoriais e híbridas e agregue resultados. | 
| Salvaguardas operacionais | Separa as operações de leitura, gravação e administrativas. Os comandos administrativos destrutivos são desativados por padrão e o servidor pode ser executado no modo somente leitura. | 

O servidor usa entradas JSON estruturadas e as traduz nas operações apropriadas do Valkey. Isso reduz os erros de formatação de comandos e fornece ao agente uma interface consistente em tarefas comuns de dados, pesquisas e operações.

## Acesso total ao Valkey por meio de uma superfície compacta da ferramenta
<a name="agent-tools-valkey-mcp-full-access"></a>

O servidor Valkey MCP dá aos agentes acesso ao conjunto completo de comandos do Valkey por meio de três ferramentas estruturadas:

1. `valkey_read`manipula operações somente para leitura`GET`, como, `HGETALL``SCAN`, e. `INFO`

1. `valkey_write`suporta mutações como `SET``HSET`,`DEL`, e. `LPUSH`

1. `valkey_admin`abrange a configuração e as operações de alto impacto.

Isso mantém a superfície da ferramenta simples para os agentes e, ao mesmo tempo, oferece suporte aos recursos do Valkey, como strings, hashes, listas, conjuntos classificados, fluxos pub/sub, bitmaps e outros. HyperLogLog

## Fluxos de trabalho simplificados de IA, pesquisa e análise
<a name="agent-tools-valkey-mcp-search-ai"></a>

O servidor Valkey MCP fornece quatro ferramentas específicas para pesquisa vetorial, semântica, de texto e híbrida, além de agregações. Os agentes podem consultar seus dados sem criar comandos de baixo nível, oferecendo aos desenvolvedores um caminho direto de uma solicitação em linguagem natural para uma pesquisa funcional do Valkey ou um fluxo de trabalho de IA.

1. `manage_index`permite que os agentes criem, eliminem, inspecionem ou listem índices de pesquisa.

1. `add_documents`ingere documentos em um índice de pesquisa e cria automaticamente o índice se ele não existir. Ele também oferece suporte à geração de incorporação opcional para pesquisa semântica, usando pacotes de incorporação de código aberto por padrão e provedores configuráveis, como Amazon Bedrock, OpenAI ou Ollama.

1. `search`fornece uma interface unificada para pesquisas semânticas, textuais, híbridas e de busca similares. Ele detecta automaticamente o modo de pesquisa a partir dos parâmetros fornecidos.

1. `aggregate`fornece um criador de pipeline estruturado para`FT.AGGREGATE`, com suporte para `GROUPBY``SORTBY`,`APPLY`,`FILTER`, e `LIMIT` estágios.

Durante a depuração, as `aggregate` ferramentas `search` e permitem que os agentes inspecionem o conteúdo real do seu armazenamento de dados. Os agentes podem revisar dados indexados, obter amostras de documentos correspondentes e validar resultados de pesquisa e agregação diretamente na conversa.