> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sundaypyjamas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run & Share an Agent

> Give the Core Agent a task, watch the steps it takes, and share a session with others.

## Running a task

Using the agent is easy — you chat with it like anything else, but you can hand it bigger jobs.

<Steps>
  <Step title="Open the Agents tab">
    Click **Agents** in the left menu and start a new chat (the **+** button).
  </Step>

  <Step title="Give it a task">
    Type your request in plain words. Be clear about the outcome you want.

    > *Look up this month's top 5 products and write a one-page summary I can download.*

    <Frame caption="Giving the agent a task in a new session.">
      <img src="https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-run-chat.png?fit=max&auto=format&n=s9bw5Uhxs58-xnp0&q=85&s=84876c4477a4a845915dfd9ee179c389" alt="A chat with the agent, giving it a task" width="1440" height="900" data-path="images/user-guide/agents-run-chat.png" />
    </Frame>
  </Step>

  <Step title="Watch it work">
    The agent shows the **steps** it takes — like *searching* or *reading a file*. This is normal and helps you trust the result.

    <Frame caption="The agent showing the steps it took to finish your task.">
      <img src="https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-run-steps.png?fit=max&auto=format&n=s9bw5Uhxs58-xnp0&q=85&s=dbc4b512f564003aa5ade48b0071494e" alt="An agent run showing a list of steps it performed" width="1440" height="900" data-path="images/user-guide/agents-run-steps.png" />
    </Frame>
  </Step>

  <Step title="Collect the result">
    If it created a file, it opens in the preview panel on the right — read it, copy it, or download it. See [What the Core Agent can do](/user-guide/agents/capabilities).
  </Step>
</Steps>

## Looking back at a session

Every task lives in a saved **session** in the list on the left. Reopen any session to re-read what the agent did, continue the conversation, or grab a file it made earlier.

<Tip>
  If an agent gives a surprising result, reopen the session and read its steps. You'll usually see exactly where it went off track — often a missing instruction or the wrong tool. Fix it in [the settings](/user-guide/agents/configure) and try again.
</Tip>

## Sharing a session

Made something useful? Share the whole conversation with a link.

<Steps>
  <Step title="Find the Share option">
    Hover the session in the list (or use the session menu) and choose **Share**.

    <Frame caption="Sharing an agent session creates a link others can open.">
      <img src="https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-share.png?fit=max&auto=format&n=s9bw5Uhxs58-xnp0&q=85&s=0d999e1f449ab7926edd619aacdb1a9f" alt="The share panel for an agent session with a copyable link" width="1440" height="900" data-path="images/user-guide/agents-share.png" />
    </Frame>
  </Step>

  <Step title="Copy and send the link">
    Click **Copy**, then paste the link into an email or message.
  </Step>
</Steps>

<Warning>
  Anyone with the link can see the shared session, including any files it produced. Only share with people you trust, and turn the link off from the same panel if you change your mind. If the agent used private documents or connected tools, make sure you're comfortable sharing what's in the conversation.
</Warning>

## Where to go next

<CardGroup cols={2}>
  <Card title="Build your own agent" icon="hammer" href="/user-guide/assistants">
    Ready for a custom helper? Build an Assistant.
  </Card>

  <Card title="Real-world scenarios" icon="lightbulb" href="/user-guide/scenarios">
    See complete examples for different kinds of work.
  </Card>
</CardGroup>