Skip to main content
VIZOCHOK lets you customize the AI assistant’s behavior per tenant without writing any code. Configure the bot’s name, personality, store-specific rules, greeting message, forbidden topics, and which tools are available.

​
Prompt Configuration

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

​
Get Current Config

curl https://api.vizochok.com/api/v1/admin/prompt \
  -H "Authorization: Bearer sk_your_secret_key"
Response: 
{
  "bot_name": "Помічник",
  "personality": null,
  "store_rules": null,
  "greeting": null,
  "forbidden_topics": null
}

​
Update Config

Use PATCH to update only the fields you want to change: 
curl -X PATCH https://api.vizochok.com/api/v1/admin/prompt \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_name": "Марічка",
    "personality": "Friendly and enthusiastic Ukrainian grocery expert. Uses casual language, occasionally adds food-related humor. Always suggests complementary products.",
    "store_rules": "We offer free delivery for orders over 500 UAH. Returns accepted within 24 hours for non-perishable items. Loyalty card holders get 5% discount.",
    "greeting": "Привіт! Я Марічка, ваш помічник у покупках. Що шукаєте сьогодні?",
    "forbidden_topics": "Politics, religion, competitors. If asked about non-food topics, politely redirect to shopping."
  }'

​
Reset to Defaults

curl -X POST https://api.vizochok.com/api/v1/admin/prompt/reset \
  -H "Authorization: Bearer sk_your_secret_key"

​
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. 
{"bot_name": "Марічка"}
The bot name is separate from the SDK’s botName config option. The SDK botName controls the UI display name, while the API bot_name controls how the AI refers to itself in conversation. 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. 
{
  "personality": "Professional but warm tone. Speak concisely. Use product knowledge to make helpful suggestions. When recommending alternatives, explain why each option might be a good fit."
}
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. 
{
  "store_rules": "Delivery: free for orders over 500 UAH, otherwise 49 UAH. Same-day delivery if ordered before 14:00. We accept returns for non-perishable items within 48 hours with receipt. Loyalty program: 1 point per 10 UAH spent."
}
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. 
{
  "greeting": "Вітаю! Я Марічка з магазину \"Свіжість\". Допоможу знайти продукти, підібрати рецепт або зібрати список покупок. Що вас цікавить?"
}
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. 
{
  "forbidden_topics": "Never discuss: politics, religion, competitors, medical advice, dietary supplements as medicine. If asked, say 'I'm here to help with your groceries! What products are you looking for?'"
}

​
Tool Configuration

VIZOCHOK’s AI uses a set of tools to interact with the catalog and cart. 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.

​
Get Current Tool Config

curl https://api.vizochok.com/api/v1/admin/tools \
  -H "Authorization: Bearer sk_your_secret_key"
Response: 
{
  "disabled_tools": []
}

​
Disable Tools

To disable specific tools, provide the list of tool names to disable: 
curl -X PATCH https://api.vizochok.com/api/v1/admin/tools \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "disabled_tools": ["show_meal_plan", "show_recipe_checklist"]
  }'
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.

​
Re-enable All Tools

To re-enable all tools, send an empty disabled list: 
curl -X PATCH https://api.vizochok.com/api/v1/admin/tools \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{"disabled_tools": []}'

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