neo4j-aura-agent-skill

Manages the full lifecycle of Neo4j Aura Agents with AuraDB schema and CypherTemplate, SimilaritySearch, Text2Cypher tools.

101|35|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-aura-agent-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neo4j-aura-agent-skill
Source: https://github.com/neo4j-contrib/neo4j-skills/tree/main/neo4j-aura-agent-skill
Command: npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-aura-agent-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires neo4j, neo4j-graphrag, requests, python-dotenv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps teams configure and operate Neo4j Aura Agents on top of an existing AuraDB knowledge graph, so they can answer natural-language questions using GraphRAG tools without writing application glue code.

Core Features & Use Cases

  • Fetch and operationalize AuraDB schema: Retrieves AuraDB graph schema, annotates Aura-compatible property types, detects vector indexes, and prepares typed tool parameters.
  • Design and deploy Aura Agent configurations: Creates, updates, lists, retrieves, and deletes Aura Agents via the v2beta1 REST API, including system prompts, tool setups (CypherTemplate, SimilaritySearch, Text2Cypher), and REST/MCP exposure.
  • Invoke agents and validate responses: Runs test invocations using natural language and parses results for successful end-to-end agent behavior.

Quick Start

Run the schema step and then ask the agent to answer your first question by creating an Aura Agent with the right tools for your use case, using your Aura API credentials and AuraDB connection settings.

Frequently Asked Questions about neo4j-aura-agent-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and invoke Neo4j Aura Agents for GraphRAG?

You create and invoke Neo4j Aura Agents by fetching the AuraDB graph schema, configuring tools like CypherTemplate and Text2Cypher, and managing the agent lifecycle through the v2beta1 REST API.

What is the best way to equip a graph database agent with vector search?

To equip a graph database agent with vector search, you configure SimilaritySearch tools by detecting ONLINE vector indexes from your AuraDB instance and preparing typed tool parameters for the agent.

Do I need OAuth2 authentication to manage Neo4j Aura Agents?

Yes, you need OAuth2 authentication to access the Aura API, along with proper Aura org/project scoping and AuraDB connectivity settings to validate schema readiness and manage agents.

How do I operationalize AuraDB schema for natural-language queries?

You operationalize AuraDB schema by retrieving graph structures, annotating Aura-compatible property types, detecting vector indexes, and validating schema readiness including nodes and relationship types.

Can I use CypherTemplate for deterministic lookups in a GraphRAG agent?

Yes, you can use CypherTemplate for deterministic lookups alongside SimilaritySearch for vector-based retrieval and Text2Cypher for open-ended discovery and aggregations within your Aura Agent configuration.

What are the limitations when configuring agents with the Aura API?

Limitations include requiring existing Aura API credentials, AuraDB connectivity settings, and validated schema readiness with defined nodes and relationship types before agent creation and invocation can proceed.