/// <summary>
/// Create a session.
///
/// Create a new session. A session is used to send user input to a skill and receive responses. It also
/// maintains the state of the conversation.
/// </summary>
/// <param name="successCallback">The function that is called when the operation is successful.</param>
/// <param name="failCallback">The function that is called when the operation fails.</param>
/// <param name="assistantId">Unique identifier of the assistant. You can find the assistant ID of an assistant
/// on the **Assistants** tab of the Watson Assistant tool. For information about creating assistants, see the
/// [documentation](https://cloud.ibm.com/docs/services/assistant/create-assistant.html#creating-assistants).
///
/// **Note:** Currently, the v2 API does not support creating assistants.</param>
/// <returns><see cref="SessionResponse" />SessionResponse</returns>
/// <param name="customData">A Dictionary<string, object> of data that will be passed to the callback. The raw
/// json output from the REST call will be passed in this object as the value of the 'json'
/// key.</string></param>
public bool CreateSession(SuccessCallback <SessionResponse> successCallback, FailCallback failCallback, String assistantId, Dictionary <string, object> customData = null)
{
if (successCallback == null)
{
throw new ArgumentNullException("successCallback is required for CreateSession");
}
if (failCallback == null)
{
throw new ArgumentNullException("failCallback is required for CreateSession");
}
if (string.IsNullOrEmpty(assistantId))
{
throw new ArgumentException("assistantId is required for CreateSession");
}
CreateSessionRequestObj req = new CreateSessionRequestObj();
req.SuccessCallback = successCallback;
req.FailCallback = failCallback;
req.HttpMethod = UnityWebRequest.kHttpVerbPOST;
req.DisableSslVerification = DisableSslVerification;
req.CustomData = customData == null ? new Dictionary <string, object>() : customData;
if (req.CustomData.ContainsKey(Constants.String.CUSTOM_REQUEST_HEADERS))
{
foreach (KeyValuePair <string, string> kvp in req.CustomData[Constants.String.CUSTOM_REQUEST_HEADERS] as Dictionary <string, string> )
{
req.Headers.Add(kvp.Key, kvp.Value);
}
}
req.Headers["Content-Type"] = "application/json";
req.Parameters["version"] = VersionDate;
req.OnResponse = OnCreateSessionResponse;
req.Headers["X-IBMCloud-SDK-Analytics"] = "service_name=conversation;service_version=v2;operation_id=CreateSession";
RESTConnector connector = RESTConnector.GetConnector(Credentials, string.Format("/v2/assistants/{0}/sessions", assistantId));
if (connector == null)
{
return(false);
}
return(connector.Send(req));
}
/// <summary>
/// Create a session.
///
/// Create a new session. A session is used to send user input to a skill and receive responses. It also
/// maintains the state of the conversation.
/// </summary>
/// <param name="successCallback">The function that is called when the operation is successful.</param>
/// <param name="failCallback">The function that is called when the operation fails.</param>
/// <param name="assistantId">Unique identifier of the assistant. You can find the assistant ID of an assistant
/// on the **Assistants** tab of the Watson Assistant tool. For information about creating assistants, see the
/// [documentation](https://console.bluemix.net/docs/services/assistant/create-assistant.html#creating-assistants).
///
/// **Note:** Currently, the v2 API does not support creating assistants.</param>
/// <returns><see cref="SessionResponse" />SessionResponse</returns>
/// <param name="customData">A Dictionary<string, object> of data that will be passed to the callback. The raw
/// json output from the REST call will be passed in this object as the value of the 'json'
/// key.</string></param>
public bool CreateSession(SuccessCallback <SessionResponse> successCallback, FailCallback failCallback, String assistantId, Dictionary <string, object> customData = null)
{
if (successCallback == null)
{
throw new ArgumentNullException("successCallback");
}
if (failCallback == null)
{
throw new ArgumentNullException("failCallback");
}
CreateSessionRequestObj req = new CreateSessionRequestObj();
req.SuccessCallback = successCallback;
req.FailCallback = failCallback;
req.CustomData = customData == null ? new Dictionary <string, object>() : customData;
if (req.CustomData.ContainsKey(Constants.String.CUSTOM_REQUEST_HEADERS))
{
foreach (KeyValuePair <string, string> kvp in req.CustomData[Constants.String.CUSTOM_REQUEST_HEADERS] as Dictionary <string, string> )
{
req.Headers.Add(kvp.Key, kvp.Value);
}
}
req.Headers["Content-Type"] = "application/json";
req.Parameters["version"] = VersionDate;
req.OnResponse = OnCreateSessionResponse;
req.Post = true;
RESTConnector connector = RESTConnector.GetConnector(Credentials, string.Format("/v2/assistants/{0}/sessions", assistantId));
if (connector == null)
{
return(false);
}
return(connector.Send(req));
}
