Overview
Triggers are events that initiate automated documentation updates in Promptless. When a trigger event occurs, Promptless analyzes the context and determines if documentation updates are needed.
Available trigger types
Section titled “Available trigger types”
GitHub PRs
Automatically triggered when pull requests are opened in your GitHub repositories
GitHub Commits
Monitor direct commits to default branches for documentation updates
GitHub Issues
Mention @Promptless in issues to request documentation updates
GitLab Merge Requests
Automatically triggered when merge requests are opened in your GitLab projects
Slack
Trigger updates from Slack conversations and support threads
Microsoft Teams (Beta)
Trigger updates from Microsoft Teams messages and mentions
Intercom (Beta)
Monitor support conversations for documentation gaps based on recurring user questions
API
Trigger documentation updates from external systems via HTTP API
How triggers work
Section titled “How triggers work”When a trigger event occurs:
- Event Detection: Promptless receives notification of the event (PR opened, message posted, etc.)
- Context Analysis: The system analyzes the event content, including code changes, conversations, or support interactions
- Relevance Assessment: Promptless determines if the event requires documentation updates
- Suggestion Creation: If relevant, Promptless creates documentation suggestions based on the trigger content and connected context sources
Configure triggers
Section titled “Configure triggers”Triggers are configured in your organization’s Configuration page using the triggers section of your promptless.yaml file. For each trigger, you can:
- Specify which repositories or channels to monitor
- Configure trigger-specific settings (e.g., directory filters, branch targeting)
- Set up publishing behavior through policy rules
See the Configuration Reference for the complete YAML schema.
Need a trigger type that isn’t currently supported? Contact us at help@gopromptless.ai - we regularly add new trigger types based on user feedback.
Automatic PR creation
Section titled “Automatic PR creation”When automatic PR creation is enabled in your publishing policies, Promptless automatically creates pull requests in your documentation repository with suggested changes. For commit triggers, you can optionally enable auto-merge to automatically merge documentation PRs as soon as they’re created.
Automatic PR creation is available for all Git-hosted documentation platforms.
Trigger events in documentation PRs
Section titled “Trigger events in documentation PRs”When Promptless creates a pull request for documentation updates, it automatically includes a list of the trigger events that led to those changes in the PR description. This provides valuable context for reviewers and creates clear traceability between documentation updates and their originating events.
Backfill suggestions
Section titled “Backfill suggestions”Backfill suggestions lets you run Promptless on pull requests that already exist, so you can catch up on documentation for work that merged before a trigger was watching. It’s available on saved pull request and merge request triggers: GitHub PRs, GitLab merge requests, and Bitbucket PRs.
Open the Backfill suggestions panel on a trigger row, choose a window of the last 14 days, last 30 days, or last 90 days, and select Preview. The preview lists the pull requests that were opened or merged in that window and that the trigger matches, applying your repository, directory, and branch filters. Backfill covers up to 1,000 pull requests per repository in the window.
Backfill matches pull requests that were opened or merged but it doesn’t replay historical approvals. A trigger that fires only on first approval returns no backfill results because approval matching applies only to live events going forward.
When the preview looks right, select Launch backfill to run it. Promptless processes each pull request live, exactly as it does for a new event: your publishing policy applies, so backfilled pull requests can create documentation PRs and send notifications. The panel updates with progress as the run works through the list.
Warning
Launching a backfill runs every matched pull request live. With automatic PR creation or auto-merge enabled, a backfill can create or merge documentation PRs and send notifications across all of those pull requests. Preview the list first so you know exactly which pull requests Promptless processes.