Agent Sessions is in private preview. The feature is enabled per workspace by the Orq.ai team and the API is not part of the public SDKs yet. Behavior and field names can still change.
Configuration
Triggers
A loop has up to 10 triggers and any of them starts a run. A loop can have none.- GitHub events: an event of a connected GitHub source, optionally scoped (for example to a repository) and filtered by conditions on the event payload, such as
author_association. Events caused by the factory’s own GitHub App are ignored unlessinclude_app_eventsis set. - Schedules: hourly, daily, weekly or monthly, in an IANA time zone (UTC by default), with an optional end time.
- Webhooks:
POSTrequests to the trigger’s URL. The secret goes in theX-Webhook-Secretheader or the?secret=query parameter, and is shown once when the trigger is created or rotated. Other methods are not routed, and a request whose conditions do not match is accepted and ignored. - Manual: any active loop can be run by hand, with or without triggers. The run has
trigger_idmanualand the optional input is available as{{event.input}}. A paused or archived loop cannot be run by hand.
event_repository settings. A fixed repository that names the same repository takes its place. The run fails with the event names no repository when the event carries none. Schedule, webhook and manual runs clone only the fixed repositories.
An archived factory stops all of its loops from firing.
Limits
Server defaults, not editable in the UI.Runs
Every firing is recorded as a run with a status:queued, running, completed, failed or skipped. A skipped run has no session and a skip_reason:
The Sessions tab of a loop lists its runs with their event, status and linked session.