> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced tab

> Output Schema — force structured JSON responses for API callers

The **Advanced** tab houses configuration that isn't in the common path. Today it has one setting: **Output Schema**.

<img src="https://mintcdn.com/pinkfishai/ZcYFyF2aB9Gj-xv4/images/agents/advanced-tab.png?fit=max&auto=format&n=ZcYFyF2aB9Gj-xv4&q=85&s=decb5e17e461400ab83d90692e850f69" alt="Advanced tab showing the Output Schema section with a description, a Builder / JSON Editor toggle, a Schema Type dropdown set to Object, and a Properties table with a single row named 'result' of type String with a Required toggle, and an Add Property button" width="1440" height="900" data-path="images/agents/advanced-tab.png" />

## Output Schema

> *"Optional JSON schema that defines the structure of agent responses when called via API. This ensures consistent, structured outputs that are easier to parse and integrate with other systems."*

When set, every API response from this agent conforms to the schema you defined. No more hand-rolling regexes against free-text replies — the agent returns a validated JSON object you can hand straight to your downstream code.

### Who this is for

Output Schema matters almost exclusively for **programmatic callers** of the [Agent Management API](/api-reference/platform/agent-management). If you only ever chat with the agent in Coworker, Slack, or Teams, leave it blank — those surfaces display the free-form reply the model produced.

### How to configure

The editor has two modes — switch via the **Builder / JSON Editor** toggle at the top.

#### Builder mode

A visual builder:

* **Schema Type** — pick the top-level shape. Usually `Object`, but primitives are supported too.
* **Properties** — a table of fields, each with a name, a type (`String`, `Number`, `Boolean`, `Object`, `Array`, etc.), and a **Required** toggle (shown as a green switch when on).
* **Add Property** — append a new row. For complex shapes, drill into a property to set nested properties, descriptions, and enum values.

#### JSON Editor mode

Paste or hand-write a standard JSON Schema. Handy when you already have a schema defined elsewhere and want to copy it over.

```json theme={null}
{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "One-sentence summary of the user's question"
    },
    "action_items": {
      "type": "array",
      "items": { "type": "string" }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": ["summary", "confidence"]
}
```

### What it does at runtime

* **API callers** — responses are returned as JSON matching the schema. The agent retries internally if the model's first attempt is malformed.
* **Coworker / Slack / Teams** — the platform extracts the message field from the response and renders it as normal prose. The schema is still enforced on the underlying object, but users see a regular chat reply.

### When *not* to set an output schema

* You want the agent to reply conversationally — `Output Schema` trades naturalness for predictability.
* Your responses need to be long-form essays or creative writing. Narrow the schema only to fields you genuinely need downstream.
* You're still iterating on behavior. Nail the agent's content first, then add a schema once the shape is stable.

## What's *not* on the Advanced tab

Things people sometimes look for here but won't find:

* **Model selection** — lives on [Instructions](/agents/instructions).
* **Temperature, max tokens, reasoning effort** — controlled via the model choice on Instructions (e.g. `Opus Low / Med / High` as discrete thinking-effort levels).
* **Rate limits / concurrency** — managed at the subscription and org level, not per agent.
* **Delete agent** — use the chevron-menu next to the agent name in the top bar, or the row action on the [My Agents](/agents/my-agents) list.
* **Share / ACL controls** — use the **Share** action on the top-bar name chevron.

## Related

* [Agent Management API](/api-reference/platform/agent-management) — where structured output actually matters.
* [Instructions tab](/agents/instructions) — where the model is chosen.