Skip to main content
MeshAgent Studio is the browser-based workspace for building, testing, and operating MeshAgent projects. With MeshAgent Studio you can:

​
Project selector and account menu

MeshAgent Studio opens to an active project. Use the dropdown in the upper-left corner to switch between projects you belong to or create a new one. Use the menu in the upper-right corner to sign out. Admins may also see an Account management entry that opens MeshAgent Accounts.

​
Project navigation

The main project sidebar and available actions depend on your project role: Some project pages are opened contextually instead of living in the permanent sidebar. For example, Studio links to Billing when a project is out of credits or after checkout flows.

​
Rooms

Use rooms to isolate agent runtime environments. Rooms are secure environments where humans and agents can collaborate and share context. Rooms can have their own services, scheduled tasks, routes, mailboxes, and feed subscriptions. From the MeshAgent Studio UI you can:
  • Create a room with New Room when your project role allows room creation
  • Toggle between My Rooms and All Rooms. All Rooms is available to developers and admins.
  • Open a room from the list to enter its workspace.
  • Use the room menu to open Edit, Services, Scheduled Tasks, Mailboxes, Feeds, Routes, Permissions, or Delete.

​
Sessions

Monitor and debug live and recent room sessions. A session starts when a room starts and stops when the room stops. For the API and data model behind what you see here, see Sessions. From the Sessions page you can:
  • Create a session with New Session
  • Toggle between Active Sessions and Recent Sessions
  • Open a session to inspect Logs, Traces, and Metrics
  • Stop an active session from the row menu

​
Room Workspace (inside a Room)

From both Rooms and Sessions you can open the Room Workspace. This is where you develop, test, and debug agents and tools. Opening a room starts or joins a live session. Room-scoped services remain available to the room beyond any single session.

​
Layout

  • File Browser (left): Browse room files. Depending on your permissions, you can create folders and text files, upload and download files, and remove files.
  • File Previews (center): Open documents, code, tables, markdown notes, memory viewers, and other room resources in tabs.
  • Messaging (right): Chat with human and agent participants in the room.
  • Developer Console (bottom): Live debugging tabs for Logs, Traces, Metrics, Images, Containers, Services, and Terminal.
The container-related tabs serve different jobs:
  • Images shows images already pulled or built for the room runtime.
  • Containers shows running and stopped room containers, along with logs and runtime actions.

​
Room Menu (upper left)

  • Leave Room: Exit the room and return to the project view
  • Call Agent: Invoke a room-connected agent directly
  • Toolkits: View available tools and toolkits in the room and invoke them directly
  • Queues: View room queues and the number of messages in each queue
  • Dataset: Open the room dataset and work with tables
  • Memory: Open room memory viewers
  • Room Services: View, add, remove, and update services tied to this room
  • Scheduled Tasks: Manage tasks that enqueue work on a schedule
  • Mailboxes: Manage mailboxes that route into this room
  • Feeds: Manage visible feeds and storage subscriptions for this room
  • Routes: Manage domains and ports that route into this room
  • Keychain: Review and manage user-owned credentials as the new secret workflows roll out
  • View Toggles: Show/hide File Browser, File Previews, Messaging, and Developer Console

​
API Keys

Issue and rotate project-scoped credentials used by automations, CI, and services that call MeshAgent APIs. See API Keys for the full reference. You can:
  • Create, relabel, and revoke keys
  • Track when a key was created for audit and rotation

​
System Services

Services turn your agents, toolkits, or connectors into reusable building blocks. Project-wide services are managed from the System Services page. Room-scoped services are managed on the room itself, either from the room list or from inside the Room Workspace. For deployment flows and service packaging, see Service YAML. From System Services you can:
  • Inspect what’s deployed to the project
  • Create, update, or remove deployed services
  • Change the Room Server Version if you need to pin a project to a specific version of MeshAgent or return to latest
Service inspection is available to users with service inventory access. Creating services requires the project service_creator role, and updating or deleting services requires service_manager.

​
Integrations

Bring your own model routing and observability settings. See Integrations for the full configuration reference: LLM provider settings
  • Use MeshAgent-managed routing by default, or configure your own provider credentials and base URLs for providers such as OpenAI and Anthropic.
  • Services, coding agents, and compatible SDK clients can use MeshAgent LLM Proxy to route requests through those project settings.
Telemetry (OTEL)
  • Export room/runtime metrics and traces by providing an OTEL endpoint and optional bearer token.
  • Optionally configure an OTEL filter endpoint before MeshAgent processes and forwards telemetry.

​
LLM Proxy

Open LLM Proxy from the project navigation when you want the project’s provider-compatible base URLs or want to inspect routed usage for your own account. From this page you can:
  • open the About tab to copy the OpenAI-compatible and Anthropic-compatible base URLs
  • open the My Usage tab to inspect your routed LLM usage for the current project
  • open the main LLM Proxy docs from the built-in Read docs link

​
OAuth

Create OAuth2/OIDC clients to enable MeshAgent to sign in for your apps. A client is used to identify a single app to MeshAgent’s OAuth servers. OAuth client actions require the project OAuth client inventory, creator, or manager roles. See OAuth Clients for the full setup flow.
  • Register a client with redirect URIs, scopes, grant types, and response types.
  • Create, edit, and delete clients from the project.

​
Routes

Use Routes to map project or room traffic to the right room. See Routes for the full route model and setup details. From this page you can inspect routes, and users with route creator or manager access can create, edit, refresh, and delete routes, including the domain and port that should route into a room.

​
Scheduled Tasks

Use Scheduled Tasks to enqueue work on a schedule. See Scheduled Tasks for the full behavior and examples. From this page you can inspect scheduled tasks, and users with scheduled task creator or manager access can create tasks at the project or room level, edit schedules, toggle tasks on or off, and delete tasks that are no longer needed.

​
Mailboxes

Provision room-scoped mailboxes that agents can read from or send through. See Mailboxes for the full setup flow:
  • Inspect mailboxes, or create mailboxes and assign them to rooms when you have mailbox creator or manager access
  • Map incoming mail to queues so worker agents can process it asynchronously
  • Edit or delete mailboxes when your routing changes

​
Feeds

Use Feeds to manage project feeds and room storage subscriptions. See Feeds for the full model and examples:
  • Inspect feeds, or create feeds and choose visibility, schema validation, and paused state when you have feed creator access
  • Publish a single JSON message or import a JSONL file into a feed
  • Open a room-scoped Feeds… view to manage which feed subscriptions deliver into that room
  • Inspect subscriptions that write feed batches into room storage paths

​
Billing

Billing is available through direct Studio flows when a project needs attention, but the underlying billing surface lives in MeshAgent Accounts. From the billing page you can:
  • View current credit balance and spend
  • Purchase credits
  • Configure automatic recharge

​
Next Steps

  • Follow the Quickstart to create your first project, room, and agent from the CLI.
  • When you are ready for production, read Service YAML to write and deploy service manifests.