Studio Overview
Use Anvia Studio to inspect and run agents during development.
Anvia Studio is a local UI and HTTP runtime for built agents. Use it when you want to try prompts, inspect tool calls, review traces, and approve protected tool actions without building your own internal console first.
The Primitive
The primitive is Studio.
import { Studio } from "@anvia/studio";
new Studio([agent]).start();Studio does three things:
| Primitive | What it does |
|---|---|
new Studio([agent]) | Registers one or more built Anvia agents |
.start(...) | Starts the local HTTP runtime and bundled Studio UI |
.fetch(request) | Lets tests or another runtime call the same Studio API without opening a port |
What To Do First
- Build an agent with
AgentBuilder. - Register the built agent with
new Studio([agent]). - Start Studio on a local port.
- Open the Studio UI and send a prompt.
- Add tools, approval hooks, sessions, and traces as the workflow becomes more realistic.
Minimal Shape
import { AgentBuilder } from "@anvia/core";
import { OpenAIClient } from "@anvia/openai";
import { Studio } from "@anvia/studio";
const client = new OpenAIClient({ apiKey });
const model = client.completionModel("gpt-5");
const agent = new AgentBuilder("support", model)
.name("Support")
.description("Answers short support questions.")
.instructions("Keep answers concise and ask for missing order ids.")
.build();
new Studio([agent]).start({ port: 4021 });Open http://localhost:4021/playground.
When To Use Studio
| Use Studio when | Keep using the SDK directly when |
|---|---|
| You want a local playground for agents | You are shipping your product runtime |
| You need to inspect messages, tools, and traces | You only need one scripted call |
| You want human approval flows during development | Your app already owns the full UI |
| You want persisted local sessions | You have production conversation storage |
Studio is a development and internal-operations surface. Your application still owns product auth, user permissions, storage policy, and production UI.