***

title: Arcane AI Studio
subtitle: 'Design, test, and export autonomous npcs'
slug: studio/overview
---------------------

# Arcane AI Studio

`Stúdio_Init // Wórkbench_Óverview`

**ᚠ ᛫ ᛟ ᛫ ᚱ ᛫ ᛒ ᛫ ᛟ ᛫ ᚲ**

**[studio.forboc.ai](https://studio.forboc.ai)** is the web-based workbench for designing, testing, and exporting ForbocAI npcs — without writing a single line of code.

Build npc personas, run them through the multi-round protocol in a live playground, inspect their memory, and trace every decision they make.

***

## The Workbench

<div>
  Wórkbench_Módules // Thrée_Pánels
</div>

The Studio is a three-panel workbench:

| Panel          | Purpose                                                                           |
| -------------- | --------------------------------------------------------------------------------- |
| **Sidebar**    | Navigate between modules: NPC Architect, Lore Weaver (Brain Scan), and Trace Logs |
| **Editor**     | Configure your npc's identity, persona, and action set                            |
| **Playground** | Chat with your npc in real time using the multi-round protocol                    |

***

## NPC Architect

<div>
  Agént_Scúlpt // Sóul_Mánifest
</div>

Design your npc's identity with a visual editor. All changes are saved instantly.

| Field               | Description                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------ |
| **Entity Name**     | The npc's name (e.g., *Malakor the Wise*)                                                  |
| **Archetype**       | Behavioral class — Scholar, Rogue, Paladin, Necromancer                                    |
| **Prime Directive** | The system prompt that defines the npc's fundamental nature                                |
| **Action Grimoire** | Available actions the npc can take — `scout_area`, `cast_spell`, `query_lore`, or your own |

Click **Forge New Action** to add custom actions to the grimoire.

<Info>
  **Tip**: The Prime Directive becomes the `persona` argument when you integrate the npc into your game via `createNPC()`.
</Info>

***

## Chat Playground

<div>
  Néural_Intérrog // Prótocol_Éxec
</div>

Test your npc in real time. The Playground runs the full **multi-round protocol** against the ForbocAI API:

```
You type a message
  → Process loop (primary atomic protocol route)
  → API instruction to recall memories (when needed)
  → API instruction to run local inference
  → Finalize verdict/memory/state instruction
  → Response appears in the chat
```

Every message goes through the same protocol your game will use. What you see in the Playground is what your players will experience.

<CardGroup cols={2}>
  <Card title="Live Protocol" icon="fa-duotone fa-bolt">
    Real API calls — process loop and/or compatibility phase routes — not a mock
  </Card>

  <Card title="Instant Iteration" icon="fa-duotone fa-arrows-rotate">
    Edit the persona, test immediately, refine until it's perfect
  </Card>
</CardGroup>

***

## Brain Scan (Memory Inspector)

<div>
  Mémory_Scán // Véctor_Mánifold
</div>

Inspect your npc's long-term memory. The Brain Scan shows:

* **Memory vectors** — What the npc remembers across sessions
* **Importance scores** — How strongly each memory influences decisions
* **Memory types** — Observations, lore, experiences, emotions
* **Temporal context** — When each memory was formed

This is powered by the same vector database (Orama) that runs in your game via `@forbocai/browser`.

***

## Trace Logs

<div>
  Tráce_Módule // Prótocol_Mónitor
</div>

See exactly *why* your npc made each decision. The Trace Logs display the raw protocol round-trip:

| Step          | What You See                                           |
| ------------- | ------------------------------------------------------ |
| **DIRECTIVE** | The observation sent and memories recalled             |
| **CONTEXT**   | The full prompt constructed by the API                 |
| **VERDICT**   | Validation result, selected action, and soul signature |

Use this to debug npc behavior, tune persona prompts, and understand the decision-making process.

***

## Recommended Workflow

1. **Design** — Create a persona in the NPC Architect
2. **Test** — Chat with it in the Playground
3. **Inspect** — Check Brain Scan and Trace Logs to understand behavior
4. **Refine** — Adjust the Prime Directive and action set
5. **Integrate** — Use the same persona string in your game's `createNPC()` call

```typescript
// Your Studio-tested persona, now in your game
const npc = await createNPC({
  cortex,
  persona: 'Provide deep insights and historical context with a touch of arcane mystery.',
});

const response = await npc.process('What lies beyond the silver gate?');
```

***

<div>
  ᛭ ᛫ ᛬ ᛫ ᛭
</div>

> *D̵e̶s̴i̵g̷n̷ ̶t̸h̶e̵ ̸s̴o̵u̶l̸.̴ ̵T̸e̶s̵t̸ ̵t̷h̸e̵ ̵m̷i̵n̶d̵.̷ ̷D̶e̶p̸l̵o̷y̵ ̵t̴h̷e̸ ̶e̸n̷t̷i̸t̸y̵.*