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

# First agent in chat

> Create or pick an agent and run your first conversation in the Flowra dashboard.

Use chat when you want to build and test without writing API calls.

## Prerequisites

* A Flowra account at [flowra.dev](https://flowra.dev)
* At least one **project** selected in the sidebar switcher
* The **End user** switcher on **Default user** (or the person you are testing as) — see [External users switcher](/product/external-users)

## Steps

<Steps>
  <Step title="Open Chat">
    Go to [Chat](https://flowra.dev/dashboard/chat). The page title is **Chat**. Threads from past conversations appear in the sidebar (for the selected end user).
  </Step>

  <Step title="Pick or create an agent">
    Use the **agent selector** dropdown to choose which workflow/agent answers. To create one, open [Workflows & Agents](https://flowra.dev/dashboard/workflows), click **Create**, set a name and instructions, attach tools if needed, then save. You can also ask the in-product assistant to help build a workflow, then review and save the result in the editor.
  </Step>

  <Step title="Connect accounts if tools need login">
    Confirm the End user switcher matches who should own the OAuth link. Open [Connection](https://flowra.dev/dashboard/connection), connect the toolkit, and complete OAuth. Then set the default connection on the workflow if the UI asks for it.
  </Step>

  <Step title="Send a message">
    In Chat, select your agent and send a clear task (for example: “Summarize my unread emails and draft a reply”). Watch tool activity in the transcript. If browser automation runs, a live browser panel may appear beside the chat.
  </Step>

  <Step title="Optional: add other entry points">
    To wake the same agent from Telegram, Slack, a schedule, or a site widget, configure **Entry points** on the workflow. See [Entry points and channels](/product/entry-points-and-channels).
  </Step>

  <Step title="Inspect the run if something fails">
    Open [Executions](https://flowra.dev/dashboard/workflows/executions) for step-level history, or [Tool execution logs](https://flowra.dev/dashboard/tool-execution-logs) for individual tool failures. Re-check Connection and the End user switcher if you see auth errors.
  </Step>
</Steps>

## Tips

* Confirm the correct **project** and **end user** before you debug “missing” workflows or knowledge.
* Prefer a small tool set on the first agent; add more after a successful test.
* For customer-facing chat on your website, use a [widget](/product/widgets-and-embeds) bound to a hardened workflow.

## Next steps

* [External users switcher](/product/external-users)
* [Entry points and channels](/product/entry-points-and-channels)
* [Workflows in the dashboard](/product/workflows-in-dashboard)
* [Connections](/product/connections)
* [API quickstart](/quickstart) — when you are ready to call Flowra from code