-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Dan Selman <danscode@selman.org>
- Loading branch information
Showing
15 changed files
with
62 additions
and
125 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,68 +1,28 @@ | ||
| **@accordproject/concerto-graph** • [**Docs**](globals.md) | ||
| **@accordproject/concerto-graph** • **Docs** | ||
|
|
||
| *** | ||
|
|
||
| # Concerto Graph | ||
| # @accordproject/concerto-graph | ||
|
|
||
| This project uses a [Concerto model](https://concerto.accordproject.org) to define the nodes and edges in a Neo4J graph database and uses the model to validate the properties on the nodes. | ||
| ## Classes | ||
|
|
||
|  | ||
| [Demo](src/demo/index.ts) | ||
| - [GraphModel](classes/GraphModel.md) | ||
|
|
||
| In a few lines of code you can define a Concerto data model validated graph and perform a vector similarity search over | ||
| nodes with text content. | ||
| ## Type Aliases | ||
|
|
||
| Concerto model (snippet): | ||
| - [Context](type-aliases/Context.md) | ||
| - [GraphModelOptions](type-aliases/GraphModelOptions.md) | ||
| - [GraphNodeProperties](type-aliases/GraphNodeProperties.md) | ||
| - [SimilarityResult](type-aliases/SimilarityResult.md) | ||
|
|
||
| ``` | ||
| concept Movie extends GraphNode { | ||
| @vector_index("summary", 1536, "COSINE") | ||
| o Double[] embedding optional | ||
| @embedding | ||
| o String summary optional | ||
| @label("IN_GENRE") | ||
| --> Genre[] genres optional | ||
| } | ||
| ``` | ||
| ## Variables | ||
|
|
||
| TypeScript code: | ||
| - [ROOT\_MODEL](variables/ROOT_MODEL.md) | ||
| - [ROOT\_NAMESPACE](variables/ROOT_NAMESPACE.md) | ||
|
|
||
| ```typescript | ||
| await graphModel.mergeNode(transaction, `${NS}.Movie`, {identifier: 'Brazil', summary: 'The film centres on Sam Lowry, a low-ranking bureaucrat trying to find a woman who appears in his dreams while he is working in a mind-numbing job and living in a small apartment, set in a dystopian world in which there is an over-reliance on poorly maintained (and rather whimsical) machines'} ); | ||
|
|
||
| await graphModel.mergeNode(transaction, `${NS}.Genre`, {identifier: 'Comedy'} ); | ||
|
|
||
| await graphModel.mergeRelationship(transaction, `${NS}.Movie`, 'Brazil', `${NS}.Genre`, 'Comedy', 'genres' ); | ||
|
|
||
| await graphModel.mergeNode(transaction, `${NS}.Director`, {identifier: 'Terry Gilliam'} ); | ||
| await graphModel.mergeRelationship(transaction, `${NS}.Director`, 'Terry Gilliam', `${NS}.Movie`, 'Brazil', 'directed' ); | ||
|
|
||
| await graphModel.mergeNode(transaction, `${NS}.Actor`, {identifier: 'Jonathan Pryce'} ); | ||
| await graphModel.mergeRelationship(transaction, `${NS}.Actor`, 'Jonathan Pryce', `${NS}.Movie`, 'Brazil', 'actedIn' ); | ||
|
|
||
| const search = 'Working in a boring job and looking for love.'; | ||
| const results = await graphModel.similarityQuery(`${NS}.Movie`, 'embedding', search, 3); | ||
| ``` | ||
| ## Functions | ||
|
|
||
| Runtime result: | ||
|
|
||
| ```json | ||
| [ | ||
| { | ||
| identifier: 'Brazil', | ||
| content: 'The film centres on Sam Lowry, a low-ranking bureaucrat trying to find a woman who appears in his dreams while he is working in a mind-numbing job and living in a small apartment, set in a dystopian world in which there is an over-reliance on poorly maintained (and rather whimsical) machines', | ||
| score: 0.901830792427063 | ||
| } | ||
| ] | ||
| ``` | ||
|
|
||
| ## Environment Variables | ||
|
|
||
| ### GraphDB | ||
|
|
||
| - NEO4J_URL: the NEO4J URL. E.g. `neo4j+s://<DB_NAME>.databases.neo4j.io` if you are using AuraDB. | ||
| - NEO4J_PASS: your neo4j password. | ||
| - NEO4J_USER: <optional> defaults to `neo4j` | ||
|
|
||
| ### Text Embeddings | ||
| - OPENAI_API_KEY: <optional> the OpenAI API key. If not set embeddings are not computed and written to the agreement graph and similarity search, natural language to Cypher generation ("chat with data") is not possible. | ||
| - [getObjectChecksum](functions/getObjectChecksum.md) | ||
| - [getOpenAiEmbedding](functions/getOpenAiEmbedding.md) | ||
| - [getTextChecksum](functions/getTextChecksum.md) | ||
| - [textToCypher](functions/textToCypher.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.