uSync.AI.Tools 17.0.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package uSync.AI.Tools --version 17.0.0
                    


                    

                
NuGet\Install-Package uSync.AI.Tools -Version 17.0.0
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="uSync.AI.Tools" Version="17.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="uSync.AI.Tools" Version="17.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="uSync.AI.Tools" />
                    


                            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 uSync.AI.Tools --version 17.0.0
                    


                    

                
#r "nuget: uSync.AI.Tools, 17.0.0"
#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 uSync.AI.Tools@17.0.0
#: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=uSync.AI.Tools&version=17.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=uSync.AI.Tools&version=17.0.0
                    


                            Install as a Cake Tool

uSync.AI.Tools

Umbraco.AI agent tools that run uSync. Give them to an agent and an editor can ask "what would an import change?" or "export the settings".

Most sites want the uSync.AI package, which installs this alongside AI settings sync.

Tools

Tool Scope What it does
usync_list_handlers usync-read Lists the uSync handlers and their groups
usync_report usync-read Compares the uSync files with the site. Changes nothing
usync_export usync-write Writes the site's items to the uSync folder
usync_import usync-write Applies the uSync files to the site

Report, export and import take an optional handler group (Settings, Content, AI...) or a list of handler aliases. Import can also be forced.

A tool is only available to an agent that has been given it, or its scope, in the agent's settings. Nothing is switched on by installing this package.

Who can run them

Each tool checks the backoffice user the agent is acting for before it does anything. The agent's own settings can't override this.

Needs
Any tool Access to the Settings section (or the uSync section), the same as the uSync dashboard
usync_import Also an administrator
No signed-in user Refused. An agent run from a schedule or an automation can't use these tools

Export and import are marked destructive, so Umbraco.AI asks the user to approve each call, and the prompt says what will run.

Only one uSync operation runs at a time. A second is refused, not queued.

Options

{
  "uSync": {
    "AI": {
      "Tools": {
        "RequireAdminForImport": true,
        "MaxChanges": 50
      }
    }
  }
}
  • RequireAdminForImport (default true): set to false to let anyone with uSync access import through an agent, as the uSync dashboard does.
  • MaxChanges (default 50): how many changed or failed items a tool lists for the model. Counts are always complete.
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 (2)

Showing the top 2 NuGet packages that depend on uSync.AI.Tools:

Package Downloads
uSync.AI.Complete

Push and pull Umbraco.AI settings, prompts and agents between servers with uSync.Complete, and Umbraco.AI agent tools that drive the uSync.Complete publisher.
uSync.AI

uSync for Umbraco.AI. Installs settings, prompt and agent sync plus the uSync agent tools.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
17.0.0 52 10/8/2026