# What You Can Ask Side Chat

{% hint style="warning" %}
**Responses provided by Side Chat may not always be accurate and should be used as reference information only.**
{% endhint %}

### **1.** Arkain Feature Guidance

* **What it does**
  * Answers questions about Arkain’s features and services by using an LLM trained on and referencing the official documentation at [docs.arkain.io](http://docs.arkain.io/), helping you understand how each capability works and when to use it.
* **Example requests**
  * What is Arkain Snap?
  * What is Auto Stop?
  * What is Arkain template?
  * What is Code Supporter?
* **Constraints**
  * <mark style="background-color:red;">AI responses may be approximate or outdated; please refer to the official documentation for accurate details.</mark>

***

### **2.** Credit Support

{% hint style="danger" %}
Side Chat enforces strict access control and only supports searching data owned by the **authenticated user.**
{% endhint %}

#### 2.1. Credit calculation

* **What it does**
  * Calculates credit usage based on container specifications and usage duration, allowing you to estimate hourly and monthly credit consumption.
* **Example requests**
  * Calculate how many credits the active container is using per hour.
  * Calculate the monthly usage credits for the medium container.
  * Calculate the monthly credit usage for the GPU container.
  * Calculate the hourly usage for a 10GB container with micro specs.

#### 2.2. Check credits

* **What it does**
  * Shows your current credit balance, monthly credit usage, and real-time credit consumption for the active container.
* **Example requests**
  * Check credits.
  * How many credits do I have left?
  * Show credit status.
* **Constraints**
  * <mark style="background-color:red;">Credit information can only be viewed for the currently</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**authenticated user**</mark><mark style="background-color:red;">.</mark>&#x20;
  * <mark style="background-color:red;">There may be a slight delay before updates are reflected.</mark>

***

### 3. App Creation

* **What it does**
  * Detects app creation requests from your input and automatically prepares a project plan using Arkain Snap. Once ready, a \[Generate with Arkain Snap] button will appear to proceed.
* **Example requests**
  * Build a portfolio website with React. Create a REST API server with Node.js. Make a web app based on my Notion doc.
* **Constraints**
  * <mark style="background-color:red;">Responses provided by Side Chat may not always be accurate and should be used as reference information only.</mark>
  * <mark style="background-color:red;">App creation requires sufficient credits and an available container slot.</mark>

***

### **4.** Container Management

{% hint style="danger" %}

* For actions that require a specific container, the Side Chat will ask for the container name if you don’t provide it.
* The Side Chat enforces strict access control and only supports searching data owned by the **authenticated user.**
* Checking or updating **shared containers** via Side Chat is **currently unavailable**.
  {% endhint %}

#### 4.1. Check Container

#### 4.1.1. Get Container List

* **What it does**
  * Shows up to five of your most recently used containers, including their current status and the last updated time.
* **Example requests**
  * View containers.
  * Which containers were updated recently?

#### 4.1.2. Get Container Detail

* **What it does**
  * Returns full details for a specific container: basic info, spec, storage, advanced setting info, URL/port, init script, SSH info, and more.
* **Example requests**
  * Show details for my "my-project" container.
  * What are the spec and storage for "project-alpha"?
  * Show the URL/port settings for "web-service".
  * Show only SSH info for “my-app” container.
* **Constraints**
  * <mark style="background-color:red;">Getting container details is not allowed when the container is inactive.</mark>

#### 4.2 Update Container Settings

{% hint style="info" %}
**Note**

* All changes **require explicit user approval** before execution. The Side Chat will propose the update, you confirm, then the operation runs.
* Note that updating container specs, storage, or advanced settings may **change the number of credits deducted.**
  {% endhint %}

{% hint style="danger" %}
**Common Constraints**

Updates to container information and status are not allowed when a container is **inactive**.
{% endhint %}

#### 4.2.1. Update Basic Info

* **What it does**
  * Changes the container’s name or description.
* **Example requests**
  * Rename my "api-server" container to "project-alpha".
  * Update the description of "data-pipeline" container to "Daily ETL jobs".
  * Set empty description from the “algorithm-practice” container.
* **Constraints**
  * <mark style="background-color:red;">You can’t rename a container to a name that is already in use.</mark>
  * <mark style="background-color:red;">Only one field can be updated per request.</mark>

#### 4.2.2. Update Spec

* **What it does**
  * Updates the container’s resource specification to one of: micro, small, medium, or large.
* **Example requests**
  * Set my container spec to medium.
  * Upgrade the “qna-dashboard” container to large.
  * I want to change spec to small for “nextjs-app” container.
* **Constraints**
  * <mark style="background-color:red;">Specs can only be changed when the container is</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**stopped**</mark><mark style="background-color:red;">.</mark>
  * <mark style="background-color:red;">Changing a general container to a</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**GPU is not permitted**</mark><mark style="background-color:red;">.</mark>

#### 4.2.3. Update Storage

* **What it does**
  * Increases the container’s storage capacity in gigabytes (GB).
* **Example requests**
  * Increase the storage for the “portfolio-web” container to 20 GB.
  * Expand "data-lab" storage to 25 GB.
  * Update "etl-runner" container’s storage to 30 GB.
  * I want to change storage size to 15 GB for “python-app” container.
* **Constraints**
  * <mark style="background-color:red;">Storage can only be changed when the container is</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**stopped**</mark><mark style="background-color:red;">.</mark>
  * <mark style="background-color:red;">You can upgrade again</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**6 hours**</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">after the previous upgrade.</mark>
  * <mark style="background-color:red;">Once a container's storage capacity is increased, it</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**cannot be reduced.**</mark>
  * <mark style="background-color:red;">You can upgrade the storage</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**up to 80GB.**</mark>

#### 4.2.4. Update URL / Port

* **What it does**
  * Manages exposed running URL and port mappings for the container. You can add a URL, change its port, or delete it.
* **Example requests**
  * Add the “tetris-api” URL and port 8080 to the “tetris” container.
  * Change the "web" URL port to 3001.
  * Remove the “front-app” URL from the “portfolio” container.
* **Constraints**
  * <mark style="background-color:red;">URL/Port can only be changed when the</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**container is stopped**</mark><mark style="background-color:red;">.</mark>
  * <mark style="background-color:red;">You can’t add a url name that is</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**already in use.**</mark>
  * <mark style="background-color:red;">When updating the URL, you must enter the</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**subdomain name of the URL**</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">you wish to use.</mark>
    * For example, if you want to add a URL like `https://my-api-server.ap-northeast-2.arkain.site`, you should only enter “my-api-server”.
  * <mark style="background-color:red;">**Custom Domains cannot be added via Side Chat**</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">and must be configured directly on the Container settings page.</mark>

#### 4.2.5. Update Init Script

* **What it does**
  * Modifies the init script that runs when the container runs.
* **Example requests**
  * Update the init script to run "mkdir project & cd project".
  * Set the init script to "bash [init.sh](http://init.sh)" for “blank-project” container.
  * Change the init script to empty.
* **Constraints**
  * <mark style="background-color:red;">Init Script can only be changed when the container is</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**stopped**</mark><mark style="background-color:red;">.</mark>

#### 4.2.6. Update Advanced Settings

* **What it does**
  * Enables or disables advanced features such as [**Auto-stop**](https://docs.arkain.io/user-guide/dashboard/container/auto-stop), and [**Code Supporter**](https://docs.arkain.io/user-guide/workspace/editor/code-supporter).
* **Example requests**
  * Turn on auto-stop for "project-alpha" container.
  * Enable code supporter for "web-service".
  * Turn off auto-stop for "etl-runner".
* **Constraints**
  * <mark style="background-color:red;">Advanced Settings can only be changed when the container is</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**stopped**</mark><mark style="background-color:red;">.</mark>
  * <mark style="background-color:red;">**Only one setting**</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">can be changed per request.</mark>

***

### **5. Template Recommendations**

* **What it does**
  * Recommends Arkain templates based on your project goals and use cases.
* **Example requests**
  * Find template for game.
  * Find template for boilerplate.
  * Find template for React.
  * Find template for AI-powered app.
* **Constraints**
  * <mark style="background-color:red;">Template recommendations are prioritized based on usage frequency, with</mark> <mark style="background-color:red;"></mark><mark style="background-color:red;">**the most commonly used templates shown first**</mark><mark style="background-color:red;">.</mark>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.arkain.io/user-guide/dashboard/creative-tools/side-chat-dashboard/what-you-can-ask-side-chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.