The Preventive maintenance manager agent helps you stay on top of recurring maintenance and inspection checks for your properties. The agent learns from your account's task history to identify repeating checks, flags any that are overdue or have been missed, and suggests creating tasks for them.
This agent creates tasks only after you approve its suggestions, giving you full control over your maintenance schedule.
Limitations
Review the following limitations before using the Preventive maintenance manager agent:
- Data access: If the agent can't fully read the task history or the property list, it doesn't suggest any checks and reports that the checks were not reviewed.
- Suggestion limit: If the agent finds more than 20 maintenance gaps, the rest are listed and suggested in later runs.
- Existing tasks: The agent never edits or deletes existing tasks, task templates, or recurring task series.
- External tools: If you run your operations in Breezeway or another partner tool, your account has little task history in Guesty, so the agent can learn few repeating checks.
Understand the Preventive maintenance manager agent
The Preventive maintenance manager agent runs automatically every Monday morning. It also runs once when a property is created in your account, and you can run it manually at any time.
During each run, the agent does the following:
-
Analyzes your account's task history to learn which maintenance and inspection checks repeat. A check counts as repeating when a task with the same title occurs at least 3 times on a property, at least 7 days apart, on 2 or more properties.
The agent uses the tasks' scheduled dates, not whether they were completed. This means it works even if your team never marks tasks as done.
- Flags checks that are:
- Overdue: The check was last done longer ago than its usual interval plus the overdue margin.
- Missing: The check has never been done on a property, but most of your properties have it.
- Needed on a new property: Your other properties get the check, and a property was just added. The agent suggests these checks when the property is created.
- Posts an approval card with its suggested tasks to the Agent activity feed.
The agent doesn't suggest a check if a task for it is already scheduled from today onwards.
If the agent doesn't find any repeating checks in your task history, it reports exactly that. It never reports that checks are on schedule.
Configure the agent's settings
Adjust how the agent learns your repeating checks and schedules the tasks it creates.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
AI hub. - At the top, select the Operations tab.
- Click the Preventive maintenance manager tile.
- In the right-side panel, set up the following settings:
- History lookback: How far back the agent reads your task history. The default is 365 days. You can set it to anything from 90 to 730 days.
- Overdue margin: The margin added to a check's usual interval before the check counts as overdue. The default is 25%.
- Missing property share: The share of properties that must have a check before the agent flags it as missing on a property that doesn't. The default is 60%.
- Schedule-ahead days: How many days ahead the agent schedules the tasks it creates. The default is 7 days.
- Ignored task titles: Task titles for the agent to ignore.
- Click Save.
Run the Preventive maintenance manager manually
In addition to the scheduled run, you can trigger the agent manually at any time from the AI hub.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
AI hub. - At the top, select the Operations tab.
- Click the Preventive maintenance manager tile.
- Under "When it runs", click Run now.
Review the results and status of the run in the activity feed.
Review the activity feed
After the agent runs, it posts an approval card to the Activity feed for your review.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
AI hub. - In the left submenu, click Agent activity.
- Find the card from the Preventive maintenance manager agent. Click the relevant row to review the report details in the right-side panel.
Understand the approval card
The approval card lists up to 20 suggested tasks, with overdue checks first. Each row shows the following information:
- The maintenance or inspection check
- The property
- When the check was last done
- How often the check usually happens
Approve or decline suggestions
On the approval card in the Agent activity feed, approve or decline each row. The card expires after 6 days. If you decline a row or the card expires, no task is created, and the agent suggests the check again on its next run.
Tasks created from approved suggestions
Before creating a task, the agent checks again so it doesn't duplicate a task that was added in the meantime. For each approved row, the agent creates one task with the following details:
- Title and type: The same title and type your account uses for the check.
- Priority: Medium.
- Description: When the check was last done and its usual interval.
- Scheduled date: 7 days ahead by default. You can change this in the agent's settings.
- Assignee: The person who did the check last, if known.