more content and images

Author: AlexicaWright

modules/ROOT/images/cypher-template.jpg

@@ -30,7 +30,7 @@ The more detailed you are in the description and prompt instructions, the better
 Then you need to specify which AuraDB instance the agent should target.
 Keep in mind that the selected instance *must* be running.
 
-You can make the agen external right away, but it is recommended to keep it internal while testing it.
+You can make the agent externally available right away, but it is recommended to keep it internal while testing it.
 You can change the agent's availability at any time.
 
 Then you can start adding the tools that will allow your agent to retrieve specific data from your graph, or to convert questions to Cypher queries.
@@ -39,6 +39,49 @@ The tools are described in detail in the following section.
 
 == Tools
 
+Aura Agent has three tools available:
+
+* *Cypher Template*
+* *Text2Cypher*
+* *Similarity Search*
+
+Consider your dataset and its underlying datamodel when you configure the tools to ensure your agent has access to the right ways of retrieving *only* the right information.
+
+=== Cypher Template
+
+This tool executes pre-defined, parameterized Cypher queries against the database and returns the results to the agent.
+The values for the parameters are provided by the user.
+It works in the same way as other Cypher queries you write but are reusable by the agent.
+
+This tool is best for:
+
+* Common and repeated questions
+* Predictable results
+* Complex queries
+* Well-defined business logic patterns
+
+You need to provide a *name* and a *description* for the tool.
+Again, the better the description, the better your agent will perform.
+If your query contains *parameters*, these need to be defined with a *name*, *data type*, and *description*.
+
+[.shadow]
+.Cypher Template tool
+image::cypher-template.jpg[width=400]
+
+For best performance, make sure that the query:
+
+* returns only relevant information
+* returns only select node and relationship properties
+* does not return embeddings or graph elements like node/relationship/paths
+* does not return duplicates
+
+Additionally, it is advisable to limit the results to 10-50 rows to keep the results relevant.
+Also, always test the Cypher statement to make sure they work as expected.
+
+
+
+
+