Difference between revisions of "Bot Playground/AI/Bot.AI.chat"
From SmartBots Developers Docs
| Line 44: | Line 44: | ||
{{API Variables Table End}} | {{API Variables Table End}} | ||
| + | |||
| + | |||
| + | <blockquote> | ||
| + | * Note: The `instructions` and `maxResponseTokens` settings are hard-coded in user settings. They do not need to be explicitly created for user settings. Instead, these values should be fetched from `userSettings.instructions` and `userSettings.maxResponseTokens` and included in the configuration. | ||
* In case of error functions throws an error with a message. | * In case of error functions throws an error with a message. | ||
| + | </blockquote> | ||
{{NavMenu}} | {{NavMenu}} | ||
Latest revision as of 11:15, 22 January 2025
Sends a chat message request to bot AI.
Bot.AI.chat(message, senderName[, options])
Reference
This command accepts the following parameters:
| Variable | Required | Description
| |
|---|---|---|---|
| Input: | |||
| message | yes | chat message to the bot | |
| residentName | yes | The name of the resident sending the message | |
| options | optional | The name of the resident sending the message Format:
{
instructions?: string;
// Previous messade ID, if responding to a particular previous AI message of the bot
parentMessageId?: string;
// Maximum number of tokens to generate in response
maxResponseTokens?: number;
// Max number of response in bytes. SL IM has a max limit of 1023bytes.
maxResponseBytes?: number;
}
| |
| Output: | |||
| text | The response of the bot | ||
| messageId | The id of the response message. Can be specified as parentMessageId later | ||
| usage | The object which contains Token Usage. Format: The object which contains all groups. Format:
{
// Number of tokens in a request (message + instructions + history)
prompt_tokens: number;
// Number of tokens in a response
completion_tokens: number;
// Total tokens used
total_tokens: number;
// Tokens left on SmartBots AI balance
tokens_left: number;
}
| ||
- Note: The `instructions` and `maxResponseTokens` settings are hard-coded in user settings. They do not need to be explicitly created for user settings. Instead, these values should be fetched from `userSettings.instructions` and `userSettings.maxResponseTokens` and included in the configuration.
- In case of error functions throws an error with a message.
