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

# Build your first flow!

> Plan, build, test, and deploy a flow by chatting with Kadabra's Agent

# Build with Kadabra Agent

The fastest way to build is to **chat with the Agent**. It will understand your goal, check prerequisites, propose a plan, and place nodes on the Canvas.

## Example: Reddit Sentiment Brand Monitor

<Steps>
  <Step title="Start With The Prompt">
    Describe your outcome or the workflow. The Agent clarifies goals and highlights prerequisites like a spreadsheet, a form, or a credential. in this example we used that prompt:

    > Run this workflow daily:
    >
    > 1. Search Reddit for posts from the last 24 hours that mention our brand.
    > 2. Retrieve each post's full text.
    > 3. Ask AI Assistant to score sentiment on a -5 to +5 scale and tag main themes.
    > 4. If the average sentiment for the day is -2 or lower, send an alert to #brand-alerts on Slack.
  </Step>

  <Step title="Flow Plan Approval ">
    The Agent plans the flow including nodes how to connects them and configure the parameters, which trigger is appropriate. The user should review, refine or approve the plan.

    <img src="https://mintcdn.com/kadabra/0GjnGvB-0N0iakZB/images/Screenshot2025-10-16at6.46.15.png?fit=max&auto=format&n=0GjnGvB-0N0iakZB&q=85&s=979c96ee8bc98cdcf66819726433c891" alt="Screenshot2025 10 16at6 46 15 Pn" title="Screenshot2025 10 16at6 46 15 Pn" style={{ width:"40%" }} width="1056" height="1186" data-path="images/Screenshot2025-10-16at6.46.15.png" />
  </Step>

  <Step title="Building & Testing">
    The Agent builds the flow including configuration of the node parameters, than it runs a small sample, usually the first few items or iterstions, and validates results end to end

    <Tip>
      If the agent detects missing information (such as credentials or parameters not provided by the user), it pauses and asks for the missing details or instructions. For example, in our case: **the brand name and Slack channel name.**

      <img src="https://mintcdn.com/kadabra/0GjnGvB-0N0iakZB/images/Screenshot2025-10-16at6.48.02.png?fit=max&auto=format&n=0GjnGvB-0N0iakZB&q=85&s=dc16966c4d8c418e3262600a5598433b" alt="Screenshot2025 10 16at6 48 02 Pn" title="Screenshot2025 10 16at6 48 02 Pn" style={{ width:"96%" }} width="2626" height="658" data-path="images/Screenshot2025-10-16at6.48.02.png" />
    </Tip>

    <Tip>
      The Agent will not execute any "risky" actions without first showing them to the user and receiving their approval:

      <img src="https://mintcdn.com/kadabra/0GjnGvB-0N0iakZB/images/Screenshot2025-10-16at6.52.29.png?fit=max&auto=format&n=0GjnGvB-0N0iakZB&q=85&s=6333e9e0de7460d6b6f21f705b63349f" alt="Screenshot2025 10 16at6 52 29 Pn" title="Screenshot2025 10 16at6 52 29 Pn" style={{ width:"94%" }} width="1052" height="374" data-path="images/Screenshot2025-10-16at6.52.29.png" />
    </Tip>

    <img src="https://mintcdn.com/kadabra/0GjnGvB-0N0iakZB/images/Screenshot2025-10-16at6.55.19.png?fit=max&auto=format&n=0GjnGvB-0N0iakZB&q=85&s=bed3863e9a4a2c425d95ec3546e3b2d4" alt="Screenshot2025 10 16at6 55 19 Pn" width="2628" height="1710" data-path="images/Screenshot2025-10-16at6.55.19.png" />
  </Step>

  <Step title="Deploying">
    The agent run a test once, then **Publish** to activate the trigger and make it production ready.

    <Frame>
      <img src="https://mintcdn.com/kadabra/0GjnGvB-0N0iakZB/images/Screenshot2025-10-16at6.58.31.png?fit=max&auto=format&n=0GjnGvB-0N0iakZB&q=85&s=edc574b7370be72ae6f6323027554e2e" alt="Screenshot2025 10 16at6 58 31 Pn" title="Screenshot2025 10 16at6 58 31 Pn" className="mx-auto" style={{ width:"45%" }} width="1138" height="1430" data-path="images/Screenshot2025-10-16at6.58.31.png" />
    </Frame>
  </Step>

  <Step title="What's Next?">
    Next, you can take the following actions:

    1. **Collaborate** - Share the flow either as a [draft workflow](how-to/share-flow.mdx) or as an [interface.](how-to/share-interface.mdx)
    2. **Run via API** - Once you’ve defined the inputs and outputs, you can execute the workflow through an API request.
    3. [**Monitor**](how-to/monitor-flow.mdx) - In the "Monitor" page, you can view details about the scheduled flow along with its metadata.

    <img src="https://mintcdn.com/kadabra/0GjnGvB-0N0iakZB/images/Screenshot2025-10-16at6.59.34.png?fit=max&auto=format&n=0GjnGvB-0N0iakZB&q=85&s=32dd4d2143825fca720e754ba72f9ea0" alt="Screenshot2025 10 16at6 59 34 Pn" title="Screenshot2025 10 16at6 59 34 Pn" style={{ width:"47%" }} width="1194" height="1040" data-path="images/Screenshot2025-10-16at6.59.34.png" />
  </Step>
</Steps>

<Tip>
  Ask Kadabra's Agent: **Add a Slack message if sentiment is positive** or **Switch the trigger to daily at 9 AM**. The Agent edits the flow live.
</Tip>
