Sharing an agent

Generate a public link so anyone with the URL can talk to your agent.

A share link is a public URL that lets anyone with the link interact with an agent, without needing a Nairi account. Use it for demos, internal tools, customer-facing assistants, or a "try our bot" link on a blog post.

How it works at a glance

  • Every share link points at one agent.
  • Visitors get a chat UI. They can send prompts and the agent responds, exactly as if it were running in Slack or the API.
  • Each visitor's browser is isolated: a session ID stored in localStorage keyed by the share code. Two visitors on the same link see separate conversations.
  • Links can have an expiration. After the expiry, the URL returns a "link has expired" page.
  • Anyone with the URL can use the link. There is no password or email gate today.

The agent runs with its full toolset on every share request. If the agent has access to a Linear MCP, a Stripe vault, or a code repo, a visitor on the share link can ask it to use all of those. Don't share an agent that has permissions you wouldn't grant to the audience you're sending the URL to.

  1. Open Fleet and click the agent.
  2. Switch to the Sharing tab.
  3. Click + Create Share Link.
  4. Pick an Expires In value:
    • 1 day
    • 7 days (default)
    • 30 days
    • 90 days
    • Never
  5. Click Create Link.

The new link appears in the list. Click the URL badge to copy it.

Sharing the URL

The URL looks like https://app.nairi.ai/s/<code>. Paste it anywhere.

  • Send it to a teammate over Slack or email.
  • Drop it on an internal wiki page.
  • Put it in a customer-facing onboarding flow.

The recipient opens the link in a browser. No login, no setup. They see the chat UI, ask the agent something, and the agent responds. The same agent that's in your Fleet, with the same rules, MCPs, skills, and vault access.

What visitors see

  • The agent's name and description.
  • A chat composer.
  • Their own conversation history (stored in their browser only).
  • The agent's full response, including any tool calls, the way you'd see them on the Tasks page.

What they don't see:

  • Any other agent in your org.
  • The agent's configuration (rules, MCPs, skills, env vars, secrets).
  • Past conversations from other visitors.

Tracking usage

All jobs created via a share link show up under Tasks with the job type "app" (as opposed to "slack", "discord", or "api"). You can scroll through them and see exactly what visitors are asking.

There is no per-link visit counter or last-access timestamp today. If you need that, contact support@nairi.ai.

Expirations

ValueBehaviour
1 dayLink is valid for 24 hours from creation.
7 daysValid for 168 hours. Default.
30 daysValid for one month.
90 daysValid for three months.
NeverNo expiration. Link stays live until you delete it.

After expiry, the URL returns: "This share link is invalid or has expired."

You can't extend an existing link's expiration. Create a new one with a longer expiry and delete the old one.

On the Sharing tab, hover the link's row and click the trash icon on the right. The link is deleted immediately. The next visitor sees the expired-link page.

There's no undo. If you regret deleting a link, create a new one. The URL will be different, so old copies of the URL stay dead.

You can create as many share links as you want on the same agent. Some patterns:

  • One short-lived link for a customer demo.
  • One long-lived link for an internal tool.
  • One "never expires" link for documentation, plus a "30 days" link for a one-off feedback session.

Each link is independent. Revoking one doesn't affect the others. All visitors on all links hit the same underlying agent.

What's not supported today

  • Password or email gates. Anyone with the URL gets in. Treat the URL itself as the credential.
  • Per-link rate limits. The agent's own queue is the only limit (one job at a time per agent).
  • Embedding via iframe. Some browsers will block the page in an iframe for security reasons. Linking out is the supported pattern.
  • Read-only / transcript-only links. Every share link is interactive.

If any of these blockers matter for your use case, let us know at support@nairi.ai.


Can't find what you're looking for? Email support@nairi.ai.

On this page