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

# Graph Studio Overview

> Build intelligent workflows with visual automation, multi-agent orchestration, and enterprise-grade debugging capabilities.

## What is Graph Studio?

Graph Studio is Phinite's visual workflow builder that enables you to create sophisticated AI-powered automations without coding. Design complex multi-agent systems using an intuitive canvas interface, connect them with conditional logic, and deploy with full observability and access controls.

<CardGroup cols={2}>
  <Card title="Manual canvas editing (Recommended for beginners and for gaining a better understanding.)" icon="pencil" href="/graph-studio/manual-method">
    Design precise workflows by dragging and connecting nodes with full control over execution order.
  </Card>

  <Card title="Prompt-based creation (Aura)" icon="sparkles" href="/graph-studio/copilot-method">
    Describe your workflow goal in natural language and let AI generate the initial workflow structure, prompt, tools and variables.
  </Card>

  <Card title="Agent Registry (A2A)" icon="share-nodes" href="/agent-registry/overview">
    Expose published graphs as external agents, browse the catalog, and attach registry agents on the canvas.
  </Card>
</CardGroup>

## Key capabilities

### Visual workflow design

* **Drag-and-drop canvas**: Intuitive interface powered by React Flow for complex workflow visualization
* **Real-time collaboration**: Multiple team members can work on flows simultaneously with live updates
* **Version control**: Track changes, compare versions, and rollback to previous iterations

### Multi-agent orchestration

* **Master Agents**: Primary reasoning units with full access to tools, RAG, and conditional logic
* **Child Agents**: A helper agent for the master agent, designed to handle specific LLM-based tasks.
* **Registry agents (A2A)**: Attach agents from the [Agent Registry](/agent-registry/overview) in Browse or Discovery mode on a master agent node
* **Agent communication**: Seamless data passing and coordination between agents

### Enterprise features

* **Role-based access**: Control who can view, edit, or publish flows based on [user roles](/user-management/user-roles)
* **Environment management**: Deploy flows across Development, UAT, and Production environments
* **Audit trails**: Complete logging of all changes, executions, and user actions

### Advanced logic & data

* **Conditional routing**: Use LLM-evaluated decision variables to create dynamic workflow paths
* **Variable management**: Capture, transform, and pass data between workflow steps
* **RAG integration**: Ground agents with enterprise knowledge from connected data sources

### Debugging & observability

* **Execution logs**: Real-time monitoring of workflow runs with detailed step-by-step traces
* **Error handling**: Comprehensive error boundaries and debugging tools for troubleshooting
* **Performance metrics**: Track execution times, success rates, and resource usage

## Prerequisites

### Access requirements

* **Workspace membership**: You must be added to a workspace with appropriate [permissions](/user-management/access-controls)
* **Role assignment**: Minimum "Developer" role required for creating flows, "Admin" for publishing
* **Project access**: Agent Graphs are created within projects - ensure you have project-level access

### Technical setup

* **Data sources**: Configure [RAG collections](/graph-studio/rag-management) if agents need enterprise knowledge
* **Tool integrations**: Set up [external APIs](/devstudio/overview) and custom logics.
* **Environment variables**: Configure any required secrets or configuration values

## User roles and permissions

<Warning>
  Graph Studio access is controlled by workspace-level permissions. Users without appropriate roles will see limited functionality or be blocked from accessing certain features.
</Warning>

| Role           | Can Create Agent Graphs | Can Edit Agent Graphs | Can Publish Agent Graphs | Can View Logs |
| -------------- | ----------------------- | --------------------- | ------------------------ | ------------- |
| **SuperAdmin** | ✅                       | ✅                     | ✅                        | ✅             |
| **Admin**      | ✅                       | ✅                     | ✅                        | ✅             |
| **Developer**  | ✅                       | ✅                     | ❌                        | ✅             |
| **Tester**     | ❌                       | ❌                     | ❌                        | ✅             |
| **Viewer**     | ❌                       | ❌                     | ❌                        | ❌             |

## Getting started workflow

<Steps>
  <Step title="Access Graph Studio">
    Navigate to your workspace → Assistants → \[Agent graph] → Studio tab

    <Check>
      You should see the Graph Studio interface with canvas, nodes, and inspector panels.
    </Check>
  </Step>

  <Step title="Choose creation method">
    Decide either "Create with Aura" for AI-assisted generation or "Create manually"(recommended) for full control.

    <Tip>
      Start with Aura for Fast creation, then refine manually for precise control.
    </Tip>
  </Step>

  <Step title="Design your workflow">
    Add nodes, configure agents, connect logic, and test your Agent Graph with sample inputs.

    <Note>
      Use the debugging logs in the bottom panel to monitor execution and troubleshoot issues.
    </Note>
  </Step>

  <Step title="Publish and deploy">
    Save your flow, add version notes, and publish to your target environment.

    <Warning>
      Only users with "Admin" or "SuperAdmin" roles can publish flows to production environments.
    </Warning>
  </Step>
</Steps>

## Related concepts

* [**Building Assistants**](/assistants/overview): Learn how flows integrate with conversational and autonomous assistants
* [**Agent Registry (A2A)**](/agent-registry/overview): Expose, discover, and compose external agents
* [**DevStudio**](/devstudio/overview): Create custom tools that flows can utilize
* [**Observability**](/observability/overview): Monitor flow performance and debug issues
* [**User Management**](/user-management/user-management): Understand workspace permissions and access controls