AI Customization

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:

Field	Max Length	Purpose
`bot_name`	—	The assistant’s display name (default: “Помічник”)
`personality`	1,000 chars	Tone, style, and character traits
`store_rules`	2,000 chars	Store-specific policies and instructions
`greeting`	500 chars	First-message greeting template
`forbidden_topics`	1,000 chars	Topics 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

Tool	Category	Can Disable?	Description
`search_products`	Core	No	Search the product catalog
`show_products_to_user`	Core	No	Display product cards for selection
`ask_user`	Core	No	Ask the customer a clarifying question
`complete_session`	Core	No	Finalize the shopping session
`add_to_selection`	Cart	Yes	Add a product to the cart
`remove_from_selection`	Cart	Yes	Remove a product from the cart
`update_quantity`	Cart	Yes	Change item quantity
`get_selection`	Cart	Yes	View current cart contents
`clear_selection`	Cart	Yes	Clear the entire cart
`show_recipe_checklist`	Recipe	Yes	Show recipe ingredients checklist
`show_meal_plan`	Meal Plan	Yes	Generate multi-day meal plans
`get_product_details`	Info	Yes	Get 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

Product search only (no cart)

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"
  ]
}

Simple shopping (no recipes/meal plans)

Keep cart functionality but disable advanced features:

{
  "disabled_tools": [
    "show_recipe_checklist",
    "show_meal_plan"
  ]
}

Full-featured assistant

Enable everything (default configuration) combined with rich prompt customization:

Setting	Example Value
Bot Name	Chef Anna
Personality	Passionate about cooking. Suggests recipes proactively.
Store Rules	Premium organic store. Highlight organic products.
Greeting	Hi! I’m Chef Anna. Looking for dinner ingredients?
Forbidden Topics	Non-organic farming, competitors, processed food criticism.

Getting Started

Integration Guides

Widget SDK

Webhooks

Concepts

Prompt Configuration

Customization Fields in Detail

Bot Name

Personality

Store Rules

Greeting

Forbidden Topics

Tool Configuration

Available Tools

Example Configurations

​Prompt Configuration

​Customization Fields in Detail

​Bot Name

​Personality

​Store Rules

​Greeting

​Forbidden Topics

​Tool Configuration

​Available Tools

​Example Configurations

Prompt Configuration

Customization Fields in Detail

Bot Name

Personality

Store Rules

Greeting

Forbidden Topics

Tool Configuration

Available Tools

Example Configurations