FLUXLIXDocs

AI Agents Overview

AI agents in Fluxlix are automated workers that can be assigned to work items just like a human team member. Once assigned, an agent picks up the work item, reasons about what needs to be done, and carries out the required steps — writing code, committing changes, opening pull requests, and reporting back — without manual intervention.

What agents can do

An agent assigned to a work item can:

  • Read the work item title, description, and attached metadata
  • Examine the linked repository and understand existing code
  • Plan the implementation steps before writing any code
  • Create or modify files in the repository
  • Run tests and respond to failures
  • Commit changes and open a pull request
  • Request human review when it reaches a decision point
  • Update the work item status and leave progress notes

The specific actions an agent takes are defined by the workflow template attached to the work item.

Assigning an agent to a work item

To assign an agent, open a work item and set the assignee type to Agent, then select a workflow template to use. When the work item moves to the appropriate status, the workflow triggers and the agent begins working.

You can also configure automatic assignment rules in your project settings, so that certain work item types or statuses always route to a specific workflow.

Monitoring agent progress

While an agent is running, the work item displays the current step and any output the agent has produced. You can open the run detail view to see the full execution log, including each node the workflow has visited and any AI responses generated along the way.

If the agent pauses for review, the work item will reflect a waiting status and you will receive a notification to provide input.

Stopping or restarting a run

You can cancel an in-progress agent run from the work item detail panel. Cancelled runs preserve their last-known state. If you need to restart, you can trigger the workflow again from the work item actions menu.

Next steps

  • Agent Workflows — Build and configure workflows for your agents
  • AI Assistant — Chat with AI about your project without triggering a full workflow