Docs / Integrations

Connect apps from chat

Your Sutando reaches the apps you already use (calendars, email, Linear, Slack, Notion, GitHub and 1,400+ more) through Composio. You don't have to set anything up first. Ask for what you want, and if the app isn't connected yet, your agent asks you to connect it right there in the chat and then finishes the job.

How it works

  1. Ask your agent. Name the app or the thing you want from it, in a DM with your Sutando: "What's on my calendar today?", "Show me my Linear issues", "Post this in #eng on Slack".
  2. Connect when asked. If the app isn't connected, your agent says so and posts a Connect card. Click Connect and sign in to the app in your browser. When you see "connected, you can close this tab", go back to AG2 Space.
  3. It carries on by itself. The card switches to Connected and your agent answers the request you already made. You don't need to ask again, and nothing restarts.

If the app was already connected, step 2 is skipped and you just get the answer.

A DM thread: the owner asks for Connect cards for Slack and Gmail, and the agent replies that both are already connected, naming the account for each, with a Manage your connected apps card above the composer
Gmail and Slack are already connected, so there is no card: your agent checks them and says which account each one uses.
A DM with a Sutando agent: the owner asks for their Notion pages and the agent replies in a thread with a Notion Connect card
Notion isn't connected yet, so the agent posts a Connect card in the thread.

The Connect card

The card shows the app's logo and name, a Connect button, and who asked for it. The sign-in link is created the moment you click, so an old card never holds a link that someone else could use.

Typed "done" before the answer arrived? That's fine. Your agent notices the request is already being answered and replies once, not twice.

Several apps at once

When a request needs more than one app ("find my latest YouTube videos and post them in Slack"), you get one card with a row per app. Connect them in any order. Each row turns Connected on its own, and your agent answers once they are all connected.

One Connect card with two rows, Linear and Asana, each with its own Connect button
One card covers every app the request needs.

Who can connect

  • Only you can connect your apps. The Connect button works only for the person the card is addressed to, and only when the card comes from their own agent. Anyone else in the room sees a read-only card.
  • Connecting stays between you and your agent. Ask from a room with other people and the Connect card, plus anything your agent says about connecting, shows under your message, only visible to you. Nobody else in the room sees it; they only see your agent's reply once the job is done.
  • Your private data stays in your DM. Mail, calendar events, files and messages go to your DM with your agent, with a one-line note in the room, instead of in front of everyone.
  • The right account, every time. Your agent checks that the same AG2 Cloud account is still signed in before it reads anything. If a different account is signed in by then, it tells you and shares nothing.

The private card shows in the AG2 Space desktop app on the Mac that runs your Sutando. On the web or your phone, ask in your DM with your agent instead: the Connect card appears there.

See, switch or disconnect apps

Click the plug icon in your user card at the bottom left (or click your name and open Settings → Apps → Integrations). Connected apps lists every app your agent can use, with the account each one is signed in as and when you connected it; Show all … connected expands the list. Below it, All apps is the full directory: search, or filter by category (Communication, Scheduling, CRM, Marketing…), and click Connect.

Settings, Apps, Integrations: connected apps with Add account and Disconnect, and the All apps directory below
The plug icon → Integrations: what is connected, and every app you can add.
The connected apps list expanded, each with Add account and Disconnect
Show all connected — every app, with its account and connection date.
  • Add account connects a second account of the same app, for example a work and a personal Gmail. Your agent can then use both; tell it which one when it matters ("check my personal Gmail").
  • Switch account (on an app's page in the Marketplace) signs the app in with a different account. Your agent keeps using the old account until the new sign-in finishes, so nothing breaks if you stop halfway.
  • Disconnect removes the app after you confirm. Your agent can't use it until you connect it again.
  • Needs reconnect means the app's sign-in expired or was revoked. Click Reconnect and sign in again.

You can also just ask your agent: "switch my Linear account" sends a Switch account card (only visible to you in a room with other people), and your agent carries on with the new account once you've signed in. "Which apps am I connected to?" gets you the list. Your agent never disconnects an app for you; that's always your click in Settings → Apps → Integrations.

Add a second account (two Gmails)

Click Add account on the app. Your browser opens the app's own sign-in; for Gmail that is Google's Choose an account. Pick Use another account and sign in with the second address. When it finishes, the app shows both accounts.

Google's Choose an account page, with the signed-in account and Use another account
Add account opens Google's sign-in: pick Use another account for the second Gmail.

Signed in with the same account again? The app's sign-in page reused the account your browser is already logged into. Sign out of that app in your browser (or pick a different account on its sign-in page), then click Switch account again.

Connect ahead of time

Prefer to set things up before you need them? Use All apps in Integrations (above), or open Settings → Apps → Marketplace and pick the Connectors tab: every app your agent can connect to, filterable by category. Connectors need AG2 Cloud connected; the Marketplace shows Connected and your credit balance at the top right when it is. Browse every app you can connect at start.s.space/integrations.

Settings, Apps, Marketplace with the Connectors tab: Gmail, GitHub, Google Calendar and Notion connector cards
Marketplace → Connectors.

Click a connector to open its page. A connected app shows the account it is Signed in as, with Switch account; if the sign-in reuses the same account, sign out of the app in your browser first, as the page says.

The Gmail connector page: signed in as an account, Switch account, Free
A connector's page: who it is signed in as, and Switch account.

Apps that are not in the list yet

The catalog covers 1,400+ apps, but not every site you use is an app with an API. Travel and rental sites are the usual gaps: Expedia, Booking.com, Trip.com, Zillow and their peers have no connector today.

Two things still work without one:

  • Your agent can use the site the way you would. Ask in plain words ("find me two-bedroom apartments in Austin under $2,500 on Zillow", "what does a Booking.com room at the Marriott in Lisbon cost next weekend") and it opens the site in its own browser, reads the listings, fills in search forms and reports back with links. It cannot sign in as you or pay for anything, and if a site blocks automation it tells you so instead of retrying quietly.
  • Request the app. In Settings → Apps → Integrations, search for the app; when it is not in the catalog you get a Request button. The request is recorded on your account, the app shows as Requested, and we use the count to decide what to add next. You can also just tell your agent "request an integration for Zillow".

If something looks off

The card says Sign in to AG2 Cloud

Sign in to AG2 Cloud first (the account control at the top right of Settings → Apps → Marketplace), then click the card again.

The card says Tap Connect again

The sign-in didn't finish, for example the tab was closed early. Click Connect again. If sign-in takes longer than 30 minutes, your agent tells you it stopped waiting: connect the app, then tell your agent.
The agent's follow-up in the thread: Notion still isn't connected, so it stopped waiting
After 30 minutes without a sign-in, your agent says it stopped waiting.

The card says your AG2 Cloud session belongs to a different account

AG2 Space is signed in to AG2 Cloud with a different account from the one this card is for. Sign in with the right account, then click Connect.

The card says Not available yet

That app is listed but can't be connected from AG2 Space yet. Click Request on it in Settings → Apps → Integrations, or tell us at support@ag2.space. Until then your agent can still use the site in its own browser; see Apps that are not in the list yet.
Still stuck? See Troubleshooting, or ask in the community support room.