# Hello World Bot Creation Guide

This document provides a structured guide for developing the "Hello World Bot" within the ix Hello platform using Studio Mode. This process leverages Generative AI capabilities for efficient question answering.

### Prerequisites

1. Before commencing bot creation, ensure the following prerequisites are met:
   1. Access to ix Hello [Studio ](https://bots.ixhello.com)Mode
   2. Familiarity with basic ix Hello navigation.
2. Step-by-Step Implementation : The following steps outline the creation of the "Hello World Bot":
3. Generative AI-Connection

* Navigate to Integration > Connect System.
* Click Add New Connection.

<figure><img src="/files/kawXe1eT3vBmx9cVbOMg" alt="" width="563"><figcaption></figcaption></figure>

* Select Generative AI from the dropdown menu and click Next.

<figure><img src="/files/ltgHWntYuGjJBRJjS9nN" alt="" width="563"><figcaption></figcaption></figure>

* Provide a descriptive instance name (e.g., genAI\_instance).
* Click Save Settings. A successful connection will be indicated.

<figure><img src="/files/WyxE8mNT2Mr4dKndhDQj" alt=""><figcaption></figcaption></figure>

2. Content Category Creation

* Navigate to Content > Content Categories.
* Click Add New Category.

<figure><img src="/files/W4trt59rftuP0x90s2AQ" alt="" width="563"><figcaption></figcaption></figure>

* Enter a unique category name (e.g., Hello World Category).
* Provide a concise description (e.g., "Category for Hello World Bot"). An optional content icon can be added.
* Click Add.

<figure><img src="/files/9tOryi3rfDloSbiMQMkY" alt="" width="563"><figcaption></figcaption></figure>

3. Custom App Development

* Navigate to Apps > Custom Apps.
* Click New Custom App.

<figure><img src="/files/fLP2OejShetfpz95msgl" alt="" width="563"><figcaption></figcaption></figure>

* Enter the following details:
  * Name: Hello World Bot
  * Custom App Type: Search
  * Category: Select the Hello World Category created in the previous step.
  * Check the box: This is a Generative AI App
  * Click Save

<figure><img src="/files/DNdEcoICEx3QFh2FO8kP" alt="" width="563"><figcaption></figcaption></figure>

4. Data Source Configuration

* Within your newly created Custom App, navigate to the Data Sources tab.
* Click Create New Data Source.

<figure><img src="/files/Ajlgv5B9mBWfSRCyd6On" alt="" width="563"><figcaption></figcaption></figure>

* Enter the following:
  * Name: genAIdataSource
  * Integration Configuration: Select your Generative AI connection (created in Step 1).
  * Click Save

<figure><img src="/files/HtUMWFzq5kbr6sNbh4Ku" alt="" width="563"><figcaption></figcaption></figure>

5. Method Definition

* In your Custom App, navigate to the Methods tab
* Click Create New Method

<figure><img src="/files/Rby4F3wvrXBT0yh0fT5S" alt="" width="563"><figcaption></figcaption></figure>

* Enter:
  * Method Name: chatcompletion
  * Request Type: chatcompletion
* Configure the parameters:
  * Model: Select your preferred Generative AI model (e.g., OpenAI gpt-4).
  * *Sample systemMessage: Provide instructions for the bot's behavior (e.g., "You are the Hello World Bot. Answer the following question: What is the capital of India?").*
  * userQuestion: {{UserInput}}
  * streaming: False
  * sessionTime: 10
  * OrganizationID: {{Context.OrganizationID}}
  * EmployeeID: {{Context.EmployeeID}}

<figure><img src="/files/5MJufV8RueFssQkECpI5" alt="" width="563"><figcaption></figcaption></figure>

* Configure Method Output:
  * Result Type: ListofRecords
  * Record Limit: 10

<figure><img src="/files/YiJ085wA6UXpty9xKYQ6" alt="" width="563"><figcaption></figcaption></figure>

* Configure Method Result:
  * Record JsonPath: $.choices\[0].message
  * Valid Result Template: {{Records}}
  * Record Template: {{content}}
  * Empty Result Template: "Is there anything else I can assist you with?"
  * Uncheck: Automatically prompt for next question
  * Click Save & Test. This will initiate a test API call

<figure><img src="/files/1RVd98QmzNpiAZ7Jys5T" alt="" width="563"><figcaption></figcaption></figure>

Results:

<figure><img src="/files/6pmbCKfc43mpMyObbyZT" alt="" width="563"><figcaption></figcaption></figure>

6. Retrieving Employee and Organization IDs

* Navigate to Account Setup > Profile.
* Locate and copy your EmployeeID and OrganizationID.
* Paste these IDs into the corresponding parameter fields in the test method dialog (Step 5).

<figure><img src="/files/nYzf4HltRaAxQcmw1j9f" alt=""><figcaption></figcaption></figure>

7. Intent Creation

* In your Custom App, navigate to the Intents tab
* Click Create New Intent

<figure><img src="/files/PNI0xlQ1hoRDncvYW7rC" alt="" width="563"><figcaption></figcaption></figure>

* Enter:
  * Name: HelloWorldIntent
  * Intent Type: Search
  * Intent Action: Execute Method
  * Data Source: genAIdataSource
  * Data Source Method: chatcompletion
  * Dialog Delegation Strategy: ManualDelegation
  * Check the checkbox for Set this intent as a fallback Intent.
  * Click Save.

<figure><img src="/files/Xp7EAL3pgRCLnKGiRHCh" alt="" width="563"><figcaption></figcaption></figure>

8. Slot Creation

* In your Custom App, navigate to the Slots tab.
* Click Create New Slot.

<figure><img src="/files/V9o88Sr80Zumj7YjfQnE" alt="" width="563"><figcaption></figcaption></figure>

* Enter:
  * Name: UserInput
  * Slot Order: 1
  * Type: Text
  * CustomApp: Hello World Bot
  * Intent: HelloWorldIntent
  * Click Save.

<figure><img src="/files/2mhq91ZTPPbWOVDkEiy1" alt="" width="563"><figcaption></figcaption></figure>

9. Utterance Definition

* In your Custom App, navigate to the Utterances tab.
* Click Create New Utterance.

<figure><img src="/files/pjZhNBdmjk8E8gsizh3K" alt="" width="563"><figcaption></figcaption></figure>

* Enter:
  * Value: "What is the capital of India?"
  * Intent: HelloWorldIntent
  * Click Save

<figure><img src="/files/sTqM9ho9zyypYoFosZqE" alt="" width="563"><figcaption></figcaption></figure>

10. Input Configuration

* In your Custom App, navigate to the Input tab.
* Click Create New Input.

<figure><img src="/files/5t70yqHMeCmxCNU9GSdX" alt=""><figcaption></figcaption></figure>

* Enter:
  * Name: ChatInput
  * Custom Intent: HelloWorldIntent
  * Data Source: genAIdataSource
  * Data Source Method: chatcompletion
  * Click Save.

<figure><img src="/files/Wh1aNt8qd98QlQ34lr06" alt="" width="563"><figcaption></figcaption></figure>

* Add input parameter:
  * Input Parameter Name: UserInput
  * Parameter: UserInput
  * Data Type: Text
  * Click Save.

<figure><img src="/files/qJJArkt5Y1LJe2R0CsqJ" alt="" width="563"><figcaption></figcaption></figure>

11. Application Publishing

* In your Custom App, navigate to the Publish tab.
* Click Add App Publishing.

<figure><img src="/files/Q3f2dWdc1p0TpjG0G9fo" alt="" width="563"><figcaption></figcaption></figure>

* Enter:
  * External App Name: (Choose a descriptive name, e.g., Hello World Bot)
  * App Description: (Provide a brief description, e.g., "A bot that answers basic questions about the Hello World tutorial.")
  * App Type: Search
  * Channel: Generative AI
  * Check: Enable API Access (Optional: Check boxes for basic/showcase mode visibility)
  * Click Save.

<figure><img src="/files/Qmg28G9eFfdXd5f3eetU" alt="" width="563"><figcaption></figcaption></figure>

Testing

Thoroughly test your newly published Hello World Bot to ensure functionality and accuracy. Use various questions to confirm that the bot provides the correct responses.

<figure><img src="/files/Dqe6puAS95tjT1lJl96Q" alt="" width="563"><figcaption></figcaption></figure>

Conclusion

This guide provides a foundation for building the Hello World Bot. Ensure to refer to the ix Hello documentation for more advanced features and customization options. If you experience any issues or require further assistance, do not hesitate to reach out to your support team.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ixhello.com/ixhc/step-by-step-bot-creation-guide/hello-world-bot-creation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
