Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vizochok.com/llms.txt

Use this file to discover all available pages before exploring further.

VIZOCHOK lets you customize the AI assistant’s behavior per tenant without writing any code. All customization is managed through the Admin Panel under Settings.
These settings are also available via the REST API — see the API Reference tab for programmatic access.

​
Prompt Configuration

Navigate to Settings > Prompt in the Admin Panel. The AI’s system prompt is built from five customizable fields:
FieldMax LengthPurpose
bot_name—The assistant’s display name (default: “Помічник”)
personality1,000 charsTone, style, and character traits
store_rules2,000 charsStore-specific policies and instructions
greeting500 charsFirst-message greeting template
forbidden_topics1,000 charsTopics the bot should never discuss

​
Customization Fields in Detail

​
Bot Name

The name used in the system prompt and displayed in the chat header. Choose a name that fits your brand.
The bot name in Settings controls how the AI refers to itself. The SDK botName config option controls the UI display name. Set both to the same value for consistency.

​
Personality

Defines the AI’s tone and communication style. The AI follows these instructions throughout the conversation. Good personality prompts are:
  • Specific: “Use short sentences, max 2 sentences per message” vs “Be concise”
  • Behavioral: “Always suggest a complementary product after adding to cart” vs “Be helpful”
  • Brand-aligned: Match your store’s voice and customer service style

​
Store Rules

Inject store-specific policies that the AI should know about and communicate to customers when relevant. For example: delivery terms, return policies, loyalty programs, promotions. The AI will reference these rules naturally in conversation when customers ask about delivery, returns, or promotions.

​
Greeting

A template for the first message the AI sends when a new conversation starts.
Keep greetings short (1-2 sentences). Long greetings feel impersonal. Let the AI’s personality come through in the conversation naturally.

​
Forbidden Topics

Topics the AI should avoid discussing. When a customer brings up a forbidden topic, the AI politely redirects to shopping.

​
Tool Configuration

Navigate to Settings > Tools in the Admin Panel. You can disable optional tools to simplify the AI’s behavior.

​
Available Tools

ToolCategoryCan Disable?Description
search_productsCoreNoSearch the product catalog
show_products_to_userCoreNoDisplay product cards for selection
ask_userCoreNoAsk the customer a clarifying question
complete_sessionCoreNoFinalize the shopping session
add_to_selectionCartYesAdd a product to the cart
remove_from_selectionCartYesRemove a product from the cart
update_quantityCartYesChange item quantity
get_selectionCartYesView current cart contents
clear_selectionCartYesClear the entire cart
show_recipe_checklistRecipeYesShow recipe ingredients checklist
show_meal_planMeal PlanYesGenerate multi-day meal plans
get_product_detailsInfoYesGet detailed product information
Core tools (search_products, show_products_to_user, ask_user, complete_session) cannot be disabled. They are essential for basic AI functionality.
When you disable cart tools, the AI can still search and show products, but will not offer to add items to the cart. This is useful for informational-only deployments.When you disable recipe/meal plan tools, the corresponding instructions are also removed from the AI’s system prompt, keeping it focused.

​
Example Configurations

Disable all cart tools for an informational assistant that helps customers browse but does not manage the cart:
{
  "disabled_tools": [
    "add_to_selection",
    "remove_from_selection",
    "update_quantity",
    "get_selection",
    "clear_selection"
  ]
}
Keep cart functionality but disable advanced features:
{
  "disabled_tools": [
    "show_recipe_checklist",
    "show_meal_plan"
  ]
}