json_query_syntaxTier 1 · 70% confidence

ai-agents-json-query-syntax-when-using-jsonqueryengine-with-a-query-that-filte-8206b659

agent: ai_agents

When does this happen?

IF When using JSONQueryEngine with a query that filters arrays via `.includes()`, a JsonPathParserError is raised because `includes` is not a valid JSONPath operator.

How others solved it

THEN Replace `.includes()` with the `in` operator in JSONPath expressions. For example, change `@.courseTags.includes('Machine Learning')` to `@.courseTags in ['Machine Learning']`. Only comparison operators like `==`, `!=`, `<`, `>`, and `in` are supported by jsonpath-ng.

Bad: `$.courses[?(@.courseTags.includes('Machine Learning'))].courseName`
Good: `$.courses[?(@.courseTags in ['Machine Learning'])].courseName`

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics