(Node.js) Prove Stateful Multi-Turn Conversation

See more AI Examples

Note: This example requires Chilkat v11.2.0 or greater.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOS

var os = require('os');
if (os.platform() == 'win32') {  
  var chilkat = require('@chilkat/ck-node23-win64'); 
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node23-linux-arm');
    } else if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node23-linux-arm64');
    } else {
        var chilkat = require('@chilkat/ck-node23-linux-x64');
    }
} else if (os.platform() == 'darwin') {
  var chilkat = require('@chilkat/ck-node23-mac-universal');
}

function chilkatExample() {

    var success = false;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var ai = new chilkat.Ai();

    // The provider can be "openai", "google", "claude", "deepseek", "xai", or "perplexity".
    // Support for additional providers will be added in future versions of Chilkat.
    ai.Provider = "google";

    // Use your provider's API key.
    ai.ApiKey = "MY_API_KEY";

    // Choose a model.
    ai.Model = "gemini-2.5-flash";

    // Create a new conversation to be maintained locally in memory.
    // If the conversation is the first to be created, it is also automatically selected.
    var systemMsg = "You are a helpful assistant";
    var developerMsg = "";
    var conversationName = "test_conversation";
    ai.NewConvo(conversationName,systemMsg,developerMsg);

    // -------------------------------------------------------------------------------------------
    // Our first request will establish a secret that we'll ask for in the 2nd request.
    // Add a text input.
    ai.InputAddText("Please remember this: The word I'll ask for later is BlubberFish.  What's the word?");

    // Ask the AI for text output.
    success = ai.Ask("text");
    if (success == false) {
        console.log(ai.LastErrorText);
        return;
    }

    // Note: The inputs accumulated through one or more calls to Input* methods are cleared when the Ask method returns with success.

    // Get the text response.
    var sbResponse = new chilkat.StringBuilder();
    ai.GetOutputTextSb(sbResponse);
    console.log(sbResponse.GetAsString());
    console.log("----");

    // Sample output:

    // The word is **BlubberFish**.

    // -------------------------------------------------------------------------------------------
    // Let's ask for the word. If this is a stateful conversation, the AI should respond correctly.
    ai.InputAddText("OK, I'm going to ask you again, what's the word?");
    success = ai.Ask("text");
    if (success == false) {
        console.log(ai.LastErrorText);
        return;
    }

    // Get the text response.
    sbResponse.Clear();
    ai.GetOutputTextSb(sbResponse);
    console.log(sbResponse.GetAsString());

    // Sample output:

    // The word is **BlubberFish**.

    // -------------------------------------------------------------------------------------------
    // Look at the conversation so far...
    // 
    var json = new chilkat.JsonObject();
    ai.ExportConvo(conversationName,json);
    json.EmitCompact = false;
    console.log(json.Emit());

    // Note: The conversation transcript format exported and imported by Chilkat is always the OpenAI format,
    // regardless of the AI provider.  (Chilkat translates the format from OpenAI to whatever is needed by the actual AI provider being used.)

    // {
    //   "input": [
    //     {
    //       "role": "system",
    //       "content": [
    //         {
    //           "type": "input_text",
    //           "text": "You are a helpful assistant"
    //         }
    //       ]
    //     },
    //     {
    //       "role": "user",
    //       "content": [
    //         {
    //           "type": "input_text",
    //           "text": "Please remember this: The word I'll ask for later is BlubberFish.  What's the word?"
    //         }
    //       ]
    //     },
    //     {
    //       "role": "assistant",
    //       "content": [
    //         {
    //           "type": "output_text",
    //           "text": "The word is **BlubberFish**."
    //         }
    //       ]
    //     },
    //     {
    //       "role": "user",
    //       "content": [
    //         {
    //           "type": "input_text",
    //           "text": "OK, I'm going to ask you again, what's the word?"
    //         }
    //       ]
    //     },
    //     {
    //       "role": "assistant",
    //       "content": [
    //         {
    //           "type": "output_text",
    //           "text": "The word is **BlubberFish**."
    //         }
    //       ]
    //     }
    //   ]
    // }

    // -------------------------------------------------------------------------------------------
    // If we unselect the conversation, so that no conversation is selected,
    // then the same query results in the AI not knowing the word.

    ai.SelectedConvo = "";

    ai.InputAddText("OK, I'm going to ask you again, what's the word?");
    success = ai.Ask("text");
    if (success == false) {
        console.log(ai.LastErrorText);
        return;
    }

    // Get the text response.
    sbResponse.Clear();
    ai.GetOutputTextSb(sbResponse);
    console.log(sbResponse.GetAsString());

    // Sample output:

    // I apologize, but I don't have the context of our previous interaction or what "the word" you're referring to might be.
    // Could you please remind me or provide the clue again? I'm ready to help you figure it out!

}

chilkatExample();