Building a Simple Command

To build a command for nsquared agents, create a .NET 10 class library with a class that implements the IAgentCommand interface. Use the latest stable nsquared.agents.api NuGet package.

The full source code for this example

Step-by-Step creating a simple nsquared agent Command

Start by creating a new C# class library project named SimpleCommand.
```
 dotnet new classlib --name SimpleCommand
```
This will create a new folder named SimpleCommand containing C# project named SimpleCommand, and a code file named Class1.cs.
Rename the file Class1.cs to Command.cs

Rename the class in the code to Command

 namespace SimpleCommand;
 public class Command
 {
 }

In the SimpleCommand.csproj file set the framework and command file extension:

 <TargetFramework>net10.0</TargetFramework>
 <TargetExt>.Command</TargetExt>

Add the API package:
```
dotnet add package nsquared.agents.api
```
In the Command.cs file add a using to import the nsquared.agents namespace
```
 using nsquared.agents;
```
In the Command.cs file implement the IAgentCommand interface in the Command class
```
 public class Command : IAgentCommand
```

Add the required methods to the Command class

 using nsquared.agents;

 namespace SimpleCommand;
 public class Command : IAgentCommand
 {
     public string Name => "SimpleCommand";

     public bool HasSettings => false;
     public AgentCommandType CommandType => AgentCommandType.KeywordLocal;

     public Task<string?> Perform(string commandRequest, IAgentAnimations? animations)
     {
         if (commandRequest.Contains("simple", StringComparison.CurrentCultureIgnoreCase))
         {
             animations?.Animate("Announce");
             return Task.FromResult<string?>("I am doing a simple command!");
         }
         return Task.FromResult<string?>(null);
     }
 }

Build the SimpleCommand project. It produces SimpleCommand.Command in the build output folder. This example has no additional dependencies and can be installed as a single file. If your command uses additional NuGet packages, include its assembly and required dependency DLLs in a flat .zip file with exactly one .Command file at the archive root. The running application accepts either the .Command file or ZIP from Settings > Manage Commands.
Run the nsquared agents application and open Settings, and then go to Manage Commands
In the Commands select Add
Find the SimpleCommand.Command file you have built.
Invoke the SimpleCommand by using the keyword simple in your request

Doing a simple command

The full source code for this example

Building a Command with Settings

Building a Skill