One build from first prompt to published Branch, with screenshots from a real session.
These are the steps you’ll repeat for most build work. The screenshots are from a real session, so what you see here is what you’ll see in Studio.The example below adds a knowledge base topic, but the shape is the same whether you’re writing a flow, wiring an integration, or changing how the agent speaks: describe it, answer any questions, approve the plan, review what changed, then publish when you’re happy.
1
Start from the home screen
The chat panel opens with a prompt input. Choose See prompt suggestions for starters grouped by intent: Build, Test, Ask, and Analyze. Pick a suggestion, fill in the blank where there is one, or ignore them and type your own request.
Home screen with Build, Test, Ask, and Analyze suggestions
The more grounded your request, the fewer questions come back. “Add a topic for our office opening hours” works, but “Add a topic for our office opening hours: 9am to 6pm Monday to Friday, closed weekends and UK public holidays” gets you there in one turn. See the prompting guide for more.
2
Answer any clarifying questions
Rather than guess at business rules it can’t infer, Wren asks. Questions come in a set you step through: pick an option, choose Something else to type your own answer, or Skip to let Wren decide.
Step through the questions, or skip to let Wren choose
This is the step that stops Wren inventing your policies. If it doesn’t know your refund window or your opening hours, it asks rather than picking something plausible.
3
Approve or revise the plan
Once it has enough context, Wren presents a plan card summarizing what it intends to change, with Approve and Revise buttons. Nothing is written until you approve. Expand the card to read the full breakdown.
The plan, with Approve and Revise
Revise opens a feedback box. Say what should be different and Send to re-plan, or leave it blank to reject outright.
Revise sends feedback and re-plans
For small, unambiguous changes Wren may skip the plan and just do the work. The bigger or more structural the request, the more likely you’ll see a plan first. You can always force one by asking: “Plan this before making any changes.”
4
Watch it work on a Branch
The first time Wren makes a change it carries on in an open Branch that already covers the request, or otherwise creates a Branch off Live, named after the request and prefixed wren/. Live stays untouched, and the Branch switcher in the top-left shows Wren’s Branch for the rest of the session. Each step it takes is listed as it goes, with a running count of changes made.
A Branch is created automatically, and every step is listed as it runs
Expand the summary to see each step, and open any changed resource to check it by hand. Everything Wren wrote is an ordinary edit on your Branch, so you can adjust or undo it exactly as you would your own work.
5
Publish to Live
Publishing is yours to do. Wren never does it for you. Click Publish in the top-right, add a publish message and confirm. Your Branch merges onto Live and becomes the newest version in Live’s history. To check the diff first, choose Review changes from the Publish menu. See Compare changes for how to read it. If Live has changed since Wren created the Branch, the button reads Sync instead. Sync first, then publish.Not ready to publish? Leave the Branch where it is. You can come back to the same chat later, keep iterating, and publish when it’s right.
What to try next
Once you’ve been through this loop once, the rest of Wren is variations on it:
Prompting guide
Phrase requests so you get what you meant, in fewer turns.
What Wren can build
Every building block it can create and change.
Analyze conversations
Ask questions about real calls, no Branch needed.
Last modified on October 9, 2026
Was this page helpful?
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"PolyAI Platform","description":"PolyAI Platform documentation. Build, deploy, and monitor enterprise voice and chat agents ready for real customer conversations.","colors":{"primary":"#4a7c10","light":"#d9ee50","dark":"#3a6b08"},"logo":{"light":"https://mintcdn.com/polyai/V_YcZRE9nVwqIC42/logo/light.png?fit=max\u0026auto=format\u0026n=V_YcZRE9nVwqIC42\u0026q=85\u0026s=9b0704a17c929bf077c3b76f8dd9b852","dark":"https://mintcdn.com/polyai/V_YcZRE9nVwqIC42/logo/dark.png?fit=max\u0026auto=format\u0026n=V_YcZRE9nVwqIC42\u0026q=85\u0026s=8259c01154fc1823ae0d1a563bb20485"},"favicon":"https://mintcdn.com/polyai/5TqB0Il1JYn5J7QH/favicon.png?fit=max\u0026auto=format\u0026n=5TqB0Il1JYn5J7QH\u0026q=85\u0026s=8c7b583905e3376fb8df880384dc2421","background":{"decoration":"windows"},"navbar":{"links":[{"href":"https://docs.poly.ai/releases/overview","label":"Release notes"},{"href":"https://studio.us.poly.ai/","label":"Studio"},{"href":"https://github.com/polyai/android-sdk","label":"Android SDK"},{"href":"https://github.com/polyai/ios-sdk","label":"iOS SDK"}],"primary":{"type":"button","label":"Request a demo","href":"https://poly.ai/request-a-demo/"}},"footer":{"socials":{"x":"https://x.com/polyaivoice","youtube":"https://www.youtube.com/@polyaivoice","facebook":"https://www.facebook.com/PolyAIVoice","linkedin":"https://www.linkedin.com/company/polyai","discord":"https://discord.gg/wvyMKEpjkX"},"links":[{"header":"Resources","items":[{"label":"PolyAI website","href":"https://www.poly.ai"},{"label":"Request a demo","href":"https://poly.ai/request-a-demo"}]},{"header":"Legal","items":[{"label":"Privacy policy","href":"https://www.poly.ai/privacy-policy"},{"label":"Terms of use","href":"https://poly.ai/terms-of-use"}]}]},"search":{"prompt":"Search PolyAI docs..."},"seo":{"organization":{"id":"https://poly.ai/#organization","name":"PolyAI","legalName":"PolyAI Limited","url":"https://poly.ai","logo":"https://docs.poly.ai/logo/dark.png","sameAs":["https://poly.ai","https://github.com/polyai","https://www.linkedin.com/company/polyai/","https://pypi.org/project/polyai-adk/"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"ga4":{"measurementId":"G-6NHTTPDGSX"}},"banner":{"content":"Agent Studio has a new look. [See what changed](/get-started/whats-new)","dismissible":true},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page doesn't exist. Try the [documentation home](/home), the [API reference](/api-reference/introduction), or use search to find what you need."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"book-open-cover","href":"https://docs.poly.ai/home"},{"anchor":"Community","icon":"slack","href":"https://polyaijupiter-uki8686.slack.com/archives/C075ST5UK7Y"},{"anchor":"Blog","icon":"newspaper","href":"https://poly.ai/resources/?_resource_type=post"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"polyai","hasAudioNarration":false,"actualSubdomain":"polyai","customDomains":["docs.poly.ai"],"gitSource":{"type":"github","owner":"polyai-ldn","repo":"polyai-mintlify-doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc6aca78a5d8b1d6a126a2","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API reference","count":208},{"language":"default","tag":"Agent Studio","count":151},{"language":"default","tag":"Build \u0026 deploy","count":136},{"language":"default","tag":"Agents API","count":119},{"language":"default","tag":"Runtime \u0026 data","count":46},{"language":"default","tag":"ADK","count":41},{"language":"default","tag":"Integrations","count":41},{"language":"default","tag":"Academy","count":30},{"language":"default","tag":"Dialog-RSN-1","count":24},{"language":"default","tag":"Release notes","count":24}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":":root{--studio-lime: #d9ee50;--studio-lime-12: rgba(217, 238, 80, 0.12);--studio-lime-22: rgba(217, 238, 80, 0.22);--studio-lime-35: rgba(217, 238, 80, 0.35);--studio-ink: #161617;--studio-paper: #fcfcfc}footer{position:relative;z-index:10;background:transparent!important;border-top:none!important;box-shadow:none!important;font-size:0.85rem!important}footer a[href=\"/\"] img{height:auto!important;width:auto!important;max-height:24px!important}footer a{color:inherit!important;text-decoration:none!important;text-decoration-thickness:0.08em;text-underline-offset:0.14em;transition:color 140ms ease, text-decoration-color 140ms ease, background 140ms ease, box-shadow 140ms ease, transform 140ms ease}footer a:hover{text-decoration:underline!important;text-decoration-color:var(--studio-lime)!important}footer a:focus-visible{outline:2px solid var(--studio-lime)!important;outline-offset:2px!important;border-radius:8px}footer a[href*=\"facebook\"],footer a[href*=\"linkedin\"],footer a[href*=\"youtube\"],footer a[href*=\"x.com\"],footer a[href*=\"twitter\"],footer a[href*=\"instagram\"]{margin:0 0.25rem!important;display:inline-flex;align-items:center;justify-content:center;padding:0.2rem 0.3rem!important;border-radius:10px}footer a[href*=\"facebook\"]:hover,footer a[href*=\"linkedin\"]:hover,footer a[href*=\"youtube\"]:hover,footer a[href*=\"x.com\"]:hover,footer a[href*=\"twitter\"]:hover,footer a[href*=\"instagram\"]:hover{background:var(--studio-lime-12)!important;box-shadow:inset 0 0 0 1px var(--studio-lime-22);transform:translateY(-1px)}footer a[href*=\"facebook\"] svg,footer a[href*=\"linkedin\"] svg,footer a[href*=\"youtube\"] svg,footer a[href*=\"x.com\"] svg,footer a[href*=\"twitter\"] svg,footer a[href*=\"instagram\"] svg{width:18px!important;height:18px!important;vertical-align:middle!important;transition:filter 140ms ease, transform 140ms ease}footer a[href*=\"facebook\"]:hover svg,footer a[href*=\"linkedin\"]:hover svg,footer a[href*=\"youtube\"]:hover svg,footer a[href*=\"x.com\"]:hover svg,footer a[href*=\"twitter\"]:hover svg,footer a[href*=\"instagram\"]:hover svg{filter:drop-shadow(0 0 6px var(--studio-lime-35));transform:scale(1.03)}footer a[href*=\"facebook\"]:focus-visible,footer a[href*=\"linkedin\"]:focus-visible,footer a[href*=\"youtube\"]:focus-visible,footer a[href*=\"x.com\"]:focus-visible,footer a[href*=\"twitter\"]:focus-visible,footer a[href*=\"instagram\"]:focus-visible{background:var(--studio-lime-12)!important;box-shadow:inset 0 0 0 1px var(--studio-lime-22)}footer a[href=\"/\"]{text-align:left!important}footer a[href=\"/\"]:hover img{filter:drop-shadow(0 0 10px var(--studio-lime-22))}footer a[href=\"/\"]:focus-visible img{filter:drop-shadow(0 0 10px var(--studio-lime-22))}[data-mint-footer-bottom]{padding-top:0!important}footer+div{padding-top:0!important}@media (prefers-reduced-motion: reduce){footer a,footer a svg,footer a img{transition:none!important;transform:none!important}}[data-tag=\"Code\"] [data-testid=\"tag\"],nav [data-testid=\"tag\"]:has-text(\"Code\"){background-color:rgba(99, 102, 241, 0.1)!important;color:#5b5de7!important;border:1px solid rgba(99, 102, 241, 0.2)!important}[data-tag=\"Advanced\"] [data-testid=\"tag\"],nav [data-testid=\"tag\"]:has-text(\"Advanced\"){background-color:rgba(234, 88, 12, 0.09)!important;color:#c2410c!important;border:1px solid rgba(234, 88, 12, 0.2)!important}.audience-callout{display:flex;align-items:flex-start;gap:0.65rem;padding:0.7rem 1rem;border-radius:8px;border-left:4px solid;font-size:0.88rem;line-height:1.55;margin-bottom:1.5rem}.audience-callout--ui{background:rgba(217, 238, 80, 0.08);border-color:var(--studio-lime);color:inherit}.audience-callout--developer{background:rgba(99, 102, 241, 0.07);border-color:#6366f1;color:inherit}.audience-callout--advanced{background:rgba(234, 88, 12, 0.07);border-color:#ea580c;color:inherit}:root{--home-tile-bg: #ffffff;--home-tile-border: rgba(22, 22, 23, 0.09);--home-fg: #161617;--home-muted: #5b6270;--home-eyebrow: #4a7c10;--home-code-bg: #fbfcf6}html.dark{--home-tile-bg: #17181a;--home-tile-border: rgba(255, 255, 255, 0.08);--home-fg: #f4f5ef;--home-muted: #99a0ab;--home-eyebrow: #bcdb4d;--home-code-bg: #101110}.home-eyebrow{display:inline-block;font-size:0.72rem;font-weight:600;letter-spacing:0.08em;text-transform:uppercase;color:var(--home-eyebrow);margin-bottom:0.4rem}.home-hero{position:relative;margin:0.75rem 0 3rem;padding:2.4rem 2.4rem 2.6rem;border-radius:20px;background:linear-gradient(158deg, rgba(217, 238, 80, 0.16), rgba(74, 124, 16, 0.05) 70%);border:1px solid rgba(74, 124, 16, 0.22)}html.dark .home-hero{background:linear-gradient(158deg, rgba(74, 124, 16, 0.28), rgba(217, 238, 80, 0.04) 75%);border-color:rgba(217, 238, 80, 0.18)}.home-hero-title{font-size:2.4rem;line-height:1.08;font-weight:700;letter-spacing:-0.01em;margin:0.5rem 0 0.85rem;color:var(--home-fg);max-width:18ch}.home-hero-sub{font-size:1.1rem;line-height:1.55;color:var(--home-muted);margin:0 0 1.7rem;max-width:62ch}.home-cta-row{display:flex;flex-wrap:wrap;gap:0.6rem}.home-btn{display:inline-flex;align-items:center;gap:0.45rem;padding:0.62rem 1.1rem;border-radius:11px;font-size:0.95rem;font-weight:600;text-decoration:none;transition:transform 150ms ease, box-shadow 150ms ease, border-color 150ms ease}.home-btn-primary{background:#d9ee50;color:#1f3a04;box-shadow:0 8px 22px -10px rgba(74, 124, 16, 0.7)}.home-btn-primary:hover{transform:translateY(-1px)}.home-btn-ghost{background:transparent;color:var(--home-fg);border:1px solid var(--home-tile-border);font-weight:500}.home-btn-ghost:hover{border-color:rgba(74, 124, 16, 0.45)}.home-term{max-width:620px;margin:1.75rem 0 0;border-radius:14px;border:1px solid var(--home-tile-border);background:var(--home-tile-bg);overflow:hidden}.term-head{display:flex;align-items:center;gap:0.4rem;padding:0.7rem 1.1rem;border-bottom:1px solid var(--home-tile-border)}.term-dot{width:10px;height:10px;border-radius:50%;background:var(--home-tile-border)}.term-title{margin-left:0.45rem;font-size:0.82rem;font-weight:600;color:var(--home-fg)}.term-body{padding:1.1rem 1.3rem;background:var(--home-code-bg);font-family:var(--font-mono, ui-monospace, \"SF Mono\", Menlo, monospace);font-size:0.83rem;line-height:1.5;overflow-x:auto}.term-line{display:flex;gap:1rem;padding:0.22rem 0;white-space:nowrap}.term-cmd{flex:none;min-width:6.5rem;color:var(--home-fg)}.term-cmd .term-p{color:#4a7c10;margin-right:0.5rem}html.dark .term-cmd .term-p{color:#bcdb4d}.term-c{color:var(--home-muted)}.term-foot{display:block;padding:0.85rem 1.3rem;border-top:1px solid var(--home-tile-border);font-size:0.85rem;font-weight:600;color:var(--home-eyebrow);text-decoration:none;transition:background 140ms ease}.term-foot:hover{background:rgba(74, 124, 16, 0.06)}html.dark .term-foot:hover{background:rgba(217, 238, 80, 0.08)}html[data-current-path=\"/home\"] .mdx-content{max-width:880px}html[data-current-path=\"/home\"] .home-hero{margin:1rem 0 4rem;padding:2.75rem 2.75rem 3rem}html[data-current-path=\"/home\"] .mdx-content>h2{margin-top:4.5rem;margin-bottom:1.25rem;scroll-margin-top:6rem}html[data-current-path=\"/home\"] .mdx-content>p{margin:0 0 1.4rem;line-height:1.72}html[data-current-path=\"/home\"] .mdx-content>ul{margin:0.25rem 0 1.75rem}html[data-current-path=\"/home\"] .mdx-content>ul>li{margin:0.6rem 0;line-height:1.68}html[data-current-path=\"/home\"] .home-term{margin:2.25rem auto 0.5rem}@media (max-width: 640px){.home-hero{padding:1.8rem 1.5rem 2rem}.home-hero-title{font-size:2rem}.term-line{white-space:normal}html[data-current-path=\"/home\"] .home-hero{padding:1.9rem 1.6rem 2.1rem;margin-bottom:3rem}html[data-current-path=\"/home\"] .mdx-content>h2{margin-top:3.25rem}}@media (prefers-reduced-motion: reduce){.home-btn{transition:none!important;transform:none!important}}#navbar a[href=\"/login\"],#navbar button[data-testid=\"login-button\"],nav a[href=\"/login\"]{display:none!important}.mdx-content table th,.mdx-content table th strong,.prose table th{font-weight:600!important}"}],"page":{"pagePath":"wren/walkthrough","slug":"/wren/walkthrough","pageMetadata":{"title":"A full session, step by step","sidebarTitle":"Walkthrough","description":"One build from first prompt to published Branch, with screenshots from a real session.","keywords":["wren walkthrough","wren example","build an agent with wren","plan and approve","branches"],"href":"/wren/walkthrough"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"One build from first prompt to published Branch, with screenshots from a real session.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`These are the steps you’ll repeat for most build work. The screenshots are from a real session, so what you see here is what you’ll see in Studio.`}),`\n`,_jsxs(_components.p,{children:[`The example below adds a knowledge base topic, but the shape is the same whether you’re writing a flow, wiring an integration, or changing how the agent speaks: `,_jsx(_components.strong,{children:`describe it, answer any questions, approve the plan, review what changed, then publish when you’re happy.`})]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Start from the home screen`,children:[_jsxs(_components.p,{children:[`The chat panel opens with a prompt input. Choose `,_jsx(_components.strong,{children:`See prompt suggestions`}),` for starters grouped by intent: `,_jsx(_components.strong,{children:`Build`}),`, `,_jsx(_components.strong,{children:`Test`}),`, `,_jsx(_components.strong,{children:`Ask`}),`, and `,_jsx(_components.strong,{children:`Analyze`}),`. Pick a suggestion, fill in the blank where there is one, or ignore them and type your own request.`]}),_jsx(Frame,{caption:`Home screen with Build, Test, Ask, and Analyze suggestions`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=89387196b5e4cc0d87279b04977f7dd3`,alt:`Wren home screen with the composer and prompt suggestions grouped into Build, Test, Ask, and Analyze`,style:{maxWidth:`720px`,width:`100%`,margin:`0 auto`,display:`block`},\"data-og-width\":`1232`,width:`1232`,\"data-og-height\":`954`,height:`954`,\"data-path\":`images/wren/home.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?w=280\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=5b50018132db9833585af282ba4ab53d 280w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?w=560\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=99e1f1a27a003237253d7529397ea950 560w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?w=840\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=a1015133c22f49e7c99e8acca9751039 840w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=56cb62633136ff850823a4de19c4edc9 1100w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=eb7f491d38e4356133d97755074383b9 1650w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/home.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=100aa06bcd131d5190f8ca65e0550168 2500w`})}),_jsxs(_components.p,{children:[`The more grounded your request, the fewer questions come back. `,_jsx(_components.em,{children:`“Add a topic for our office opening hours”`}),` works, but `,_jsx(_components.em,{children:`“Add a topic for our office opening hours: 9am to 6pm Monday to Friday, closed weekends and UK public holidays”`}),` gets you there in one turn. See the `,_jsx(_components.a,{href:`/wren/prompting`,children:`prompting guide`}),` for more.`]})]}),_jsxs(Step,{title:`Answer any clarifying questions`,children:[_jsxs(_components.p,{children:[`Rather than guess at business rules it can’t infer, Wren asks. Questions come in a set you step through: pick an option, choose `,_jsx(_components.strong,{children:`Something else`}),` to type your own answer, or `,_jsx(_components.strong,{children:`Skip`}),` to let Wren decide.`]}),_jsx(Frame,{caption:`Step through the questions, or skip to let Wren choose`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=b1fc422b89f1a7d6e00bde2ce258e664`,alt:`Wren asking a clarifying question with numbered options, a Something else option, a Skip button, and a 1 of 3 pager`,style:{maxWidth:`720px`,width:`100%`,margin:`0 auto`,display:`block`},\"data-og-width\":`1568`,width:`1568`,\"data-og-height\":`588`,height:`588`,\"data-path\":`images/wren/clarifying-question.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?w=280\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=49c15fb3101d06813540bf439edfa55f 280w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?w=560\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=1b60604b3b9284c9967db7535bfed215 560w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?w=840\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=9ab5cfc5515ff19f4b9609dc1ceb19f0 840w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=0b81410211e18c01254c4f7b87a01c0a 1100w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=9604709ad68a70109b9ceaa5ea92a531 1650w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/clarifying-question.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=e4d98c59b95cfbaa5d8ad784a076efc7 2500w`})}),_jsx(_components.p,{children:`This is the step that stops Wren inventing your policies. If it doesn’t know your refund window or your opening hours, it asks rather than picking something plausible.`})]}),_jsxs(Step,{title:`Approve or revise the plan`,children:[_jsxs(_components.p,{children:[`Once it has enough context, Wren presents a plan card summarizing what it intends to change, with `,_jsx(_components.strong,{children:`Approve`}),` and `,_jsx(_components.strong,{children:`Revise`}),` buttons. `,_jsx(_components.strong,{children:`Nothing is written until you approve.`}),` Expand the card to read the full breakdown.`]}),_jsx(Frame,{caption:`The plan, with Approve and Revise`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=4ce473080b63765b279ab3f2272b9526`,alt:`Plan card titled Add Callback Request Flow with a summary, a what's changing section, and Revise and Approve buttons`,style:{maxWidth:`720px`,width:`100%`,margin:`0 auto`,display:`block`},\"data-og-width\":`1456`,width:`1456`,\"data-og-height\":`818`,height:`818`,\"data-path\":`images/wren/plan-card.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?w=280\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=91fc1bff696a77db7a26cc5717d15e33 280w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?w=560\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=5f13c0bc67ebe3549bd5dacb144c85bb 560w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?w=840\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=82caf5be184e2a12023534ef148b236f 840w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=2b7e9ffd29d27bae4fcf7a4b1b5655bb 1100w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=6f6535c6ca8e36333530813faae9fa1f 1650w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-card.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=0baa969b8d94ecf4d972007c6fb74e36 2500w`})}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Revise`}),` opens a feedback box. Say what should be different and `,_jsx(_components.strong,{children:`Send`}),` to re-plan, or leave it blank to reject outright.`]}),_jsx(Frame,{caption:`Revise sends feedback and re-plans`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=2e9cf652d48c06848eb5da5142816b6a`,alt:`Plan revision feedback box reading What should be different, with Cancel and Send buttons`,style:{maxWidth:`720px`,width:`100%`,margin:`0 auto`,display:`block`},\"data-og-width\":`1568`,width:`1568`,\"data-og-height\":`346`,height:`346`,\"data-path\":`images/wren/plan-revise.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?w=280\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=cd2182a4c5fff580144ef0e083fa6cde 280w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?w=560\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=47393c57b8a76bd4776053e269e68b0a 560w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?w=840\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=ebffb008c72236f7ef6ea3a346a3ab4d 840w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=4c5fa910bf761fad43b276b2f05c670a 1100w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=98faeeefbc8caa99c8024199c49069d8 1650w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/plan-revise.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=2eea821ea776c69a88f73bedbf74052b 2500w`})}),_jsxs(_components.p,{children:[`For small, unambiguous changes Wren may skip the plan and just do the work. The bigger or more structural the request, the more likely you’ll see a plan first. You can always force one by asking: `,_jsx(_components.em,{children:`“Plan this before making any changes.”`})]})]}),_jsxs(Step,{title:`Watch it work on a Branch`,children:[_jsxs(_components.p,{children:[`The first time Wren makes a change it carries on in an open Branch that already covers the request, or otherwise creates a Branch off Live, named after the request and prefixed `,_jsx(_components.code,{children:`wren/`}),`. Live stays untouched, and the Branch switcher in the top-left shows Wren’s Branch for the rest of the session. Each step it takes is listed as it goes, with a running count of changes made.`]}),_jsx(Frame,{caption:`A Branch is created automatically, and every step is listed as it runs`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=6a62aa91687f7fb53f64253dd38c7115`,alt:`Transcript showing a branch named wren slash add-office-hours-topic being created, followed by four steps and a four changes made summary`,style:{maxWidth:`720px`,width:`100%`,margin:`0 auto`,display:`block`},\"data-og-width\":`1568`,width:`1568`,\"data-og-height\":`622`,height:`622`,\"data-path\":`images/wren/branch-and-changes.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?w=280\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=0a8c94fdfd099e73ad69972a672a0e6d 280w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?w=560\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=70de92ac304c6b76579d026309e5b5e9 560w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?w=840\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=3db4ed3429cb8bb03e16ec346d3fca08 840w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=99716b7c096707a8d2f751d8f8fd06dd 1100w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=171d6eee5fb48018a24cc873380a9dff 1650w, https://mintcdn.com/polyai/2HU5oeXXTczVAKux/images/wren/branch-and-changes.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2HU5oeXXTczVAKux\u0026q=85\u0026s=5086cd5fa5bfb7f330ac155fa7465b6b 2500w`})}),_jsx(_components.p,{children:`Expand the summary to see each step, and open any changed resource to check it by hand. Everything Wren wrote is an ordinary edit on your Branch, so you can adjust or undo it exactly as you would your own work.`})]}),_jsxs(Step,{title:`Publish to Live`,children:[_jsxs(_components.p,{children:[`Publishing is yours to do. Wren never does it for you. Click `,_jsx(_components.strong,{children:`Publish`}),` in the top-right, add a publish message and confirm. Your Branch merges onto Live and becomes the newest version in `,_jsx(_components.a,{href:`/environments-and-versions/introduction#rolling-back-a-change`,children:`Live’s history`}),`. To check the diff first, choose `,_jsx(_components.strong,{children:`Review changes`}),` from the Publish menu. See `,_jsx(_components.a,{href:`/environments-and-versions/diffs`,children:`Compare changes`}),` for how to read it. If Live has changed since Wren created the Branch, the button reads `,_jsx(_components.strong,{children:`Sync`}),` instead. `,_jsx(_components.a,{href:`/environments-and-versions/branches#handling-an-out-of-sync-branch`,children:`Sync first`}),`, then publish.`]}),_jsx(_components.p,{children:`Not ready to publish? Leave the Branch where it is. You can come back to the same chat later, keep iterating, and publish when it’s right.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-to-try-next`,children:`What to try next`}),`\n`,_jsx(_components.p,{children:`Once you’ve been through this loop once, the rest of Wren is variations on it:`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Prompting guide`,icon:`message-pen`,href:`/wren/prompting`,children:_jsx(_components.p,{children:`Phrase requests so you get what you meant, in fewer turns.`})}),_jsx(Card,{title:`What Wren can build`,icon:`hammer`,href:`/wren/building`,children:_jsx(_components.p,{children:`Every building block it can create and change.`})}),_jsx(Card,{title:`Analyze conversations`,icon:`chart-line`,href:`/wren/analyze`,children:_jsx(_components.p,{children:`Ask questions about real calls, no Branch needed.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"A full session, step by step","sidebarTitle":"Walkthrough","description":"One build from first prompt to published Branch, with screenshots from a real session.","keywords":["wren walkthrough","wren example","build an agent with wren","plan and approve","branches"],"href":"/wren/walkthrough"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What to try next","slug":"what-to-try-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"polyai","siteName":"PolyAI Platform","title":"A full session, step by step - PolyAI Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-09T09:22:45.817Z","gitLastModified":"2026-10-09T09:21:10.000Z","originalFileLocation":"wren/walkthrough.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"One build from first prompt to published Branch, with screenshots from a real session.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PolyAI Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"A full session, step by step - PolyAI Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"One build from first prompt to published Branch, with screenshots from a real session.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PolyAI Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.poly.ai/wren/walkthrough\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://polyai.mintlify.site/_mintlify/api/og/v2?division=Wren\u0026amp;title=A+full+session%2C+step+by+step\u0026amp;description=One+build+from+first+prompt+to+published+Branch%2C+with+screenshots+from+a+real+session.\u0026amp;theme=f76f95fb1a1c1406194b1abe\u0026amp;signature=d87cb27e611de126c2cf0504d358540ae31ee37801f0e56820aeb61b33869fc0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"A full session, step by step - PolyAI Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One build from first prompt to published Branch, with screenshots from a real session.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polyai.mintlify.site/_mintlify/api/og/v2?division=Wren\u0026amp;title=A+full+session%2C+step+by+step\u0026amp;description=One+build+from+first+prompt+to+published+Branch%2C+with+screenshots+from+a+real+session.\u0026amp;theme=f76f95fb1a1c1406194b1abe\u0026amp;signature=d87cb27e611de126c2cf0504d358540ae31ee37801f0e56820aeb61b33869fc0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/polyai/JgpL71FS67wXTWm8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PolyAI Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4a7c10\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.poly.ai/wren/walkthrough\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/wren/walkthrough.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://poly.ai/#organization\",\"name\":\"PolyAI\",\"legalName\":\"PolyAI Limited\",\"url\":\"https://poly.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.poly.ai/logo/dark.png\"},\"sameAs\":[\"https://poly.ai\",\"https://github.com/polyai\",\"https://www.linkedin.com/company/polyai/\",\"https://pypi.org/project/polyai-adk/\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.poly.ai#website\",\"name\":\"PolyAI Platform\",\"url\":\"https://docs.poly.ai\",\"publisher\":{\"@id\":\"https://poly.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.poly.ai/wren/walkthrough#webpage\",\"url\":\"https://docs.poly.ai/wren/walkthrough\",\"name\":\"A full session, step by step\",\"description\":\"One build from first prompt to published Branch, with screenshots from a real session.\",\"dateModified\":\"2026-10-09T09:21:10.000Z\",\"isPartOf\":{\"@id\":\"https://docs.poly.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.poly.ai/wren/walkthrough#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.poly.ai/wren/walkthrough#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Wren\",\"item\":\"https://docs.poly.ai/wren/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"A full session, step by step\",\"item\":\"https://docs.poly.ai/wren/walkthrough\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.poly.ai/wren/walkthrough#article\",\"headline\":\"A full session, step by step\",\"name\":\"A full session, step by step\",\"description\":\"One build from first prompt to published Branch, with screenshots from a real session.\",\"url\":\"https://docs.poly.ai/wren/walkthrough\",\"mainEntityOfPage\":{\"@id\":\"https://docs.poly.ai/wren/walkthrough#webpage\"},\"dateModified\":\"2026-10-09T09:21:10.000Z\",\"keywords\":\"wren walkthrough, wren example, build an agent with wren, plan and approve, branches\",\"publisher\":{\"@id\":\"https://poly.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.poly.ai#website\"}}]}\u003c/script>","agentPointerHref":"/wren/walkthrough.md","siteName":"PolyAI Platform","nav":{"global":{"anchors":[{"anchor":"Home","icon":"book-open-cover","href":"https://docs.poly.ai/home"},{"anchor":"Community","icon":"slack","href":"https://polyaijupiter-uki8686.slack.com/archives/C075ST5UK7Y"},{"anchor":"Blog","icon":"newspaper","href":"https://poly.ai/resources/?_resource_type=post"}]},"tabs":[{"tab":"Agent Studio","groups":[{"group":"Get started","pages":[{"title":"PolyAI documentation","sidebarTitle":"Home","mode":"wide","href":"/home"},{"title":"Platform overview","mode":"wide","href":"/platform/introduction"},{"title":"Agent Studio","sidebarTitle":"Agent Studio","mode":"wide","href":"/get-started/introduction"},{"title":"Quickstart","href":"/get-started/quickstart"},{"title":"Meet the new Agent Studio","sidebarTitle":"What's new","href":"/get-started/whats-new"}]},{"group":"Wren","pages":[{"title":"Wren","sidebarTitle":"Overview","description":"Build, test, debug, and analyze your agent in natural language, from anywhere in Dialog Studio.","href":"/wren/introduction"},{"title":"A full session, step by step","sidebarTitle":"Walkthrough","href":"/wren/walkthrough"},{"title":"What Wren can build","sidebarTitle":"Build and edit","description":"Every part of your agent Wren can create and change, and the guardrails around each one.","href":"/wren/building"},{"title":"Analyze conversations","sidebarTitle":"Analyze","href":"/wren/analyze"},{"title":"Automated call review","sidebarTitle":"Automated review","href":"/wren/automated-review"},{"title":"Chats and context","sidebarTitle":"Chats and context","href":"/wren/chats"},{"title":"Prompting guide","sidebarTitle":"Prompting guide","href":"/wren/prompting"},{"group":"Integrations","expanded":true,"pages":[{"title":"Wren API","sidebarTitle":"API","href":"/wren/api"},{"title":"Add Wren to Gemini Enterprise","sidebarTitle":"Gemini Enterprise","href":"/wren/gemini-enterprise"}]},{"title":"Usage and limits","sidebarTitle":"Usage and limits","href":"/wren/usage-and-limits"}]},{"group":"Analytics","pages":[{"title":"Self-serve dashboards","sidebarTitle":"Self-serve dashboards","href":"/analytics/dashboards/introduction"},{"title":"Custom metrics","sidebarTitle":"Custom metrics","href":"/analytics/kpis/introduction"},{"title":"PolyScore","sidebarTitle":"PolyScore","href":"/analytics/polyscore"},{"title":"AI Scores","sidebarTitle":"AI Scores","href":"/analytics/ai-scores"},{"title":"CSAT surveys","href":"/analytics/csat/introduction"},{"title":"Managed dashboards","sidebarTitle":"Managed dashboards","href":"/analytics/dashboards/custom"}]},{"group":"Conversations","pages":[{"title":"Conversations","sidebarTitle":"Overview","mode":"wide","href":"/analytics/conversations/introduction"},{"title":"Review","href":"/analytics/conversations/review"},{"title":"Views","href":"/analytics/conversations/views"},{"title":"Annotations","href":"/analytics/conversations/annotations"},{"title":"Diagnosis","href":"/analytics/conversations/diagnosis"}]},{"group":"Behavior","pages":[{"title":"Behavior","sidebarTitle":"Overview","mode":"wide","href":"/behavior/introduction"},{"group":"General","pages":[{"title":"Agent","sidebarTitle":"Personality and role","href":"/behavior/general/agent"},{"title":"Rules","sidebarTitle":"Behavior","href":"/behavior/general/rules"}]},{"group":"Language","pages":[{"title":"Multi-language","href":"/behavior/language/multilingual"},{"title":"Language coverage","href":"/behavior/language/language-coverage"},{"title":"Translations","href":"/behavior/language/translations"}]},{"group":"Guardrails","pages":[{"title":"Guardrails","sidebarTitle":"Guardrails","href":"/behavior/guardrails/introduction"},{"title":"Safety filters","sidebarTitle":"Safety filters","href":"/behavior/guardrails/safety-filters"}]},{"group":"Models","pages":[{"title":"Model","sidebarTitle":"Overview","href":"/behavior/models/model-use"},{"title":"Raven","href":"/behavior/models/raven"},{"title":"Bring your own model (BYOM)","href":"/behavior/models/byom"}]}]},{"group":"Knowledge","pages":[{"group":"FAQs","pages":[{"title":"FAQs","mode":"wide","href":"/knowledge/faqs/introduction"},{"title":"RAG","href":"/knowledge/faqs/RAG/introduction"},{"group":"Actions","pages":[{"title":"Actions","sidebarTitle":"Overview","href":"/knowledge/faqs/actions/introduction"},{"title":"Send SMS","href":"/knowledge/faqs/actions/send-sms"},{"title":"Invoke tool","tag":"Code","href":"/knowledge/faqs/actions/tool-call"},{"title":"Handoff","href":"/knowledge/faqs/actions/handoff"}]}]},{"group":"Sources","pages":[{"title":"Sources","mode":"wide","href":"/knowledge/sources/introduction"}]},{"group":"Variants","pages":[{"title":"Variants","sidebarTitle":"Overview","tag":"Advanced","href":"/knowledge/variants/introduction"},{"title":"CSV imports","tag":"Advanced","href":"/knowledge/variants/csv-imports"}]}]},{"group":"Flows","pages":[{"title":"Flows","sidebarTitle":"Overview","mode":"wide","href":"/flows/introduction"},{"title":"Triggering flows","sidebarTitle":"Triggering flows","href":"/flows/triggering-flows"},{"title":"Example flow","href":"/flows/example"},{"group":"No code","pages":[{"title":"No-code flows","sidebarTitle":"Overview","mode":"wide","href":"/flows/no-code/introduction"},{"title":"Entities","href":"/flows/no-code/entities"},{"title":"Quickstart","href":"/flows/no-code/quickstart"},{"title":"Advanced steps","href":"/flows/no-code/advanced-steps"}]},{"group":"Code","pages":[{"title":"Transition functions","tag":"Code","href":"/flows/transition-functions"},{"title":"Flow object","sidebarTitle":"Object","tag":"Code","href":"/flows/object"},{"title":"ASR biasing","tag":"Code","href":"/flows/asr-biasing"},{"title":"DTMF","tag":"Code","href":"/flows/dtmf"},{"title":"Few-shot prompting","tag":"Code","href":"/flows/few-shot-prompting"}]}]},{"group":"Tools","pages":[{"title":"Tools","sidebarTitle":"Overview","tag":"Code","mode":"wide","href":"/tools/introduction"},{"title":"Create tool","tag":"Code","href":"/tools/how-to-setup"},{"title":"Using tools","tag":"Code","href":"/tools/using-tools-in-knowledge-base"},{"group":"Functions","pages":[{"title":"Start tool","tag":"Code","href":"/tools/start-tool"},{"title":"End tool","tag":"Code","href":"/tools/end-tool"},{"title":"Variables","tag":"Code","href":"/tools/variables"},{"title":"Return values","tag":"Code","href":"/tools/return-values"},{"title":"Libraries","tag":"Code","href":"/tools/import-library"},{"title":"Delay control","tag":"Code","href":"/tools/delay-control"}]},{"group":"Classes and objects","pages":[{"title":"Tool classes","sidebarTitle":"Classes","tag":"Code","href":"/tools/classes"},{"title":"Conversation","sidebarTitle":"Object","tag":"Code","href":"/tools/classes/conv-object"},{"title":"Conversation utilities","sidebarTitle":"Utilities","tag":"Code","href":"/tools/classes/conv-utils"},{"title":"Conversation API client","sidebarTitle":"API","tag":"Code","href":"/tools/classes/conv-api"},{"title":"Conversation log","sidebarTitle":"Log","tag":"Code","href":"/tools/classes/conv-log"},{"title":"ASR biasing from functions","sidebarTitle":"ASR biasing","tag":"Code","href":"/tools/classes/asr-from-conv"},{"title":"Disable knowledge topics from functions","sidebarTitle":"Disable KB topics","tag":"Code","href":"/tools/classes/disable-kb-topics"},{"title":"History","tag":"Code","href":"/tools/classes/history"},{"title":"Voice","tag":"Code","href":"/tools/classes/voice"},{"title":"Agent memory","tag":"Code","href":"/tools/classes/agent-memory"}]}]},{"group":"Extend with code","icon":"code","pages":[{"title":"Extend with code","sidebarTitle":"Overview","mode":"wide","tag":"Code","href":"/extend/introduction"},{"title":"Agent Development Kit (ADK)","sidebarTitle":"ADK","tag":"Code","mode":"wide","href":"/extend/adk"}]},{"group":"Testing","pages":[{"title":"Testing","sidebarTitle":"Overview","href":"/testing/introduction"},{"title":"Simulation tests","sidebarTitle":"Simulation tests","href":"/testing/simulation-tests"},{"title":"Run and review","sidebarTitle":"Run and review","href":"/testing/run-and-review"},{"title":"Experiments","sidebarTitle":"Experiments","href":"/testing/experiments"},{"title":"Automate with API","sidebarTitle":"Automate with API","href":"/testing/ci-automation"}]},{"group":"Real-time config","pages":[{"title":"Real-time config","sidebarTitle":"Overview","tag":"Code","href":"/real-time-config/introduction"}]},{"group":"Voice","pages":[{"title":"Voice","sidebarTitle":"Overview","mode":"wide","href":"/voice-channel/introduction"},{"title":"Voice settings","sidebarTitle":"Settings","href":"/voice-channel/agent"},{"title":"Message templates","sidebarTitle":"Message templates","href":"/voice-channel/message-templates"},{"title":"Number availability \u0026 compliance","sidebarTitle":"Number availability","href":"/voice-channel/number-availability"},{"title":"Audio library","sidebarTitle":"Audio library","href":"/voice-channel/audio-library"},{"group":"Voice design","pages":[{"title":"Voice library","href":"/voice-channel/voice-library"},{"title":"Choosing a good voice","href":"/voice-channel/choosing-a-good-voice"},{"title":"Use more than one voice","sidebarTitle":"Multi-voice","href":"/voice-channel/multi-voice"},{"title":"Add a voice","tag":"Code","href":"/voice-channel/add-a-new-voice"},{"title":"Custom voice","href":"/voice-channel/custom-voice-request"}]},{"title":"Advanced voice settings","sidebarTitle":"Advanced settings","href":"/voice-channel/advanced/call-settings"}]},{"group":"Messaging","pages":[{"group":"Web Chat","pages":[{"title":"Web Chat","sidebarTitle":"Overview","mode":"wide","href":"/messaging-channel/web-chat/overview"},{"title":"Messaging Agent Configuration","sidebarTitle":"Messaging Agent Configuration","href":"/messaging-channel/web-chat/chat-configuration"},{"title":"Agent Attachments in Web Chat","sidebarTitle":"Agent Attachments","href":"/messaging-channel/web-chat/agent-attachments"},{"title":"Disclaimers and privacy policies","sidebarTitle":"Disclaimers \u0026 privacy policies","href":"/messaging-channel/web-chat/disclaimers-and-privacy-policies"},{"title":"Web chat localisation","sidebarTitle":"Localisation","href":"/messaging-channel/web-chat/localisation"},{"title":"Verified Context Injection","sidebarTitle":"Verified Context Injection","href":"/messaging-channel/web-chat/verified-context-injection"}]},{"title":"Multichannel agents","mode":"wide","href":"/messaging-channel/multichannel"},{"group":"Email","pages":[{"title":"Email","sidebarTitle":"Overview","href":"/messaging-channel/email/email"},{"title":"Configuring a mailbox","sidebarTitle":"Mailbox Configuration","href":"/messaging-channel/email/configuring-a-mailbox"},{"title":"Email handoff","sidebarTitle":"Handoff","href":"/messaging-channel/email/handoff"}]},{"group":"SMS and RCS","pages":[{"title":"SMS","sidebarTitle":"SMS","mode":"wide","href":"/messaging-channel/sms-and-rcs/sms"},{"title":"RCS","sidebarTitle":"RCS","mode":"wide","href":"/messaging-channel/sms-and-rcs/rcs"},{"title":"SMS \u0026 RCS Registration","sidebarTitle":"SMS \u0026 RCS Registration","mode":"wide","href":"/messaging-channel/sms-and-rcs/sms-and-rcs-campaign-registration-compliance-requirements-us"},{"group":"Advanced SMS","pages":[{"title":"SMS Agent Configuration","sidebarTitle":"SMS Agent Configuration","href":"/messaging-channel/sms-and-rcs/advanced/sms-agent-configuration"}]}]},{"group":"Native Mobile SDKs","pages":[{"title":"iOS SDK","sidebarTitle":"iOS SDK","mode":"wide","href":"/messaging-channel/ios-sdk"},{"title":"Voice calling (iOS SDK)","sidebarTitle":"Voice calling (iOS SDK)","mode":"wide","href":"/messaging-channel/ios-sdk-voice"},{"title":"Android SDK","sidebarTitle":"Android SDK","mode":"wide","href":"/messaging-channel/android-sdk"},{"title":"Voice calling (Android SDK)","sidebarTitle":"Voice calling (Android SDK)","mode":"wide","href":"/messaging-channel/android-sdk-voice"}]}]},{"group":"Integrations","pages":[{"title":"Integrations","sidebarTitle":"Overview","mode":"wide","href":"/integrations/introduction"},{"title":"API integrations","sidebarTitle":"Overview","tag":"Code","href":"/integrations/api/introduction"},{"group":"Chat handoffs","pages":[{"title":"Chat handoff integrations","sidebarTitle":"Overview","href":"/integrations/chat/introduction"},{"title":"Salesforce chat handoff","sidebarTitle":"Salesforce","href":"/integrations/chat/salesforce"},{"title":"Zendesk chat handoff","sidebarTitle":"Zendesk","href":"/integrations/chat/zendesk"},{"title":"NICE CXone chat handoff","sidebarTitle":"NICE CXone","href":"/integrations/chat/nice-cxone"},{"title":"Amazon Connect chat handoff","sidebarTitle":"Amazon Connect","href":"/integrations/chat/amazon-connect"},{"title":"Webex by Cisco chat handoff","sidebarTitle":"Webex by Cisco","href":"/integrations/chat/webex"},{"title":"Genesys Cloud","sidebarTitle":"Genesys Cloud","href":"/integrations/messaging/genesys"},{"title":"Five9 chat handoff","sidebarTitle":"Five9","href":"/integrations/chat/five9"}]}]},{"group":"Deployments","pages":[{"title":"Deployments","sidebarTitle":"Overview","mode":"wide","href":"/environments-and-versions/introduction"},{"title":"Environments","sidebarTitle":"Environments","href":"/environments-and-versions/environments"},{"title":"Branches","sidebarTitle":"Branches","href":"/environments-and-versions/branches"},{"title":"Sub-branches","sidebarTitle":"Sub-branches","href":"/environments-and-versions/sub-branches"},{"title":"Compare changes","sidebarTitle":"Compare changes","tag":"Advanced","href":"/environments-and-versions/diffs"}]},{"group":"Widgets","pages":[{"title":"Widgets","sidebarTitle":"Overview","href":"/widgets/introduction"},{"title":"Web Calling","sidebarTitle":"Web Calling","href":"/widgets/web-calling"},{"title":"Configure widget","sidebarTitle":"Configure widget","href":"/widgets/configure"},{"title":"Install on your site","sidebarTitle":"Install on your site","href":"/widgets/install"},{"title":"Test your widget","sidebarTitle":"Test your widget","href":"/widgets/test"},{"title":"Share your agent","sidebarTitle":"Share your agent","href":"/widgets/share"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/widgets/troubleshooting"}]},{"group":"Account","pages":[{"title":"Account","sidebarTitle":"Account","mode":"wide","href":"/settings/introduction"},{"group":"User management","pages":[{"title":"User management","sidebarTitle":"Overview","href":"/user-management/introduction"},{"title":"Role permissions","href":"/user-management/access-control-scope"},{"title":"How to add users","href":"/user-management/invite-users"},{"title":"How to manage users","sidebarTitle":"Manage users","href":"/user-management/manage-users"}]},{"group":"Secrets","pages":[{"title":"Overview","tag":"Code","mode":"wide","href":"/secrets/introduction"},{"title":"How to create a secret","tag":"Code","href":"/secrets/how-to-setup"},{"title":"Access control","tag":"Code","href":"/secrets/how-to-access-control"},{"title":"API keys","sidebarTitle":"API keys","href":"/secrets/api-keys"}]},{"group":"Call data","pages":[{"title":"Recordings and transcripts","href":"/call-data/introduction"},{"title":"Studio transcripts","href":"/call-data/studio-transcripts"},{"group":"API and export","pages":[{"title":"Handoff States","tag":"Code","href":"/call-data/conversations-api/handoff-states"},{"title":"List conversations","tag":"Code","href":"/call-data/conversations-api/list-conversations"},{"title":"AWS S3 integration","tag":"Code","href":"/call-data/s3-to-s3"}]}]},{"group":"Legal","pages":[{"title":"Compliance","href":"/legal/compliance"},{"title":"Training data","href":"/legal/training-data"}]}]}]},{"tab":"Dialog-RSN-1","pages":[{"title":"Dialog-RSN-1","href":"/dialog-rsn-1/overview"}]},{"tab":"Academy","pages":[{"title":"Academy","href":"/learn/guides/polyacademy"}]},{"tab":"ADK","pages":[{"title":"ADK","href":"/adk"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"Release notes","pages":[{"title":"Release notes","href":"/releases/overview"}]}]},"basePath":"","title":"A full session, step by step - PolyAI Platform","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["10e4515597","07c022d89b","a74be98ba7"],"chunks":["BannerMarkdown-5hDu1xuu.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","Frame-DBAS9Liu.js","DynamicMarkdown-C4w9kavL.js","zoom-image-lightbox-B9O1U98p.js","lightbox-handle-r17bVUz3.js"]}