{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["platform-badges","admonition","img"]},"type":"markdown"},"seo":{"title":"Treasure AI Studio - Custom Instructions","description":"Treasure AI Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"custom-instructions","__idx":0},"children":["Custom Instructions"]},{"$$mdtype":"Tag","name":"PlatformBadges","attributes":{"platforms":["Web","Desktop"]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A custom instruction is organization-wide guidance an account administrator"," ","sets. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/overview"},"children":["Treasure AI Studio"]}," adds it to the system prompt of every"," ","agent in your organization, so agents are guided by your shared"," ","conventions — a preferred database, an output format, a house style for"," ","summaries — instead of each user restating them in every conversation. There"," ","is one custom instruction per organization; use it for expectations that should"," ","apply across work folders, chats, and users."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Where you edit this"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You set the custom instruction in Studio's settings on Web or Desktop. It is"," ","then added to the prompt for chats on every platform, including Mobile."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Who can set this"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only account administrators can view and edit custom instructions. Regular"," ","members do not see the Instructions settings tab; the instructions still apply"," ","to their chats."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"objective","__idx":1},"children":["Objective"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Give every agent in your organization a shared baseline of behavior by writing"," ","one custom instruction, and understand how it relates to per-work-folder"," ","instructions and when changes take effect."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["account administrator"]}," role in Treasure AI Studio"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Signed in on Web or Desktop (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/getting-started"},"children":["Getting Started"]},") — the"," ","Instructions settings tab is available there"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-custom-instructions-work","__idx":3},"children":["How Custom Instructions Work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A custom instruction is text an account administrator sets that Treasure AI"," ","Studio adds to every agent's system prompt across the organization. An agent's"," ","behavior is shaped in layers, and the custom instruction is the"," ","organization-wide layer:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Layer"},"children":["Layer"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Who Sets It"},"children":["Who Sets It"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom instruction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every chat in the organization, across all work folders and users"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account administrator"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Work folder instructions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Chats within one work folder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Anyone who edits that work folder (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/concepts"},"children":["Core Concepts"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These layers apply together. A custom instruction sets an organization-wide"," ","baseline; a work folder's instructions add work-folder-specific rules on top"," ","for chats in that work folder. Keep organization-wide conventions in the custom"," ","instruction and work-folder-specific detail in work folder instructions, rather"," ","than duplicating the same text in every work folder."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your account may also show a read-only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Managed instruction"]},", maintained by"," ","Treasure AI to tune agent behavior for your account. It is added to the prompt"," ","the same way; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#the-managed-instruction"},"children":["The Managed Instruction"]}," below."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The instruction is plain text you write in your own words — the same way you"," ","would brief a new team member. It is appended to the agent's system prompt, so"," ","phrase it as standing guidance (\"Default to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing"]}," database. Format"," ","summaries as bullet points.\"), not as a one-off request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"set-a-custom-instruction","__idx":4},"children":["Set a Custom Instruction"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," from the user avatar in the sidebar footer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Instructions"]}," tab under the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]}," section. This tab"," ","appears only for account administrators."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom instruction"]}," card, type your organization-wide guidance,"," ","staying within the 16,384-character limit shown by the counter. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," ","stays disabled while a draft is unchanged or over the limit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},". Save returns to its disabled state once the instruction is"," ","stored, confirming the change was saved."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ai-studio-custom-instructions.e2cc5446476732804e1586b499642a26d4b3778c7cc23f2f6d58aaddbeec5644.8a9297e8.webp","alt":"Settings Instructions tab under the Organization section, showing the Custom instruction card with its description, a note that changes apply to new chats only, an empty text editor, a 0 of 16384 character counter, and a Save button","framed":false,"withLightbox":true,"width":"700px"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To remove the instruction, clear the text and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},". An empty custom"," ","instruction means agents fall back to their default behavior."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Changes apply to new chats only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A chat reads the custom instruction when it is created. Editing or clearing the"," ","instruction changes ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["new"]}," chats started afterward; chats already in progress"," ","keep the instruction they started with. To apply an update, start a new chat."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"write-effective-instructions","__idx":5},"children":["Write Effective Instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom instructions are read by the agent, not by a person, so be specific and"," ","unambiguous:"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Keep secrets and PII out of instructions"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The custom instruction becomes part of the agent's system prompt, so it could"," ","be exposed. Don't include secrets, credentials, API keys, or personal data"," ","(PII)."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["State standing rules, not tasks."]}," \"Always validate YAML before pushing\" is"," ","a rule every agent can follow; \"build me a segment\" is a task for a chat."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name concrete defaults."]}," Databases, table naming conventions, date"," ","formats, and output structure are the highest-value things to fix once here."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keep it organization-wide."]}," Anything that only applies to one work folder"," ","or one analysis belongs in that work folder's instructions, not here."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Be concise."]}," A focused instruction is easier for agents to follow"," ","consistently than a long list of edge cases. Because it applies to every chat"," ","in your organization, a shorter instruction also adds less to the cost of"," ","each chat."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-managed-instruction","__idx":6},"children":["The Managed Instruction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alongside the custom instruction, administrators may see a read-only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Managed"," ","instruction"]}," section. This instruction is written and maintained by Treasure"," ","AI to tune agent behavior for your account. You cannot edit it; it is shown for"," ","transparency so you can see the full guidance agents receive. Like the custom"," ","instruction, it applies to new chats only."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verification","__idx":7},"children":["Verification"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," As an account administrator, open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Instructions"]}," and confirm"," ","you can edit the custom instruction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Save an instruction (for example, \"Format all summaries as bullet"," ","points\"), start a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["new"]}," chat, and confirm the agent applies it"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":8},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Issue"},"children":["Issue"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Instructions"]}," tab is not visible"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The tab appears only for account administrators. Confirm your role, or ask an administrator to set the instruction"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An updated instruction is not being followed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Changes apply to new chats only. Start a new chat, then confirm the behavior"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," is disabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Save is enabled only when the draft differs from the saved text and is within the 16,384-character limit. Shorten a draft that exceeds the limit — the counter turns red and an inline message appears"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An agent does not fully apply the instruction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As a conversation grows long, an agent may weight a long instruction less, and contradictory rules are hard to apply consistently. Keep the instruction concise and focused on the rules that matter most, and move work-folder-specific detail into ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/concepts"},"children":["work folder instructions"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":9},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/concepts"},"children":["Core Concepts"]}," — Work folders, work folder instructions, models, and credits"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/concepts/orchestrator"},"children":["Agent Orchestrator"]}," — How Studio plans and runs agent work"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/security"},"children":["Security & Permissions"]}," — Roles, access control, and data retention"]}]}]},"headings":[{"value":"Custom Instructions","id":"custom-instructions","depth":1},{"value":"Objective","id":"objective","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"How Custom Instructions Work","id":"how-custom-instructions-work","depth":2},{"value":"Set a Custom Instruction","id":"set-a-custom-instruction","depth":2},{"value":"Write Effective Instructions","id":"write-effective-instructions","depth":2},{"value":"The Managed Instruction","id":"the-managed-instruction","depth":2},{"value":"Verification","id":"verification","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Treasure AI Studio - Custom Instructions"},"platforms":["Web","Desktop"]},"lastModified":"2026-07-08T09:08:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/ai-studio/custom-instructions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}