참고소스 수정본

참고/neo4j-graphrag-python-main/examples/retrieve/tools/retriever_to_tool_example.py

@@ -0,0 +1,114 @@
+#  Copyright (c) "Neo4j"
+#  Neo4j Sweden AB [https://neo4j.com]
+#  #
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#  #
+#      https://www.apache.org/licenses/LICENSE-2.0
+#  #
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+"""
+Example demonstrating how to convert a retriever to a tool.
+
+This example shows:
+1. How to convert a custom StaticRetriever to a Tool using the convert_to_tool method
+2. How to define parameters for the tool in the retriever class
+3. How to execute the tool
+"""
+
+import neo4j
+from typing import Optional, Any, cast
+from unittest.mock import MagicMock
+
+from neo4j_graphrag.retrievers.base import Retriever
+from neo4j_graphrag.types import RawSearchResult
+
+
+# Create a Retriever that returns static results about Neo4j
+# This would illustrate the conversion process of any Retriever (Vector, Hybrid, etc.)
+class StaticRetriever(Retriever):
+    """A retriever that returns static results about Neo4j."""
+
+    # Disable Neo4j version verification
+    VERIFY_NEO4J_VERSION = False
+
+    def __init__(self, driver: neo4j.Driver):
+        # Call the parent class constructor with the driver
+        super().__init__(driver)
+
+    def get_search_results(
+        self, query_text: Optional[str] = None, **kwargs: Any
+    ) -> RawSearchResult:
+        """Return static information about Neo4j regardless of the query.
+
+        Args:
+            query_text (Optional[str]): The query about Neo4j (any query will return general Neo4j information)
+            **kwargs (Any): Additional keyword arguments (not used)
+
+        Returns:
+            RawSearchResult: Static Neo4j information with metadata
+        """
+        # Create formatted Neo4j information
+        neo4j_info = (
+            "# Neo4j Graph Database\n\n"
+            "Neo4j is a graph database management system developed by Neo4j, Inc. "
+            "It is an ACID-compliant transactional database with native graph storage and processing.\n\n"
+            "## Key Features:\n\n"
+            "- **Cypher Query Language**: Neo4j's intuitive query language designed specifically for working with graph data\n"
+            "- **Property Graphs**: Both nodes and relationships can have properties (key-value pairs)\n"
+            "- **ACID Compliance**: Ensures data integrity with full transaction support\n"
+            "- **Native Graph Storage**: Optimized storage for graph data structures\n"
+            "- **High Availability**: Clustering for enterprise deployments\n"
+            "- **Scalability**: Handles billions of nodes and relationships"
+        )
+
+        # Create a Neo4j record with the information
+        records = [neo4j.Record({"result": neo4j_info})]
+
+        # Return a RawSearchResult with the records and metadata
+        return RawSearchResult(records=records, metadata={"query": query_text})
+
+
+def main() -> None:
+    # Convert a StaticRetriever to a tool using the new convert_to_tool method
+    static_retriever = StaticRetriever(driver=cast(Any, MagicMock()))
+
+    # Convert the retriever to a tool with custom parameter descriptions
+    static_tool = static_retriever.convert_to_tool(
+        name="Neo4jInfoTool",
+        description="Get general information about Neo4j graph database",
+        parameter_descriptions={
+            "query_text": "Any query about Neo4j (the tool returns general information regardless)"
+        },
+    )
+
+    # Print tool information
+    print("Example: StaticRetriever with specific parameters")
+    print(f"Tool Name: {static_tool.get_name()}")
+    print(f"Tool Description: {static_tool.get_description()}")
+    print(f"Tool Parameters: {static_tool.get_parameters()}")
+    print()
+
+    # Execute the tools (in a real application, this would be done by instructions from an LLM)
+    try:
+        # Execute the static retriever tool
+        print("\nExecuting the static retriever tool...")
+        static_result = static_tool.execute(
+            query_text="What is Neo4j?",
+        )
+        print("Static Search Results:")
+        for i, item in enumerate(static_result):
+            print(f"{i + 1}. {str(item)[:100]}...")
+
+    except Exception as e:
+        print(f"Error executing tool: {e}")
+
+
+if __name__ == "__main__":
+    main()