---
app: agent
audience:
  - owner
since: 0.1.7
ui_only: false
agent_actions:
  - tool: app_company_brief_get
    permission: auto
    example: what does our company brief say?
  - tool: app_company_brief_set
    permission: confirm
    example: add to the brief that we opened a branch in Bandung
agent_examples:
  - update the company brief
  - tell all agents our new opening hours
llm_weight: normal
title: The company brief
description: One text every agent reads at the start of a conversation — what
  you sell, to whom, how you speak.
editUrl: true
head: []
template: doc
sidebar:
  order: 5
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { Steps, Aside } from "@astrojs/starlight/components";
import { AgentAsk, Shot } from "@components";

**Who this is for:** an owner who wants every agent to know the business without repeating it in every chat.

## What goes in

Settings → **Company** holds one Markdown text of up to **10,000 characters**. Good content:

- what you sell, your price points and who buys;
- how you want customers addressed (tone, greeting, language);
- opening hours, branches, delivery areas, payment methods;
- house rules ("never promise a delivery date without checking stock").

Bad content: anything secret (keys, passwords, margins) — agents quote the brief to customers when it helps.

## Steps

<Steps>

1. Open **Settings → Company**. <Shot src="agent/office/company-brief.png" alt="Settings, Company card" />

2. Paste or edit the text, then **Save**. The counter shows the remaining characters.

3. Every agent reads the new brief **at the start of its next conversation**. Running conversations keep the old one until they end.

</Steps>

<Aside type="note">
  Room and role briefs are added automatically on top of the company brief; you do not repeat department details here.
</Aside>

## Ask your agent

<AgentAsk />

## Limits & safety

- 10,000 characters. Longer text is refused, not truncated.
- The brief is part of every agent's instructions — a change through an agent asks for your confirmation first.

## Related

[Add an agent](/agent/office/add-an-agent/) · [Marketing preferences](/agent/marketing/preferences/)