{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["platform-badges","cards","card"]},"redocly_category":"AI","product_name":"Treasure AI Studio","type":"markdown"},"seo":{"title":"Agent Channels in Treasure AI Studio","description":"Agent Channels let your own application run Treasure AI Studio chats through the Agent Gateway, anchored to one shared work folder and one executor.","siteUrl":"https://docs.treasure.ai","image":"/assets/treasure-ai-social-preview.e6fefb35676f6da91c2d1bc783bd39e618e7af2b1ad3aa52a96ae69d72e700fe.b1bff462.png","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/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"agent-channels","__idx":0},"children":["Agent Channels"]},{"$$mdtype":"Tag","name":"PlatformBadges","attributes":{"platforms":["Web","Desktop"]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Agent Channel is a governed entry point that lets software outside Treasure AI Studio run chats inside it. Your application gets the same agent your team talks to in Studio — grounded in the same shared work folder, running with the same permissions — without you building an agent, hosting a model, or handing anyone a login. Set one up when a product you own needs a conversation with your data in it: a support widget, an internal tool, a customer-facing assistant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page explains what an Agent Channel is, what it fixes at creation time, and how a request travels from your application to an answer. The pages under it cover creating one, the credentials involved, and writing the application itself."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-an-agent-channel-is","__idx":1},"children":["What an Agent Channel Is"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Agent Channel is a named, account-level object that binds together three things: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one shared work folder"]}," the chats read, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one executor"]}," whose permissions and credits the chats run with, and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one or more connection secrets"]}," your application authenticates with. Every chat that arrives through the channel gets exactly that combination — there is no request parameter that changes it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Anchoring the folder and the executor to the channel, rather than to the secret, is what makes a channel governable. A secret carries no permissions of its own, so issuing another one grants nothing new, and rotating one cannot widen what the channel reaches without anyone noticing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Agent Channels come in one kind, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK App"]},": an entry point for an application you host, which creates chats from its own server and streams them to its users."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-request-reaches-an-agent","__idx":2},"children":["How a Request Reaches an Agent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your application never talks to Treasure AI Studio's internal APIs. It talks to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent Gateway"]},", a service that speaks the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://ai-sdk.dev/"},"children":["Vercel AI SDK"]}," UI Message Stream protocol so you can drive a chat with an unmodified open-source client."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A[\"End user
(browser or mobile)\"] --> B[\"Your server
holds the Gateway Token\"]\n B -->|\"Create a chat\"| C[\"Agent Gateway\"]\n C -->|\"Chat Access Token
+ endpoint URLs\"| B\n B -->|\"Run a turn (SSE)\"| C\n C --> D[\"Treasure AI Studio
agent + shared work folder\"]\n D -->|\"Streamed answer\"| C\n","diagramHtml":"

Create a chat

Chat Access Token
+ endpoint URLs

Run a turn (SSE)

Streamed answer

End user
(browser or mobile)

Your server
holds the Gateway Token

Agent Gateway

Treasure AI Studio
agent + shared work folder

","diagramHtmlDark":"

Create a chat

Chat Access Token
+ endpoint URLs

Run a turn (SSE)

Streamed answer

End user
(browser or mobile)

Your server
holds the Gateway Token

Agent Gateway

Treasure AI Studio
agent + shared work folder

"},"children":["flowchart LR\n A[\"End user
(browser or mobile)\"] --> B[\"Your server
holds the Gateway Token\"]\n B -->|\"Create a chat\"| C[\"Agent Gateway\"]\n C -->|\"Chat Access Token
+ endpoint URLs\"| B\n B -->|\"Run a turn (SSE)\"| C\n C --> D[\"Treasure AI Studio
agent + shared work folder\"]\n D -->|\"Streamed answer\"| C\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Four things happen, in this order:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Your server creates a chat"]}," by calling the Agent Gateway with its ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gateway Token"]},", the channel's long-lived connection secret."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The gateway answers with a Chat Access Token and a set of endpoint URLs."]}," That token is scoped to that one chat and nothing else."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Turns run against those endpoints"]},", streamed as server-sent events. Your server can proxy them, or your client can call the gateway directly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The agent works inside the channel's shared work folder"]},", reading it as the executor, and its answer streams back the same way."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The two credentials exist because the second one can safely reach a browser and the first one cannot. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/tokens"},"children":["Gateway Tokens and Chat Access Tokens"]}," explains what each one permits and how long it lives."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-an-sdk-app-fixes-at-creation-time","__idx":3},"children":["What an SDK App Fixes at Creation Time"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The choices that decide how much a channel exposes are made once, when it is created, by someone who already holds the permission to make them:"]},{"$$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":{"width":"28%","data-label":"What Is Fixed"},"children":["What Is Fixed "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"72%","data-label":"Meaning"},"children":["Meaning "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared work folder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The single folder the channel's chats can read. Chosen from folders the creator manages, and it cannot be changed afterward — a different folder means a different SDK App"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Executor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Treasure AI Studio user the chats run as. Always the creator at first; another manager of the same folder can take over later. Permissions, connections, credits, and audit trail all follow the executor — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["never the end user who triggered the chat"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Browser access"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the gateway accepts calls that carry an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Origin"]}," header. Off by default, which means only your server can drive a chat"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chat Access Token lifetimes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["How long a per-chat credential survives idle, and its absolute ceiling. Defaults are 24 hours and 30 days"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because these are fixed on the channel, an end user of your application has no way to reach a second folder, borrow someone else's permissions, or extend their own access. What they can do is send a prompt and stop a running answer — ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/channel-chats"},"children":["What an Agent Channel Chat Can Reach"]}," sets out the full boundary, including the parts that are ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["not"]}," restricted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"where-agent-channels-live","__idx":4},"children":["Where Agent Channels Live"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Agent Channels have their own section in Treasure AI Studio's settings, on Web and Desktop. Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Agent Channels"]}," to see the account's channels."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every member of the account can see that a channel exists, along with its name and status. The folder it reaches, its executor, its connection settings, and its tokens are shown only to the people who manage that folder, the executor, and account administrators — for everyone else those cells are masked. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/sdk-apps"},"children":["Creating and Managing an SDK App"]}," covers the page in detail."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"who-does-what","__idx":5},"children":["Who Does What"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Setting up a channel involves up to three roles, and one person often fills more than one:"]},{"$$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":{"width":"26%","data-label":"Role"},"children":["Role "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"74%","data-label":"Responsibility"},"children":["Responsibility "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Folder manager"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creates the SDK App, picks the folder, issues and revokes connection secrets, and deletes the channel. Opening a folder to an outside application is their decision, so the irreversible actions stay with them"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Executor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consents to chats running under their permissions and cost. Becomes executor by claiming the role, and can step down at any time, which stops the channel but leaves it and its tokens intact"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account administrator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sees every channel in the account, can switch one off or back on, and sets who may create channels. Being an administrator alone does not let them create, edit, delete, or revoke — administrator actions on a channel are all reversible by design"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whether a folder manager can create a channel at all depends on the account's creation policy: by default any folder manager can, and an account administrator can limit creation to administrators. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/sdk-apps#choose-who-can-create-agent-channels"},"children":["Choose Who Can Create Agent Channels"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-a-channel-covers","__idx":6},"children":["What a Channel Covers"]},{"$$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":{"width":"34%","data-label":"Aspect"},"children":["Aspect "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"66%","data-label":"Detail"},"children":["Detail "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Kinds of channel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One: the SDK App. One shared work folder per channel, running as a fixed executor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Protocol"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Vercel AI SDK UI Message Stream — the one protocol the Agent Gateway publishes for chat clients"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Per-channel tool and credential restrictions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None. A channel's chats run with the executor's full set of tools, connections, and credentials — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/channel-chats#what-is-not-restricted"},"children":["What an Agent Channel Chat Can Reach"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"frequently-asked-questions","__idx":7},"children":["Frequently Asked Questions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do my application's users need Treasure AI Studio accounts?"]}," ","No. An Agent Channel exists so that people without a Treasure AI Studio account can use an agent through your application. Identifying your own users, and deciding which of them may start a chat, is your application's job."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Whose credits do these chats consume?"]}," ","The executor's. Every chat created through a channel is attributed to the executor for permissions, connections, quota, and cost, regardless of which end user triggered it. Budget for a channel as you would for one heavy user."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can two applications share one SDK App?"]}," ","They can share a Gateway Token, but it is usually not what you want. A channel is the unit you disable, delete, and audit, so two applications sharing one lose the ability to stop one without stopping the other. Create one SDK App per application and give each its own token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can an Agent Channel write to the shared work folder?"]}," ","No. The channel's chats can read the folder but never write to it, and the scratch space each chat writes to is discarded when the chat ends. Anything the agent produces has to leave through the conversation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can I see these chats in Treasure AI Studio?"]}," ","The executor sees them in their own chat list, labelled ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK App"]}," with a key on the chat icon, which distinguishes them from chats started in the app."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":8},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Creating and Managing an SDK App","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/ai-studio/agent-channels/sdk-apps"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a channel, issue its first token, and run it: statuses, executor handover, and shutdown."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Gateway Tokens and Chat Access Tokens","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/ai-studio/agent-channels/tokens"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The two credentials, what each one permits, how long they last, and how to rotate and revoke them."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Building a Chat App with the Vercel AI SDK","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/ai-studio/agent-channels/building-an-app"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create chats from your server, stream turns with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["useChat"]},", and handle the one tool you must implement."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"What an Agent Channel Chat Can Reach","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/ai-studio/agent-channels/channel-chats"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The workspace, the credentials, and the limits that apply to a chat arriving through a channel."]}]}]}]},"headings":[{"value":"Agent Channels","id":"agent-channels","depth":1},{"value":"What an Agent Channel Is","id":"what-an-agent-channel-is","depth":2},{"value":"How a Request Reaches an Agent","id":"how-a-request-reaches-an-agent","depth":2},{"value":"What an SDK App Fixes at Creation Time","id":"what-an-sdk-app-fixes-at-creation-time","depth":2},{"value":"Where Agent Channels Live","id":"where-agent-channels-live","depth":2},{"value":"Who Does What","id":"who-does-what","depth":2},{"value":"What a Channel Covers","id":"what-a-channel-covers","depth":2},{"value":"Frequently Asked Questions","id":"frequently-asked-questions","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Agent Channels in Treasure AI Studio","description":"Agent Channels let your own application run Treasure AI Studio chats through the Agent Gateway, anchored to one shared work folder and one executor."},"platforms":["Web","Desktop"]},"lastModified":"2026-10-21T13:29:05.739Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/ai-studio/agent-channels","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}