> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-staging.joytokens.ai/llms.txt.

# Agent Workbench

> Use the Agent Workbench for conversations, assistants, knowledge bases, tools, tasks, and AI deliverables

## Quick start: Open the workbench and complete a conversation

### Open the Agent Workbench

1. Sign in to JoyToken and click **Agent Workbench** on the home page.
2. Open **My Agents** to see your existing Agents.
3. Click **Start New Topic** on the left to use the built-in **JoyToken Agent**. Alternatively, select an Agent under **My Agents** and click **Enter Conversation**.
4. To use another Agent from the Marketplace, add and configure it first, then enter a conversation.

![My Agents in the workspace, including Start New Topic and Enter Conversation.](/_fern-files/_img/eccae59ff3cd780fb22d4b039847dd48c4e2b196b88646494721eb97d037e492.webp)

| Entry           | Purpose                                                                                   |
| --------------- | ----------------------------------------------------------------------------------------- |
| Agent Workbench | Conversations, Agent configuration, Skills, MCP, knowledge bases, tasks, and deliverables |
| API Console     | API Keys, model routing strategies, quotas, usage, and billing                            |

### Choose a default model API Key

1. Open **Workbench Settings**.
2. Select an existing Key under **Default Model API Key** and check its name, status, and expiration date.
3. Scroll to the bottom and click **Save Settings**.
4. Return to the target Agent's conversation and enter your request.

If no Key is available, click **Manage Keys** to open Key management in the current environment. After creating a Key, select and save it in the workbench. Also check the Key's budget, daily quota, model permissions, and account balance.

![Workspace settings: the default model key and chat/task retention.](/_fern-files/_img/384348047028ac00cc936cd33eb69ff3ca8d8c8175e854e009dc832227741855.webp)

### Enter your request and check the result

Press Enter to send and Shift+Enter for a line break. The input area has a 4,000-character limit.

For example:

```text
Organize these notes into a to-do table with Task, Owner, and Due Date columns.
Write "Not provided" wherever information is missing.
Lin will prepare the demo materials; the due date is undecided.
Zhou will proofread the page copy by November 6, 2026.
Compile the feedback by November 9, 2026; the owner is undecided.
Generate a downloadable "Meeting To-Do List.md".
```

After the response, check the result, approve tool calls when prompted, and download files to inspect them. Continue related work in the same topic; click **Start New Topic** for a separate task.

## Navigation, topics, and tasks

| Location             | Entry and purpose                                                                     |
| -------------------- | ------------------------------------------------------------------------------------- |
| Workbench sidebar    | Existing Agents under **Agent**; click **New** to choose how to create one            |
| Marketplace          | **Agent**, **Skill**, and **MCP** open their respective marketplaces                  |
| Knowledge bases      | Open **Knowledge Bases**, click **New** to create one, or select an existing base     |
| AIGC                 | **Image Generation** and **Video Generation**                                         |
| History              | **Recent Topics and Tasks** to find and resume earlier topics                         |
| Conversation sidebar | **Return to Workbench**, **Start New Topic**, and **Agent Profile and Configuration** |
| Settings and billing | **Workbench Settings** and **API Console**                                            |

Under **Recent Topics and Tasks**, expand an Agent to select a topic. Use **Task Status** filters, **Hide Empty Topics**, and **View Credit Consumption Details** as needed. A topic records the conversation; a task has its own goal and status; each task run has a separate execution record.

![Expand an Agent to find and continue an earlier conversation.](/_fern-files/_img/83bfb79aa7945fe17223b30160e439929666cd4239a255c7c0e4692a7262fe09.webp)

Use **Edit and Resend (Keep History)** in a conversation to revise and resend input without changing the earlier message.

## Workbench Settings

### Default and Agent-specific Keys

The workbench default Key is used by Agents without a dedicated Key. Under **Bind API KEY** in an Agent's configuration, choose **Follow User Default Key** or bind a dedicated Key. An Agent-specific binding takes priority; if that Key becomes invalid, check and update the configuration.

### Record retention, tools, and memory

**Storage Days** under **Conversation and Task Retention** accepts 1–3650 days and applies to both conversation and task records. Click **Save Settings** at the bottom of the page after making changes.

**Built-in Agent Tools** include default-enabled **Basic Tools** and selectable **Optional Tools**, which set initial capabilities for new Agents.

To change an existing Agent's tools, open its **Assembly Configuration**; confirm when a tool call requires authorization.

**Enable Memory** extracts preferences and information from conversations; **Auto-compress Context** summarizes history when approaching the context limit.

Download any results you need to keep before changing retention.

## Create, add, and configure Agents

### Three ways to create an Agent

Click **New** beside Agent in the sidebar, or **New Agent** in the Marketplace, then choose:

| Method                            | When to use it                                                     |
| --------------------------------- | ------------------------------------------------------------------ |
| Create Agent through Conversation | Describe your needs and refine the configuration in a conversation |
| Add Agent from Marketplace        | Browse existing Agents and start the add flow                      |
| Create Agent from Blank Template  | Set the name, role, prompt, and capabilities yourself              |

![Choose a creation method in New Assistant.](/_fern-files/_img/96aa5350f514e276f98415042a3f5a81ab0ba671ab77d7ff47cfa4a06efa08a1.webp)

Three ways to create an assistant.

After choosing the blank template, the page is titled **Create Agent · Configure Agent Assembly**. Under **Identity and Prompt**, enter a name, description, prompt, and optional welcome message; the name and prompt are required. Expand **More Identity Settings** to add up to four starter questions. Check **Generation Parameters**, add Skills, MCP, and knowledge bases as needed, choose a Key, then click **Create Agent** or **Create and Enter Conversation**.

### Add from the Marketplace

1. Under **Marketplace**, click **Agent** to open the **Agent Marketplace** tab and search by name or category.
2. Click a card or **Go to Add** to open its details.
3. Review **Overview**, **Setup**, **Assembly**, **Related**, and **Version** for its purpose, prompt, capabilities, and version.
4. To add it manually, select **I am Human** under **Add Method**, then follow the instructions and click **Add** at the top of the page.
5. Check that it shows **Added** and appears under **My Agents**.
6. Click **Configure Assembly** to check its capabilities and Key. Save and click **Enter Conversation** to start.

Alternatively, choose **I am Agent**, copy the integration prompt to an AI assistant, and follow the instructions to add it. The built-in **JoyToken Agent** can be used directly.

![Review the Agent details and select Add to include it in My Agents.](/_fern-files/_img/9238ca3ec176f2233a4def0bd302cc5000042b2071faefec98a576d973857730.webp)

### Edit an existing Agent

Click **Configure Assembly** on a **My Agents** card or its personal details page to edit identity, prompt, Skills, MCP, knowledge bases, and Key. Click **Save Configuration** or **Save and Enter Conversation** when done. To review its capabilities, open the **Assembly** tab on the details page.

![Skill, MCP, knowledge base, and API key bindings in the Agent editor.](/_fern-files/_img/c9632fb423ef8aac4b320a28c03b58c665df44c0e9ca406f7d089f97b22bc5e9.webp)

## Skills: Import and assemble

### Import your own Skill

1. Click **Skill** under **Marketplace** to open **Skill Marketplace**, then click **Import Skill**.
2. Select an **Import Method** and enter a **Skill Name** and **Skill Description**. The default form lets you upload a UTF-8 Markdown file or paste a **Markdown Body**; remote-link and ZIP import methods are also available.
3. Fill in the selected form and click **Confirm Import**. The Markdown Body limit is 1 MiB (1,048,576 bytes).
4. Check the result under **My Skills**. To use a Marketplace Skill, click **Go to Import** on its card, open the details, and follow the import instructions.

![Import Skill: method, name, description, and Markdown content fields.](/_fern-files/_img/483999429868d8c3ba4155edeb8e62d3486900f611ca289083106c79c50af666.webp)

### Assemble a Skill into an Agent

1. Open an editable Agent's **Assembly Configuration**.
2. Under **Enable SKILLS**, click **Add Skill**.
3. Find and select your personal Skill in the picker.
4. Click **Confirm** and save the Agent configuration.
5. Start or open a topic with that assistant and submit an input that suits the Skill.

![The Skill picker separates marketplace, personal, and import sources.](/_fern-files/_img/90846d80d875e5979b3101a37efbfc3db4561d3110ad1fbc05ba6d176b8c9821.webp)

Skill details also offer **Enable for My Agent**. Importing alone does not bind a Skill to every assistant.

A Skill provides methods and materials; it does not automatically provide a general-purpose code sandbox, OCR, or arbitrary file-editing capabilities.

## MCP: Obtain, bind, and troubleshoot

### Obtain from the Marketplace

1. Open **MCP Marketplace** and choose a service.
2. Review its summary, tools, Schema, version, and authorization requirements.
3. Click **Add to My Connections**.
4. Open your personal connection under **My MCP** and check its status and tools.

![MCP details: Add to My Connections, server information, and tool counts.](/_fern-files/_img/39db8e735af15080b58a9864448f813f6f2b30a1de425f5ea9c494da01610b5d.webp)

### Add to an Agent

1. Open the Agent's **Agent Profile and Configuration**.
2. Click **Add MCP**.
3. Select a service you have obtained and click **Confirm**.
4. Save the configuration and enter a conversation.
5. Request a task that explicitly needs the tool and inspect the actual result.

### Personal connection details

You can review the connection name and identifier, remote server identifier, enabled status, authentication configuration, and tool permissions. Set the address and credentials for a custom connection using the current form; do not treat your model Key as credentials for a third-party tool.

### If something goes wrong

Check, in order, whether:

1. The configuration was not saved or bound;
2. The connection or tool is unavailable;
3. The current operation has not been authorized;
4. The model call failed before the tool could be used;
5. The tool failed or returned no result.

## Knowledge bases: From upload to citation

### Create a knowledge base

1. Click **New** under **Knowledge Bases**, or **New Knowledge Base** on the knowledge-base page.
2. Enter a **Knowledge Base Name**; a description is optional.
3. Click **Create Knowledge Base**.
4. Click **View** in the list to open it.

Knowledge bases are currently managed within a personal visibility scope; the page explicitly says **Only visible to me**.

### Upload files

![Account-level Knowledge Settings, including embedding model scope and save action.](/_fern-files/_img/0119f06c614646d627774fb8669565f8a5249080b2e4ce11181b12451c18aa54.webp)![A knowledge base's Settings tab links to the account-level embedding configuration.](/_fern-files/_img/035312e4a95aa101d8e3a9a6305231332681c5173318504b8f4c52d95b257321.webp)

An empty knowledge base offers **Upload File** and **Upload Folder**. For an existing library, use **+ Add** to add more.

The page currently lists pdf, doc, docx, xls, xlsx, pptx, md, markdown, txt, ipynb, html, and htm, with a maximum of 100 MB per file. Files inside an uploaded folder are saved in a flat list; do not assume the original folder structure is preserved.

Watch server-side status changes such as **Queued** and **Ready** after upload. If the UI has not updated, return later rather than uploading the same file again to speed it up.

![The file list shows processing status, Retry, Preview, and Remove actions.](/_fern-files/_img/a18c9d2fa13e32090ec7a2add749fe8a84fbaf73b361659bd944360502edb6be.webp)

### File details and preview

Click **Preview** in a knowledge base's file list to open **File Details**. File information tells you whether processing is complete and the file can be searched; the body preview lets you confirm that the right content was uploaded.

**Fields:**

| Field                     | Meaning                                                                          |
| ------------------------- | -------------------------------------------------------------------------------- |
| Size, file type           | Size is the uploaded file's byte count; type indicates PDF, DOCX, MD, etc.       |
| Chunks                    | Number of content segments created for retrieval                                 |
| Parsing / chunking status | Stages that extract file contents and organize them into retrievable segments    |
| Embedding status          | Conversion of content segments into numeric representations for relevance search |
| Status                    | Overall processing status returned by the server                                 |
| Enabled                   | Whether the document may currently be used in the applicable material scope      |
| Uploader                  | Who uploaded the file                                                            |
| Upload time               | When this file was saved to the knowledge base                                   |

**Body preview:**

The body area displays the current file through a temporary download URL. Check the title, key fields, completeness, and version. Different file types may render differently.

File Details currently notes that preview links are valid for 30 minutes by default. If a link expires, close and reopen the details to obtain a new one.

![File details: parsing, chunking, embedding status, and file information.](/_fern-files/_img/6ad4d3255cc138440144699d7e702d380e268292178639980f2dc7ba36f1a97c.webp)

### Bind and retrieve

1. Open an editable Agent's configuration.
2. Click **Add Knowledge Base**, select an existing library, and confirm.
3. Save the configuration.
4. Open a topic with that assistant and explicitly request an answer based on the bound materials.
5. Check the answer and its sources; missing information should be identified as such.

Attachments and knowledge bases differ: attachments serve the current input; knowledge bases are materials that can be retrieved repeatedly.

## Conversations, attachments, and Inspector

### Input and attachments

Press Enter to send and Shift+Enter for a line break. With an empty input box, press ↑ to browse input history; Escape exits that state.

Use **+** to attach files. The conversation attachment area currently shows up to 10 items and offers **Clear Attachments**. Accepted attachment types differ from knowledge-base uploads; follow the current file picker and error messages.

Specify what to do with the attachment in your request. “Extract the to-dos” is more precise than “Look at this file.”

### Tool-call approval

When a model proposes an action requiring authorization, **Tool Call Approval** displays the tool name and parameters.

| Action                            | Meaning                                                                                                 |
| --------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Allow Once                        | Approve this operation                                                                                  |
| Always Allow in This Conversation | Allow the corresponding behavior within this conversation as described by the UI; check the scope first |
| Deny                              | Do not approve the operation                                                                            |
| Cancel Call                       | Cancel the pending call                                                                                 |

For changes to external data or media generation, do not assume approval just because the assistant says it has started. Respond to the approval prompt first, then check the final status.

### Inspector

Click **Inspector** by the input area to view **Overview** and **Routing**.

Overview may show request ID, Key, strategy, tier, actual model, credits, tokens, cache, and latency. Treat absent fields as “Not provided.”

![Inspector shows request, usage, and routing information.](/_fern-files/_img/93bc03a3f116220e463868e191b94b15dc62f259401df5d9f2b4ce95331fe111.webp)

### Retry, stop, and history

Keep three things separate: the conversation stores chat history; “generating” describes the current reply; tasks and media have their own execution statuses.

**Retry:**

Click **Retry** on a message and wait for the new result. A retry may create another model call and charge.

**Stop:**

While the current turn runs, use Stop or press Escape as the page suggests. Wait for the status to update and verify the turn has ended; existing output and saved content remain available.

If this turn launched a separate task, also check its details for **Cancel Run**. If image or video generation was submitted upstream, check that media task's status as well. Closing the page, switching topics, deleting a message, and stopping generation are not the same action.

**Review history:**

* Use **Recent Topics and Tasks** to find the relevant Agent and topic, then open the original messages.
* For a separate task, open **Execution History** in Task Details, choose a run by time, trigger type, or sequence number, then click **View Conversation**.
* Check which execution produced a deliverable; distinguish the first run from retries and scheduled runs.

## File deliverables: Word, Excel, PPT, and PDF

Tell the Agent the file types, names, and structure you want. For example:

```text
Based on the to-do table we just confirmed:
Create Word meeting minutes and an Excel spreadsheet.
Also create a PDF and a three-slide PPT covering the topic, to-dos, and items to confirm.
Actually generate downloadable files.
```

When finished, file cards and download links appear in the message. Download and check:

| Format           | What to check                                              |
| ---------------- | ---------------------------------------------------------- |
| Word             | Title, paragraphs, tables, and missing values              |
| Excel            | Sheets, column names, row counts, dates, and data types    |
| PPT              | Slide count, topic, key points per slide, and empty slides |
| PDF              | Whether it opens, page count, text, and table layout       |
| Markdown/CSV/TXT | Encoding, structure, and completeness                      |

Even if a file card shows success, inspect its contents. Longer documents may go through staged drafts; wait for the final download link.

Files generated within a task belong to a specific execution. Multiple runs of the same task produce separate files; do not mix up versions.

![Select Download on a file card to save the result.](/_fern-files/_img/8bb65551ecf75d79961d2361b1fc27bec109755f10150be9b322508124bc28cd.webp)

## Tasks: Create, run, and confirm acceptance

### Create in a conversation

```text
Create and immediately run a task called “Instructions Check.”
Output three instruction checkpoints and generate a Markdown file.
Acceptance criteria: exactly three checkpoints and an actual file.
```

If you only request creation, the task may stay pending; requesting a run should produce an actual execution record.

### Task details

Open a task card in the conversation. The main areas include:

| Area                  | Contents                                                  |
| --------------------- | --------------------------------------------------------- |
| Header                | Name, status, credits and tokens, executing Agent         |
| Task details          | Goal, execution steps, output requirements                |
| Execution settings    | Frequency, time zone, next run, schedule status           |
| Deliverables          | Delivered content and files                               |
| Execution log/history | Each run, trigger type, status, and **View Conversation** |
| Model request trace   | Available model-call records                              |

### Run and accept

1. Click **Run** to start an execution.
2. Wait for it to finish and inspect the output and files.
3. If the task shows **Awaiting Acceptance**, click **Confirm Acceptance** after reviewing the result.
4. The task changes to **Completed**.

Execution completion and task acceptance are recorded separately. Even when an execution is **Completed** in the history, the task may still await your acceptance; the assistant saying “acceptance criteria met” does not replace your confirmation.

### Edit, add steps, and cancel

Use **Edit** to change the goal or requirements, and **Add Step** to expand the plan. During a run, a step may only allow status updates; follow the UI prompts.

Running again adds another execution record. Click **View Conversation** to review that run's separate process.

Deleting a task, canceling a run, and deleting a file affect different objects; check your target before acting.

## Scheduled plans

### Configure a plan

1. In Task Details, click **Set Schedule** under **Execution Settings**.
2. Choose the repeat frequency and execution time.
3. Enter or verify the time zone, for example Asia/Shanghai.
4. Select **Enable** and click **Save**.
5. Check the task's displayed next run time.

### Track manual and scheduled runs separately

Manual and scheduled runs may be different records of the same task. Choose the relevant execution when reviewing files, usage, or results.

### Disable or delete a plan

Under Execution Settings, use **Edit** to disable the plan, or **Delete** in that section.

The deletion confirmation explains that the task will no longer run automatically but the task itself remains. Once confirmed, the frequency reverts to **Manual Only** and the next run is blank; previous runs and files remain.

## Images and video

### Generate in a conversation

Describe your goal to an Agent with media capabilities, and provide reference materials if needed. Specify the quantity, aspect ratio, or duration.

When a tool approval prompt appears, check the parameters and choose **Allow Once**. After generation, inspect the media card, download the result, and check the output.

Video may take longer to process. Accepted, awaiting authorization, generating, and completed are different states.

### Relationship to dedicated creation tools

The image and video creation areas have dedicated forms, tasks, and asset management; Agent conversations generate media through tool calls. Do not assume their model parameters or feature scopes are interchangeable.

## Review usage and billing

Conversation totals in the workbench, per-call Inspector data, and Console billing may be calculated at different times and cover different scopes. Use settled entries in **Usage Details** for reconciliation.

1. Open the **API Console** from the workbench.
2. Open **Usage** and select the time range and Key.
3. Switch to **Usage Details**.
4. Open **Details** for a record and check input, output, cache, reasoning, and other metered items and their per-call prices.
5. Expand **More Information** if you need to trace the call.

For small amounts the page may show “\<0.01 credits”; Details can display a more precise charge.

## AIGC: Image Studio

### Step 1: Create a generation task

Click **New Task** in the left navigation; it **opens the Text-to-Image mode by default**. Follow these steps to generate images:

* **Enter the PROMPT** — describe the image you want in a single sentence (with an example placeholder).
* **Select a style** — Guochao / Realistic Photography / 3D Render / Minimalist.
* **Select an aspect ratio** — 1:1 / 3:4 / 16:9.
* **Select the number of images** — adjust with −／+; the estimated Token cost appears at the bottom-left. Click **Generate N images** to submit; results appear in the **Recent Tasks** panel on the right.

![Enter prompt](/_fern-files/_img/829117ce21da4264ce70da088a71f7a88c80268eb6621fdbc64a57f6b62075e5.webp)![Select style](/_fern-files/_img/2b2d1d5464330dd36ad43777c5d79c8d2a2e83e75102011246c2b5ac293d2984.webp)![Select aspect ratio](/_fern-files/_img/07973171ac22598573a2dc95435c1d680e68c27a113af1dc4c5192fc108e46ba.webp)![Select count and generate](/_fern-files/_img/e4b194dcd5b4d4cc9608ae66ba17f512ebde5503303a3ea3e548c5121376341f.webp)

**Image-to-Image**: create with AI from an existing image. Switch to the **Image-to-Image** tab, then:

1. Upload a reference image (choose one): upload from local (JPG, PNG, WebP; up to 5 MB each) or select from the Material Library.
2. Enter your instruction, e.g., "Change the background to a beach at dusk, keep the pose and outfit."
3. Select the output ratio (default 1:1).
4. Set the batch count with −／+ (default 1 image).
5. Click **Start Image-to-Image**; the system generates results in batch, and you can track progress and outputs in the **Task Center**.

![Image-to-Image](/_fern-files/_img/55d4477fa153895fa58558b89e35c84deb7dbb910602323e85e526bf5b004abb.webp)

### Step 2: Track progress and view results

After generating, check progress in the **Recent Tasks** panel on the right, or open the **Task Center** menu.

![Task progress](/_fern-files/_img/268bc46a9ad8a514a962007e4043b67e16f85f376b9c3d747e30dabae8a6390e.webp)

## Task Center

The **Task Center** reviews historical generation tasks and their outputs, centrally managing all Text-to-Image / Image-to-Image tasks. It shows task status, generation time, image size, and output images, and supports search, status filtering, and refresh.

**Interface:**

* **Search bar**: search history by prompt, type, or error message.
* **Status filter**: the top-right dropdown filters by "All statuses" and more (e.g., Completed, Failed).
* **Refresh button**: manually refresh the latest status of the task list.
* **New Task**: a top-right shortcut that jumps to creating a new generation task.
* **Task cards**: each task shows the prompt, generation time, type, size (e.g., 1024×1024), a status tag, and thumbnails of the outputs; **Details** on the right opens the full result.

**Statuses:** **Completed** (green) means success and shows the batch of result images; **Failed** (red) means the task did not succeed and displays the error reason.

![Task Center](/_fern-files/_img/803564448c394c73d31002d160a356416f5db3d5ff33cca7373a0152d9a9d693.webp)

## Task Details

The **Task Details** page shows the full information of a single generation task — output results, prompt, execution info, and advanced parameters — for viewing generated images, downloading/saving or reusing assets, and tracing the execution process.

**Sections:**

* **Output results**: the finished images, each with **Download** (save locally) and **Add to Material Library** (for later reuse).
* **Execution info** (right panel): status, Agent (image), type, generation engine, engine task ID, and the execution timeline (Created / Started / Completed timestamps).
* **Prompt**: the full prompt text used for this generation.
* **View advanced parameters**: expand to see the count, size, type, and other detailed settings.

![Task details](/_fern-files/_img/35d599a024190c9586fec5b66bf5622284e68620f910a0bba37912224117da26.webp)

## Material Library

The **Material Library** archives and manages image assets in one place. After generating images you can manually archive them here for easy download, reuse, and re-editing (e.g., as a reference image for Image-to-Image); uploading local assets is also supported.

**Interface:** a search bar (search by name), category filter (All / Generated / Uploaded), an Upload button, an asset count, and a grid/list view toggle.

**Sources:** **Generated** (results archived via "Add to Material Library" on the Task Details page); **Uploaded** (local images added via the Upload button).

![Material Library](/_fern-files/_img/aed7e2dbb1655a482165299ba1cbe92b4dfe7b9f8b940dcf862bf526809b6187.webp)

## Skill Plaza

### Overview

The Skill Plaza is the core entry point of the Text-to-Image Agent, providing production-ready image prompt templates (skills). Pick a template from the real image-skill catalog and start creating quickly.

### Public Skills

Preset templates are shown as cards, each with: a preview image, name, category source (SOURCE ID), version (v1), description, tags, and a **Use Skill →** button. Example templates:

* **Architecture & Space**: generate interior, architecture, city-map, and spatial-concept visuals (tags Architecture / Interior / Map)
* **Brand Touchpoint Moodboard**: generate brand touchpoint boards for packaging, social, web, and display scenes (tags Brand / Identity / Campaign)
* **Brand Identity Kit**: generate logos, color palettes, typography, application touchpoints, and brand systems (tags Brand / Logo / Identity)

![Skill Plaza public skills](/_fern-files/_img/8963f93c808f8b205f8e72c619acffb29c17a27ffd7222d9daf4a0c2c9c0691f.webp)

### Using a Skill

After clicking **Use Skill →** in the Skill Plaza, the page jumps to **New Task - New Image Task**, with a note at the top: "Applied the 'Architecture & Space' skill."

Selected image-skill area (using the selected "Architecture & Space" as an example):

* Shows the skill name and description
* A subject & purpose input box (e.g., "Create a social-media launch poster for a new spring coffee product")
* **Apply to prompt** button: combines the subject/purpose with the skill template and fills the prompt
* The **×** in the top-right cancels the selected skill

The remaining steps follow the same Text-to-Image Agent flow.

![Use a skill](/_fern-files/_img/542961fdcfe51ef80cbb26cd979343538022d8c0258a80822f8437a1dd3fe795.webp)

### My Skills

Shows user-created templates; when empty it prompts "You don't have any custom skills yet," and you can click **+ New Skill** to create one.

Clicking **+ New Skill** under **My Skills** opens this dialog, used to save a reusable prompt template. The skill is visible only to the current tenant and user. A **▶ View filling example** toggle at the top expands a reference example.

![My Skills](/_fern-files/_img/c2302e319dce4973354bc89eb7eca180986342a3b75008e8ddb4c97ed61e983f.webp)

#### Field descriptions

* **Skill name**: the name of your custom skill
* **Category**: the skill's category, default: custom
* **Description**: a brief note on what the skill is for
* **Core prompt template**: describe the approach, subject, and constraints you always want the Agent to follow (the core required content)
* **Tags**: comma-separated, e.g., "brand, poster," for easier searching and categorization
* **Composition & structure**: constraints on composition and structure
* **Visual style**: overall visual-style requirements
* **Detail guidance**: guidance at the image-detail level
* **Output requirements**: output-spec requirements for the results
* **Negative constraints**: elements or effects you don't want (negative prompt)

#### Buttons

* **Save Skill**: save and create a custom skill, shown in the **My Skills** list
* **Cancel**: discard input and close the dialog
* **× (top-right)**: close the dialog

#### Steps

1. Click **+ New Skill** under **My Skills** to open the dialog
2. (Optional) Click **View filling example** for the format
3. Fill in the skill name, category, and description
4. Enter the approach, subject, and constraints in **Core prompt template**
5. Add tags, composition & structure, visual style, detail guidance, output requirements, and negative constraints as needed
6. Click **Save Skill** to finish; you can then apply it when creating a new task

![New skill dialog](/_fern-files/_img/a91d39625eddc0ad2536e257e4a29896ebf745aa31d6d9366c5cdcd12a98e519.webp)

## AIGC: Video Studio

### Step 1: Start a quick creation

Quick Creation generates a short video from a text prompt. It is suited to testing an idea before deciding whether to refine it. Submitted tasks enter the generation queue. When complete, you can preview the video in Task Details and manually add it to the Material Library.

**Interface:**

* **Video prompt:** Describe the scene, subject, actions, and camera style. A more specific prompt generally brings the result closer to your intention.
* **Aspect ratio:** Choose **16:9 landscape** for websites, large screens, or horizontal placements, or **9:16 portrait** for mobile shorts and vertical feeds.
* **Resolution:** Choose **720p (Standard)**, **768p (Advanced)**, or **1080p (HD)**. Higher resolution offers more detail but takes longer and costs more.
* **Duration:** Choose 4, 6, 8, or 10 seconds. Longer videos take more time and cost more.
* **Start Generation:** Submit a video generation task using the current prompt and settings; check its progress and result in Task Details.

Completed tasks are not automatically added to the Material Library; add them manually from Task Details.

![Start a quick video creation](/_fern-files/_img/71961a9d76df0c1af8b9db384dbffd1ec7d0ca11bbee431bc0ff6e81b9298245.webp)

### Step 2: Track progress and view results

After submitting, check generation progress under **Recent Tasks** on the right, or open **Task Center** from the menu.

![Recent video tasks and generation progress](/_fern-files/_img/2fceb4b6cee38471e84f4a27e4d183760357ba28bc31b4ef2261c1904af1f559.webp)

### Task Center

Task Center lists all tasks created through Quick Creation and Story Creation. You can check statuses, search past tasks, and open details to see outputs. The list is ordered newest first.

**Interface:**

* **New Task:** Start a new creation task from the top right.
* **All Tasks / Quick Creation / Story Creation:** Filter tasks by creation type.
* **Search:** Search prompt text, task type, or error messages.
* **All Statuses:** Filter for particular statuses, such as Completed or Canceled.
* **Refresh:** Reload the task list to see the latest status.
* **Task entries:** Show a prompt summary, submission time, creation method and type (such as text_to_video), and task ID. Completed tasks also show a first-frame thumbnail.
* **Status label:** Shows statuses such as Completed or Canceled to help determine whether an output is available.
* **Details:** Open the full prompt, settings, and output, and manually add a finished video to the Material Library.

![Video Task Center](/_fern-files/_img/74641bc14719f01fe008d2c9bd67709a5a8592eeb888c75aabe2a01c5e82d67e.webp)

### View details

Task Details shows the full information and output for a single creation task, including the original prompt, generated video, engine, and processing time. Use it to review, download, or save a completed video to the Material Library.

**Interface:**

* **Back to Task Center:** Return to the list to inspect or filter other tasks.
* **Status label:** Displays the current status, including failure if a task fails.
* **Prompt heading:** Shows the full prompt prominently so you can check the creative brief.
* **Task ID and type:** Displayed beneath the heading (for example, Text-to-Video) for troubleshooting and reconciliation.
* **Material Library:** Save this task's completed video for reuse.
* **Refresh:** Fetch the latest status and result.
* **Output:** Play the generated video, change volume, or view it full screen.
* **Download:** Save the video locally.
* **Add to Material Library:** Save the video for later creations.
* **Execution information:** The right panel lists status, Agent, type, engine, and engine task ID to identify the model and source task.
* **Execution timeline:** Records creation, start, and completion times for checking generation duration.
* **Prompt:** Displays the full prompt as text for copying or editing before another run.
* **Prompt and parameters actually sent:** Expand to inspect what was sent to the model if the submitted values seem different from those shown in the UI.
* **Advanced parameters:** Expand to see all advanced settings for this task.

![Video task details](/_fern-files/_img/0136b52335413dc7a1f210583679bccaae0e6793ebe480cc470afa0ce39a5bd0.webp)

### Material Library

The Material Library manages images, videos, and story assets used in creation. It includes both uploaded reference images and videos generated and saved from tasks. An uploaded image can serve as a reference for image-to-video creation.

**Interface:**

* **Upload Asset:** Upload local images or videos from the top right.
* **Asset count:** Shows the total number of assets.
* **View toggle:** Switch between grid and list views.
* **Search asset name:** Find assets by name.
* **All / Characters / Resolution / Videos / Uploaded:** Filter by asset source or type to show all assets, character assets, resolution-related assets, videos, or uploads.
* **Asset cards:** Show thumbnails, names, sources (such as System Generated or User Uploaded), and timestamps; hover for more actions in the top-right menu.
* **Use for Image-to-Video:** Start an image-to-video task using an uploaded image as a reference.
* **Pagination and page size:** Change the number of items per page and browse additional pages.

![Video Material Library](/_fern-files/_img/cf0f324141c0b12d1fdfc70c1cf29c2be7993030757fcb73a2c49278c851089b.webp)

### Skill Plaza

#### Overview

The Skill Plaza provides video creation templates to help you start from an existing creative direction. Browse a skill's cover, name, summary, and tags, then click **Use Skill** to create a video.

**Interface:**

* The left navigation provides **Quick Creation**, **Story Creation**, **Task Center**, **Skill Plaza**, and **Material Library**; here **Skill Plaza** is selected.
* Switch between **Public Skills** and **My Skills** at the top right.
* Skill cards show covers, names, summaries, and tags; click **Use Skill** on a card.
* The **Running Normally** indicator at the top shows service status, with a settings entry alongside it.

![Video Skill Plaza](/_fern-files/_img/5eb899f800495f20cdf1b99ef1fe5b9b6687d3e2d3c6813a4b382749ae6d9d6b.webp)

#### Use a Skill

After clicking **Use Skill**, the page opens **Quick Creation** with the selected skill enabled. Enter a video subject and prompt, set the aspect ratio, resolution, and duration, then start generation.

**Interface:**

* A banner confirms that the skill is enabled; the creation area shows its name and summary.
* Enter your idea under **Video Subject** and optionally click **Apply to Prompt** to incorporate it into the video prompt.
* Describe the scene, camera motion, and other details under **Video Prompt**.
* Select the aspect ratio, resolution, and duration below. The screenshot shows 16:9 landscape, 720p (Standard), and 4 seconds.
* Check the prompt and settings, then click **Start Generation**.

![Use a video skill](/_fern-files/_img/f484f23e8cca1216eba44566535dd48fc6fc685eff382fb46930ceafdd278284.webp)

#### My Skills

**My Skills** lets you view and create custom video skills visible only to your account. Click **New Skill** to specify creative methods and prompt requirements, then save them for reuse.

**Interface:**

* Switch to **My Skills** to see custom skills. The screenshot shows an empty list; click **New Skill** at the top right or in the empty state.
* The new-skill dialog includes **View Filling Example** for reference.
* Enter a name, summary, and core prompt template; you can also set category, tags, applicable type, composition and structure, visual style, detail guidance, output requirements, and negative constraints.
* Click **Save Skill** when finished; to discard changes, click **Cancel** or close the dialog.

![My video skills and the new-skill dialog](/_fern-files/_img/c5d63d77900c9c1e8af82e13a29ba7d23c3737bd4d96af5362413cfa3f635fea.webp)

From **My Skills**, click **New Skill** to save frequently used video creation requirements as a personal skill for later use. Newly created skills are visible only to you.

![](/_fern-files/_img/5a32db5a3392d0201e3b9fe14b201b98dc9cb288d666443a59bf09a8891e76fb.webp)![](/_fern-files/_img/092fb93dfb4bf07adc358eca133792d8549b0375fd80bbd846aafbc30ba5e7fb.webp)![](/_fern-files/_img/2e5562409c7f0f77e867a5d93c84c82a8a28dad80b00e01457ac767f1c3b15ed.webp)![](/_fern-files/_img/9e3c8fc351d86163f76914f5c12620e4edb04b8127af7a3ef425fa0e3fd096ac.webp)![](/_fern-files/_img/7031488f15382c2633320eb9a5116c003ec04b33fc585fa354123eecba96b500.webp)![](/_fern-files/_img/376822dd14c71e1154cd5f415d591db7f7cc6c38c411c7729e74569c6f6f7ded.webp)![](/_fern-files/_img/cb2cde06d46f7645f42fd146c80f7af76077976af1736fce12bb4f6f57338e48.webp)![](/_fern-files/_img/d5e0a4882f4af79d4d3ad678c0e42ac35419d1b1a15df4501a31b82769f40584.webp)![](/_fern-files/_img/cbf6b29f960579ca0a63565a3baedb39642a00224c522ea031d74e73901ee40a.webp)![](/_fern-files/_img/5818dc164e2a6c0c3ab77ea152409a5b7eec719f03b962bbb77ed31bd93e596f.webp)![](/_fern-files/_img/f8268f3c4d999a6b294872d0e465056bc4e9af9ebaf17ecac436bb21ef0c37ea.webp)![](/_fern-files/_img/b33e15f1e791bea854d0bff7ff8da1bcb33a7d2b8033a59b58c64ff145b74630.webp)![](/_fern-files/_img/6dbf07f1dec6a2ca126da10c7429ad23798379dfb3b70682e025c9c2826f1c2b.webp)![](/_fern-files/_img/950165ac4d74a19b9158b157eef7daa3fc91421484dade7c35796db3df667014.webp)![](/_fern-files/_img/dca220ed41f25fc4fca42484927ff61343a111a74c7cae35cee9a6c0c22362e7.webp)![](/_fern-files/_img/14744ab3409e78e8b33248202a40d603a1b1befe66bfd349877032c2750b8d2e.webp)![](/_fern-files/_img/32d9ce85166d1a7e7456befc56959cee7b81037c265ac0c261ef9f03f006c547.webp)![](/_fern-files/_img/b9e4e53f5ac6f6b9e1fc250a3edc29fb2ba915d8f499218ea5b7265ffea0625b.webp)![](/_fern-files/_img/38fa4ef1a3d4f5a9096f7be75c219053838222bbf4b065b6913d724ea336011e.webp)![](/_fern-files/_img/77df77f09935928900e27d4a54974060912086875e26389419ade71850eba20c.webp)![](/_fern-files/_img/f0eae2699e387ac23c89d49f8eb4fa3a53eb366a6e95cd92d6a214c9d49c618c.webp)![](/_fern-files/_img/e0e89ad5a03f40a71529914f92f708f5569b41dba8fcc1c0205ebd48f34710d4.webp)![](/_fern-files/_img/6501c57184a0a642e30716610883b0bbd7f130162fd443dd0b58899207d716da.webp)![](/_fern-files/_img/4d1573ba1e50ea17caf6afb501cee6cd9a92c32d5f424290d6eb6361acab5050.webp)![](/_fern-files/_img/34dc654e9f5935c17245540f97c6d6c4d59682e1da1e8a134c182301cd257981.webp)![](/_fern-files/_img/c32bcf680fd3c84d7307162c44a19ccbefe4917e0ce9364f52321fe1b24b6233.webp)![](/_fern-files/_img/3aa8812c8f8df8b80ba5efc259ef8685214c2bcb68ac847cc7e16f1f7c9e1994.webp)![](/_fern-files/_img/9610b1779b087acf42aadd55e18a2e7528b26001a954edc516d9a4c88e3dc852.webp)![](/_fern-files/_img/8d2a80973f778928087382781b36fa24e71f522fcd8adf178dd721181e567378.webp)![](/_fern-files/_img/4b877589efe4823749a38525821acaa9ca5614969701f35da74adc7da464a7b3.webp)![](/_fern-files/_img/424edacb70f92d8e27d5483d9c6c90ab7c2dd42066511e6777517989e16e006c.webp)![](/_fern-files/_img/2fac47aa03a1020395f8d1f2d28110c56fff6d89ebf541fc0916fcef6ab6b066.webp)![](/_fern-files/_img/5ef85e12b120f5d05bb3989617ae543ff5432bd43229c0aecaa10cda8fb5350a.webp)

## FAQ

<dl>
  <dt>
    Why can't I send a message when I already have a Key?
  </dt>

  <dd>
    Check that it belongs to this environment, is selected as the default or dedicated Key, and was saved. Also check the account balance, budget, daily quota, and model permissions.
  </dd>

  <dt>
    Why can I use JoyToken Agent without adding it first?
  </dt>

  <dd>
    It is a built-in, general-purpose assistant. Add other Agents from the Marketplace as needed.
  </dd>

  <dt>
    Why can the assistant answer from my materials when the knowledge base says it has 0 files?
  </dt>

  <dd>
    The count in the configuration picker may differ from Knowledge Base Details. Check the file's status and actual retrieval result rather than relying on one count.
  </dd>

  <dt>
    Why is a task still awaiting acceptance after it ran?
  </dt>

  <dd>
    Review the result and click 

    **Confirm Acceptance**

    .
  </dd>

  <dt>
    Will deleting a plan remove the task?
  </dt>

  <dd>
    Deleting the plan stops future automatic runs; the task and its history remain.
  </dd>

  <dt>
    Why do conversation totals differ from Usage?
  </dt>

  <dd>
    Calculation times and coverage may differ. Compare the same time range, Key, and calls; use settled usage details as the final source.
  </dd>

  <dt>
    Can I use every capability mentioned in a Skill description?
  </dt>

  <dd>
    It still depends on the model, tools, and runtime environment. Verify against the actual configuration.
  </dd>

  <dt>
    What should I provide when a model or tool fails?
  </dt>

  <dd>
    Provide the environment, time, assistant, steps, error, and request identifier. Do not share full Keys, verification codes, or passwords.
  </dd>
</dl>