GOV-667: Add comment for clarity

Author: ankitpatnaik-atlan

pyatlan/client/common/transport.py

@@ -25,7 +25,11 @@
 def build_policy_search_request(
     policy_name: str, persona_qualified_name: str
 ) -> IndexSearchRequest:
-    """Build an IndexSearchRequest to find an existing AuthPolicy by name and persona."""
+    """
+    Build an IndexSearchRequest to find an existing AuthPolicy by name and persona.
+    Using persona GUID directly returns associated assets, not policies.
+    Policies require a hierarchical (prefix) match to be correctly retrieved.
+    """
     query = Bool(
         filter=[
             Term(field="__state", value="ACTIVE"),