Wit.NET
is the C# SDK for Wit.ai.
See the examples
folder for examples.
The default API version is 20170107
.
You can target a specific version by setting the variable WIT_API_VERSION
.
wit.net
provides a Wit class with the following methods:
Message
- the Wit message APIConverse
- the low-level Wit converse APIRunActions
- a higher-level method to the Wit converse APIInteractive
- starts an interactive conversation with your botThe Wit constructor takes the following parameters:
accessToken
- the access token of your Wit instanceactions
- (optional if you only use Message()
) the dictionary with your actionsactions
has action names as keys and action implementations as values.
A minimal example looks like this:
static void Main(string[] args)
{
var actions = new WitActions();
actions["send"] = Send;
Wit client = new Wit(accessToken: accessToken, actions: actions);
}
private static WitContext Send(ConverseRequest request, ConverseResponse response)
{
// Do something with the Context
return request.Context;
}
The Wit message API.
Takes the following parameters:
msg
- the text you want Wit.ai to extract the information fromverbose
- (optional) if set, calls the API with verbose=true
Example:
var response = client.Message("what is the weather in London?");
Console.WriteLine("Yay, got Wit.ai response: " + response)
A higher-level method to the Wit converse API.
RunActions
resets the last turn on new messages and errors.
Takes the following parameters:
sessionId
- a unique identifier describing the user sessionmessage
- the text received from the usercontext
- the dict representing the session statemaxSteps
- (optional) the maximum number of actions to execute (defaults to 5)verbose
- (optional) if set, calls the API with verbose=true
Example:
string sessionId = "my-user-session-42";
var context0 = new WitContext();
var context1 = client.RunActions(sessionId, "what is the weather in London?", context0);
Console.WriteLine("The session state is now: " + context1);
var context2 = client.RunActions(sessionId, "and in Brussels?", context1);
Console.WriteLine("The session state is now: ' + context2);
The low-level Wit converse API.
Takes the following parameters:
sessionId
- a unique identifier describing the user sessionmessage
- the text received from the usercontext
- the dict representing the session statereset
- (optional) whether to reset the last turnverbose
- (optional) if set, sets the API parameter verbose
to true
Example:
var response = client.Converse("my-user-session-42", "what is the weather in London?", new WitContext());
Console.WriteLine("Yay, got Wit.ai response: " + resp)
Starts an interactive conversation with your bot.
Example:
client.Interactive()
See the docs for more information.
If you would like to contribute to this project, just send a pull request, open an issue or email me