Chat with Chatbot
In this section, we will guide you on how to start chatting with your chatbot using the GPT-trainer API. Before you begin, please ensure you meet the following prerequisites:
Prerequisites
- An API key for accessing the GPT-trainer API.
- A development environment or tool for making HTTP requests, such as Curl or a programming language like Python.
Please note that to chat on specific topics, your chatbot needs to have relevant data sources uploaded.
Start with creating a chat session
Why Create a Chat Session?
Before sending messages to the chatbot, it’s essential to create a chat session. A chat session acts as a container that holds all the messages exchanged between you and the chatbot. Here’s why creating a chat session is necessary:
-
Message Context: A chat session allows you to maintain context throughout a conversation. It ensures that the chatbot understands the context of your questions or statements.
-
Order of Messages: The chat session helps in maintaining the order of messages. This is crucial for having meaningful and coherent conversations with the chatbot.
-
State Management: The chat session allows you to manage the state of the conversation. You can continue a conversation seamlessly by referencing the same session UUID.
Create a chat session
To create a chat session, you need to use a POST request to the API endpoint: https://app.gpt-trainer.com/api/v1/chatbot/{chatbot_uuid}/session/create
.
Make sure to replace {chatbot_uuid}
with the UUID of your chatbot.
Example Request
Here’re example command to create a chatbot using the GPT-trainer API:
This API request returns JSON data that you can reuse to send messages:
{
"created_at": "string",
"modified_at": "string",
"uuid": "string"
}
The uuid from this response is essential for sending messages within the established chat session. It will be used in the following steps.
Chat Within a Session
Send Messages
With a chat session created, you can now send messages to your chatbot.
Use the following API endpoint to send messages and get a streamed AI response:
https://app.gpt-trainer.com/api/v1/session/{session_uuid}/message/stream
Make sure to replace {session_uuid}
with the uuid
obtained from the chat
session creation response
Example Request
Here’re example command to create a message using the GPT-trainer API:
That’s it! You’ve now learned how to chat with your own chatbot using the GPT-trainer API.