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

# Quickstart

> Connect your first app and test an agent in chat

<div style={{ position: 'relative', boxSizing: 'content-box', maxHeight: '80svh', width: '100%', aspectRatio: 1.86, overflow: 'hidden', borderRadius: '12px' }}>
  <iframe src="https://app.supademo.com/embed/cmokgtvtu8z2bza2iutgk21yd?embed_v=2&utm_source=embed" loading="lazy" title="Maadify Quickstart Demo" allow="clipboard-write" frameBorder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowFullScreen style={{ position: 'absolute', top: -1, left: 0, width: '100%', height: '100%', border: 'none', display: 'block', borderRadius: '12px' }} />
</div>

## Before you begin

* You have access to a Maadify tenant.
* You have credentials for at least one application you want to connect.
* You have permission to create connectors, agents, and company relationship agent configurations.

## Create and test your first agent workflow

<Steps>
  <Step title="Connect an application">
    Go to **Connectors** and select **Add connector**.

    Choose an application, enter your credentials, and save.

    <Check>
      You see the connector in the list with a connected status.
    </Check>

    <Frame>
      <img src="https://mintcdn.com/maadify/K7CT7HZ-nt5ok2U5/images/connectors/select_connector.png?fit=max&auto=format&n=K7CT7HZ-nt5ok2U5&q=85&s=15877e25c52f54d15057a08450fb2acb" alt="Connector creation" width="1536" height="825" data-path="images/connectors/select_connector.png" />
    </Frame>
  </Step>

  <Step title="Create a parent agent">
    Go to **Agents** and select **Create parent agent**.

    Give the agent a name, set its purpose, and save.

    <Check>
      The parent agent appears in your agent list.
    </Check>

    <Frame>
      <img src="https://mintcdn.com/maadify/X4aEKWAIWIr8YAhZ/images/parent-agents/create-parent-agent.png?fit=max&auto=format&n=X4aEKWAIWIr8YAhZ&q=85&s=feb1936576cb115ed7934e8969c5f124" alt="Parent agent creation" width="1536" height="825" data-path="images/parent-agents/create-parent-agent.png" />
    </Frame>
  </Step>

  <Step title="Add a sub-agent and tools">
    Open the parent agent and go to the **Sub agents** section.

    Add a sub-agent, select tools from your connector, and set a prompt template.

    <Check>
      The sub-agent shows at least one tool and a prompt template.
    </Check>

    <Tabs>
      <Tab title="Create Sub-Agent">
        <Frame>
          <img src="https://mintcdn.com/maadify/X4aEKWAIWIr8YAhZ/images/parent-agents/create_sub_agent.png?fit=max&auto=format&n=X4aEKWAIWIr8YAhZ&q=85&s=eb5d36cfa7334e74850dc90cd1793523" alt="Create Sub Agent" width="1482" height="829" data-path="images/parent-agents/create_sub_agent.png" />
        </Frame>
      </Tab>

      <Tab title="Add Tools">
        <Frame>
          <img src="https://mintcdn.com/maadify/X4aEKWAIWIr8YAhZ/images/parent-agents/add_tool_to_sub_agent.png?fit=max&auto=format&n=X4aEKWAIWIr8YAhZ&q=85&s=7ebe5198d1de169ada788a01480dd5b2" alt="Add Tools to Sub Agent" width="1488" height="557" data-path="images/parent-agents/add_tool_to_sub_agent.png" />
        </Frame>
      </Tab>

      <Tab title="Prompt Template">
        <Frame>
          <img src="https://mintcdn.com/maadify/X4aEKWAIWIr8YAhZ/images/parent-agents/add_prompt_sub_agent.png?fit=max&auto=format&n=X4aEKWAIWIr8YAhZ&q=85&s=a78aa5a73115ab0fb77e6cb863200bb6" alt="Add Prompt Template to Sub Agent" width="1734" height="804" data-path="images/parent-agents/add_prompt_sub_agent.png" />
        </Frame>
      </Tab>

      <Tab title="Agent Canvas">
        <Frame>
          <img src="https://mintcdn.com/maadify/X4aEKWAIWIr8YAhZ/images/parent-agents/agent_canvas.png?fit=max&auto=format&n=X4aEKWAIWIr8YAhZ&q=85&s=5f093699f8f9173fa8e5ec047379575e" alt="Agent Canvas" width="1880" height="1000" data-path="images/parent-agents/agent_canvas.png" />
        </Frame>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Add the agent to a relationship">
    Go to **Companies** and find the relationship where the agent should be available.

    In the **Agent Configs** column, click **Add Agent**, select the parent agent you created, and review the tool configuration for that relationship.

    Click **Add Agent Config** when all tools are configured.

    <Check>
      The parent agent appears as a badge in the relationship row and is available for that relationship.
    </Check>

    <Frame>
      <img src="https://mintcdn.com/maadify/X4aEKWAIWIr8YAhZ/images/parent-agents/add-parent-agent-to-relationship.png?fit=max&auto=format&n=X4aEKWAIWIr8YAhZ&q=85&s=961970bc048d245c57ef51e7975ce760" alt="Add Agent dialog showing parent agent selection for a company relationship" width="1536" height="825" data-path="images/parent-agents/add-parent-agent-to-relationship.png" />
    </Frame>
  </Step>

  <Step title="Test the agent in chat">
    Open **Chat** or go to [https://app.maadify.com/chat](https://app.maadify.com/chat).

    Choose the parent agent you created. You can select it as the default agent in chat settings, use **Select Agent**, or add it to the command box and choose it with `/`.

    Send a test message that matches the agent purpose.

    <Check>
      You see the agent respond in chat and can review each workflow step, including agent responses, tool calls, tool execution inputs, outputs, and sources.
    </Check>

    <Frame>
      <img src="https://mintcdn.com/maadify/K7CT7HZ-nt5ok2U5/images/chat/chat-demo.png?fit=max&auto=format&n=K7CT7HZ-nt5ok2U5&q=85&s=c942065a32acef2fcf805cd77fa5d7b1" alt="Test agent in chat" width="1536" height="825" data-path="images/chat/chat-demo.png" />
    </Frame>
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Connectors" icon="plug" href="/connectors">
    Configure tools, defaults, and tool testing.
  </Card>

  <Card title="Parent agents" icon="bot-message-square" href="/agents/parent-agents">
    Add rules, approvals, and tool execution logic.
  </Card>

  <Card title="Companies" icon="handshake" href="/companies">
    Deploy agents to relationships and configure relationship-specific tool settings.
  </Card>

  <Card title="Chat with agents" icon="messages-square" href="https://app.maadify.com/chat">
    Test agents, configure commands, and review workflow steps.
  </Card>

  <Card title="Agent activity" icon="activity" href="/agents/agent-activity">
    Review runs, context, and tool outputs.
  </Card>

  <Card title="Index data store" icon="database" href="/index-data-store">
    Store internal data for agents to reference.
  </Card>
</CardGroup>