Skip to main content
Users can connect their own accounts, such as Linear or Google, so an agent can act on their behalf with their access. Embedded connection setup shows Tilde’s setup page in your app. Tilde hosts the provider’s form and OAuth redirects, so credentials never pass through your application. A connection belongs to the user who made it. The agent sees its tools only in that user’s conversations, and only for providers the agent may use personally (the Use personal tools capability on the agent’s Capabilities tab, with the provider selected).

Server

Mount @trytilde/embed-server with the agent listed, as for chat. The handler serves: With more than one agent, add agent to the body or ?agent=<id> to the URL. Your server can do the same directly, for example to send a setup link by email:

Browser

Pass "popup" instead of an element to open the page in a popup window. Call it from a click handler so the browser allows it. In React:
onComplete fires when the user finishes and the connection is ready. Statuses are requires_action (setup not finished), ready, and failed. Use reconnect(id) for a failed connection and remove(id) to disconnect one.