Referência completa dos operadores do Filtered Stream da X API v2, incluindo operadores de palavra-chave, has:, is: e o operador embedding: de similaridade semântica exclusivo do Enterprise para regras de stream.
Esta página fornece uma lista completa dos operadores disponíveis ao criar regras para o Filtered Stream.
Os operadores são usados para corresponder a atributos específicos de posts. Existem dois tipos:
Operadores independentes — Podem ser usados sozinhos ou com quaisquer outros operadores
Operadores que exigem conjunção — Devem ser usados com pelo menos um operador independente
A maioria dos operadores está disponível tanto no Pay-per-use quanto no Enterprise. Alguns operadores avançados (como o de similaridade semântica) exigem Enterprise com acesso a um tier adicional.
Apenas Enterprise — Tier de Embedding obrigatórioOs operadores embedding: e embedding_threshold: só estão disponíveis em contas Enterprise provisionadas com acesso ao tier de Embedding para o Filtered Stream. Em tiers não suportados, a criação de regras será rejeitada com um erro “unavailable operator”. Entre em contato com seu representante de conta para habilitar.
Esses operadores usam um modelo neural de embedding para corresponder a posts por similaridade semântica em relação a uma consulta, em vez de exigir correspondências exatas de palavras-chave.
Operador
Tipo
Resumo
Exemplo
embedding:"query"
Independente
Corresponde a posts semanticamente semelhantes à consulta. Consultas com várias palavras devem estar entre aspas.
embedding:"climate change policy"
embedding_threshold:X.XX
Exige conjunção
Similaridade de cosseno mínima para uma correspondência (0,0–1,0). O padrão é 0.3. Use valores entre 0,3–0,6.
embedding_threshold:não pode ser o único operador em uma regra. Combine-o com embedding: (ou outro operador independente).
Não negueembedding: (por exemplo, -embedding:"..." não é suportado).
Consultas em linguagem natural mais longas e descritivas produzem resultados melhores do que palavras-chave curtas.
O processamento de consultas de embedding é assíncrono — regras recém-criadas podem levar alguns segundos antes de começar a corresponder.
Quando um post corresponde por meio de uma regra de embedding, as entradas de matching_rules no payload entregue conterão embedding_similarity e embedding_threshold (consulte Correspondência de posts a regras).
