mosoodocs

Create your first Agent

Configure, test, and publish an Agent from the mosoo console.

This guide takes you from an empty App to a published Agent.

1. Open an App

Sign in at cloud.mosoo.ai. mosoo creates a Default App for a new account. Use the App switcher to create or open another App when you need a separate resource and usage boundary.

2. Add a Provider key

Open Config → Providers. Add a key for the runtime you plan to use and run the optional connection test. A ready runtime appears at the top of the page.

Provider credentials belong to the active App. Saved keys are masked; exported Agent packages do not contain them.

3. Create the Agent

Open Agents → Create agent, enter a name, and choose a runtime.

The New Agent dialog offers Claude Agent SDK, OpenAI Runtime, and OpenCode.

  • Claude Agent SDK resolves an Anthropic key.
  • OpenAI Runtime resolves an OpenAI-compatible key and requires a compatible Responses API endpoint.
  • OpenCode can use supported provider credentials, including custom OpenAI-compatible endpoints.

4. Configure behavior

In Preview, choose Assistant Agent or Task Agent, then set the model and system prompt. Add Skills, MCP servers, or a custom Environment only when the Agent needs them.

Agent Preview combines live testing with the configuration editor.

5. Test before publishing

Send a representative task in the left Preview pane. Verify the answer, tool calls, files, and failure behavior. Use Logs for execution details and Cost for model usage. Assistant Agents also expose a Terminal and reset controls for their working environment.

6. Publish

Open Publish and publish the draft. The first publish locks the Agent type. Later sessions start on the current published version; existing sessions keep the version they started with.

After publishing, choose a delivery surface:

  • Thread — start work inside the mosoo console.
  • API Access — obtain the Agent ID and call the Public Thread API.
  • Instruction for LLM — copy Agent instructions for supported coding-agent workflows.

On this page