Graphene.ErpTool 1.26.9.11

dotnet add package Graphene.ErpTool --version 1.26.9.11
                    
NuGet\Install-Package Graphene.ErpTool -Version 1.26.9.11
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Graphene.ErpTool" Version="1.26.9.11" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Graphene.ErpTool" Version="1.26.9.11" />
                    
Directory.Packages.props
<PackageReference Include="Graphene.ErpTool" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Graphene.ErpTool --version 1.26.9.11
                    
#r "nuget: Graphene.ErpTool, 1.26.9.11"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Graphene.ErpTool@1.26.9.11
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Graphene.ErpTool&version=1.26.9.11
                    
Install as a Cake Addin
#tool nuget:?package=Graphene.ErpTool&version=1.26.9.11
                    
Install as a Cake Tool

ErpTool

Agent tool for AIOrchestrator that lets an LLM drive a WebVella-style ERP (the AI.Erp fork or upstream WebVella.Erp) with full control: discover the data model, run EQL queries, create/update/delete records and manage many-to-many relations — all over a JWT-secured REST API.

ErpTool is a plugin tool: it ships as a GitHub Release zip (host deployment into Tools/ErpTool/) and as the NuGet package Graphene.ErpTool. It derives from BaseAgentTool; its public methods are rendered to the LLM as the snake_case methods below.

Methods (agent surface)

Method Purpose
get_schema(entity?) Discover entities and fields (name, label, type, required). Call first.
query(eql, parameters?) Run an EQL SELECT (read-only) with named parameters.
create_record(entity, fields) Create a record from a JSON object of field values.
update_record(entity, id, fields) Update a record by id (only the given fields change).
delete_record(entity, id) Delete a record by id.
manage_relation(relationId, originId, targetId, remove) Add/remove a many-to-many link.

Every operation runs as the configured ERP user, so the ERP's own per-entity permissions, hooks and validation apply. ErpTool is not a database client — it never bypasses the ERP.

Configuration (host-provided, never agent-provided)

Connection settings are resolved in this order:

  1. Environment variables — ERP_BASE_URL, ERP_USER, ERP_PASSWORD.
  2. PersistentData/erp.json in the host's base directory (a folder updates never touch):
{
  "baseUrl": "https://erp.example.com",
  "user": "agent@example.com",
  "password": "••••••"
}

If none is set, every method returns a clear Error: explaining what to configure.

ERP-side requirement

The tool talks to the AgentApi plugin (AI.Erp.Plugins.AgentApi), which must be installed on the ERP and registered in its host site. The plugin is dual-target — the same source builds for the AI.Erp fork and for upstream WebVella.Erp. See the plugin's ARCHITECTURE.md for the fork/vendor duality (global using aliases + an ErpFlavor build switch). ErpTool itself is target-agnostic: it is pure HTTP against a stable REST contract.

Install (hosts)

Drop the release zip into Tools/ErpTool/; the host discovers it at startup (or hot-adds it). The plugin ships only its own files — the AIOrchestrator dependency graph is provided by the host.

License

See LICENSE.md.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.26.9.11 51 9/11/2026