mirror of
https://github.com/hwchase17/langchain
synced 2024-11-10 01:10:59 +00:00
6c1989d292
- **Description:** New feature: Gremlin graph-store and QA chain (including docs). Compatible with Azure CosmosDB. - **Dependencies:** no changes
208 lines
8.0 KiB
Python
208 lines
8.0 KiB
Python
import hashlib
|
|
import sys
|
|
from typing import Any, Dict, List, Optional, Union
|
|
|
|
from langchain_core.utils import get_from_env
|
|
|
|
from langchain_community.graphs.graph_document import GraphDocument, Node, Relationship
|
|
from langchain_community.graphs.graph_store import GraphStore
|
|
|
|
|
|
class GremlinGraph(GraphStore):
|
|
"""Gremlin wrapper for graph operations.
|
|
Parameters:
|
|
url (Optional[str]): The URL of the Gremlin database server or env GREMLIN_URI
|
|
username (Optional[str]): The collection-identifier like '/dbs/database/colls/graph'
|
|
or env GREMLIN_USERNAME if none provided
|
|
password (Optional[str]): The connection-key for database authentication
|
|
or env GREMLIN_PASSWORD if none provided
|
|
traversal_source (str): The traversal source to use for queries. Defaults to 'g'.
|
|
message_serializer (Optional[Any]): The message serializer to use for requests.
|
|
Defaults to serializer.GraphSONSerializersV2d0()
|
|
*Security note*: Make sure that the database connection uses credentials
|
|
that are narrowly-scoped to only include necessary permissions.
|
|
Failure to do so may result in data corruption or loss, since the calling
|
|
code may attempt commands that would result in deletion, mutation
|
|
of data if appropriately prompted or reading sensitive data if such
|
|
data is present in the database.
|
|
The best way to guard against such negative outcomes is to (as appropriate)
|
|
limit the permissions granted to the credentials used with this tool.
|
|
|
|
See https://python.langchain.com/docs/security for more information.
|
|
|
|
*Implementation details*:
|
|
The Gremlin queries are designed to work with Azure CosmosDB limitations
|
|
"""
|
|
|
|
@property
|
|
def get_structured_schema(self) -> Dict[str, Any]:
|
|
return self.structured_schema
|
|
|
|
def __init__(
|
|
self,
|
|
url: Optional[str] = None,
|
|
username: Optional[str] = None,
|
|
password: Optional[str] = None,
|
|
traversal_source: str = "g",
|
|
message_serializer: Optional[Any] = None,
|
|
) -> None:
|
|
"""Create a new Gremlin graph wrapper instance."""
|
|
try:
|
|
import asyncio
|
|
|
|
from gremlin_python.driver import client, serializer
|
|
|
|
if sys.platform == "win32":
|
|
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
|
|
except ImportError:
|
|
raise ValueError(
|
|
"Please install gremlin-python first: " "`pip3 install gremlinpython"
|
|
)
|
|
|
|
self.client = client.Client(
|
|
url=get_from_env("url", "GREMLIN_URI", url),
|
|
traversal_source=traversal_source,
|
|
username=get_from_env("username", "GREMLIN_USERNAME", username),
|
|
password=get_from_env("password", "GREMLIN_PASSWORD", password),
|
|
message_serializer=message_serializer
|
|
if message_serializer
|
|
else serializer.GraphSONSerializersV2d0(),
|
|
)
|
|
self.schema: str = ""
|
|
|
|
@property
|
|
def get_schema(self) -> str:
|
|
"""Returns the schema of the Gremlin database"""
|
|
if len(self.schema) == 0:
|
|
self.refresh_schema()
|
|
return self.schema
|
|
|
|
def refresh_schema(self) -> None:
|
|
"""
|
|
Refreshes the Gremlin graph schema information.
|
|
"""
|
|
vertex_schema = self.client.submit("g.V().label().dedup()").all().result()
|
|
edge_schema = self.client.submit("g.E().label().dedup()").all().result()
|
|
vertex_properties = (
|
|
self.client.submit(
|
|
"g.V().group().by(label).by(properties().label().dedup().fold())"
|
|
)
|
|
.all()
|
|
.result()[0]
|
|
)
|
|
|
|
self.structured_schema = {
|
|
"vertex_labels": vertex_schema,
|
|
"edge_labels": edge_schema,
|
|
"vertice_props": vertex_properties,
|
|
}
|
|
|
|
self.schema = "\n".join(
|
|
[
|
|
"Vertex labels are the following:",
|
|
",".join(vertex_schema),
|
|
"Edge labes are the following:",
|
|
",".join(edge_schema),
|
|
f"Vertices have following properties:\n{vertex_properties}",
|
|
]
|
|
)
|
|
|
|
def query(self, query: str, params: dict = {}) -> List[Dict[str, Any]]:
|
|
q = self.client.submit(query)
|
|
return q.all().result()
|
|
|
|
def add_graph_documents(
|
|
self, graph_documents: List[GraphDocument], include_source: bool = False
|
|
) -> None:
|
|
"""
|
|
Take GraphDocument as input as uses it to construct a graph.
|
|
"""
|
|
node_cache: Dict[Union[str, int], Node] = {}
|
|
for document in graph_documents:
|
|
if include_source:
|
|
# Create document vertex
|
|
doc_props = {
|
|
"page_content": document.source.page_content,
|
|
"metadata": document.source.metadata,
|
|
}
|
|
doc_id = hashlib.md5(document.source.page_content.encode()).hexdigest()
|
|
doc_node = self.add_node(
|
|
Node(id=doc_id, type="Document", properties=doc_props), node_cache
|
|
)
|
|
|
|
# Import nodes to vertices
|
|
for n in document.nodes:
|
|
node = self.add_node(n)
|
|
if include_source:
|
|
# Add Edge to document for each node
|
|
self.add_edge(
|
|
Relationship(
|
|
type="contains information about",
|
|
source=doc_node,
|
|
target=node,
|
|
properties={},
|
|
)
|
|
)
|
|
self.add_edge(
|
|
Relationship(
|
|
type="is extracted from",
|
|
source=node,
|
|
target=doc_node,
|
|
properties={},
|
|
)
|
|
)
|
|
|
|
# Edges
|
|
for el in document.relationships:
|
|
# Find or create the source vertex
|
|
self.add_node(el.source, node_cache)
|
|
# Find or create the target vertex
|
|
self.add_node(el.target, node_cache)
|
|
# Find or create the edge
|
|
self.add_edge(el)
|
|
|
|
def build_vertex_query(self, node: Node) -> str:
|
|
base_query = (
|
|
f"g.V().has('id','{node.id}').fold()"
|
|
+ f".coalesce(unfold(),addV('{node.type}')"
|
|
+ f".property('id','{node.id}')"
|
|
+ f".property('type','{node.type}')"
|
|
)
|
|
for key, value in node.properties.items():
|
|
base_query += f".property('{key}', '{value}')"
|
|
|
|
return base_query + ")"
|
|
|
|
def build_edge_query(self, relationship: Relationship) -> str:
|
|
source_query = f".has('id','{relationship.source.id}')"
|
|
target_query = f".has('id','{relationship.target.id}')"
|
|
|
|
base_query = f""""g.V(){source_query}.as('a')
|
|
.V(){target_query}.as('b')
|
|
.choose(
|
|
__.inE('{relationship.type}').where(outV().as('a')),
|
|
__.identity(),
|
|
__.addE('{relationship.type}').from('a').to('b')
|
|
)
|
|
""".replace("\n", "").replace("\t", "")
|
|
for key, value in relationship.properties.items():
|
|
base_query += f".property('{key}', '{value}')"
|
|
|
|
return base_query
|
|
|
|
def add_node(self, node: Node, node_cache: dict = {}) -> Node:
|
|
# if properties does not have label, add type as label
|
|
if "label" not in node.properties:
|
|
node.properties["label"] = node.type
|
|
if node.id in node_cache:
|
|
return node_cache[node.id]
|
|
else:
|
|
query = self.build_vertex_query(node)
|
|
_ = self.client.submit(query).all().result()[0]
|
|
node_cache[node.id] = node
|
|
return node
|
|
|
|
def add_edge(self, relationship: Relationship) -> Any:
|
|
query = self.build_edge_query(relationship)
|
|
return self.client.submit(query).all().result()
|