From 6380933b963c842093cc0f508f91fb4144ea6aae Mon Sep 17 00:00:00 2001
From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Mon, 10 Aug 2026 20:16:05 -0700
Subject: [PATCH] Note the large qty

---
 docs/usage.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/usage.md b/docs/usage.md
index 0b3f7e74f..2b95e8f83 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -686,8 +686,9 @@ than as part of the workflow run itself. The document is updated once the sugges
 !!! warning
 
     Every matching document results in a query to the AI service, which may incur costs and have privacy
-    implications. Be careful when adding this action to a workflow with a **Scheduled** trigger or a
-    broad filter that could run over a large quantity of documents.
+    implications. Queries can be slow, so a workflow matching a large number of documents can occupy the
+    task queue, and delay consumption of new documents, etc. Consider narrowing the trigger filters,
+    running in small batches and / or increasing workers.
 
 #### Workflow placeholders