When a view appears
When Tilt Agent uses a tool from a connected app and the app sends a view with the result, the chat shows a card labelled Connected app with the view inside. You don’t need to ask for it. A tool call that fails shows no card.
Tilt Agent can also use connected apps in a background job, but a job shows no views.
What the app draws and what Tilt draws
Everything inside the frame is the app’s own page. The app decides what the page shows and what its buttons do. Tilt draws everything around the frame, so those parts always come from Tilt, whatever the app puts in its page.
A diagram of a connected app's card, using a made-up app. Only the dashed area comes from the app.
Use this view
A view shows the result it came with as soon as it loads. Until you select Use this view, Tilt refuses the view’s requests to use its app’s tools or read its app’s data. Tilt makes those requests with your connection to the app, so a button that depends on them, such as one that saves a change, doesn’t work yet. Use this view covers only what the view asks Tilt to do. As soon as it loads, the view can also contact the outside sites its app lists, which Details shows. Those requests don’t carry your connection to the app. Tilt asks because it saves each view with the chat and draws it again every time the chat opens. Without this step, a saved view could use your connection to the app each time you reopened the chat, without you doing anything. Your choice covers the view as it is drawn now. When Tilt draws the view again, it asks again. That happens after you reload the page, reopen the chat, or select Reload view or Try again on the card. After you select Use this view, the view can use its app’s tools for you. Each action that can change something in the app adds a line under the view, such as “You ran Save chart note from Sample Charts’ view at 10:58 AM”. Tilt records the line before the action reaches the app, so the line shows that the view ran the action, even if the action then failed. The lines stay with the chat. Actions the app marks as read-only, such as showing the latest value, add no line.How Tilt keeps a view apart
- The view runs in a sandboxed frame on tiltmcpcontent.com, a separate domain that Tilt uses only for app views. Each app’s views get their own address there, apart from every other app’s. Because the view never runs on a Tilt domain, it can’t read your Tilt cookies or sign-in, and it can’t reach Tilt’s servers.
- From your chat, the view gets only the request Tilt Agent sent to the app’s tool and the result that came back, plus display settings such as light or dark mode, language, and time zone.
- The view can reach only the outside sites its app lists, and it can reach them as soon as it loads. Details shows them.
- The view can use only its own app’s tools, never another app’s. An app can also keep some of its tools away from its view. Tilt makes each call with your connection, so the view never sees your sign-in to the app.
- The view can’t open new windows or pop-ups, download files, or send the Tilt page somewhere else.
- When you disconnect the app, its views stop loading and can’t act.
What Tilt Agent sees
Tilt Agent reads the text and data the app returns with the result. It doesn’t see the view itself, so it can tell you the numbers behind a chart but not what the chart looks like. Pictures the app sends are left out of what Tilt Agent reads. Tilt Agent also doesn’t see what you do inside a view. To ask about something you found there, tell Tilt Agent in the chat.Not supported yet
- A view sending a message into the chat.
- A view opening a link.
- A view downloading a file.
- A view switching to full screen. Views stay in their card.
- Views built only for ChatGPT’s older Apps SDK format. For those apps, Tilt shows no view, and Tilt Agent answers from the app’s text and data.