Triggering Agents from incident.io Workflows
You can configure an incident.io workflow to call a Firetiger agent automatically when an incident is created (or at any other workflow trigger point). The agent receives details about the incident as its opening prompt, so it can immediately start investigating, pulling relevant logs, or running a runbook.
Prerequisites
You’ll need the trigger ID for the agent you want to invoke. Open the agent in Firetiger, look at the Triggers section, and copy the trigger ID from the Webhook row. It’ll look like triggers/abc123xyz. See Agent Webhooks for more detail on how webhook invocation works.
You’ll also need a Firetiger API key to authenticate the request. See API Keys for instructions on creating one.
Creating the Workflow
In incident.io, go to Workflows and create a new workflow. Set the trigger to Incident created (or whichever lifecycle event you want to fire on).
Add a Send a webhook step and fill it in as follows.
URL
https://api.ft-kernel.firetigerapi.com/firetiger.triggers.v1.TriggersService/InvokeTrigger
Method
POST
Headers
| Key | Value |
|---|---|
Content-Type |
application/json |
Authorization |
Bearer {your-api-key} |
Body
The body must include the trigger ID and a message — the opening prompt sent to the agent. Use incident.io’s template syntax ({{variable}}) to pull in incident details so the agent has context to work with.
{
"name": "triggers/{trigger-id}",
"message": "Incident has been created: .\n\nInvestigate this incident. Check for relevant errors, anomalies, or spikes in the data from around the time it was declared."
}
The message field is just a string, so write it as you would write the opening message to the agent in the chat UI. The more context you include, the better the agent can orient itself — incident name and ID at minimum, but you can expand the template with any workflow variables incident.io makes available in that step.
What Happens Next
When the workflow fires, Firetiger creates a new agent session and returns a session ID. The agent starts working immediately on the message you provided. You can see the session on the agent’s page in the Firetiger UI, or poll the sessions API to read its output.
Related Documentation
- Agent Webhooks — Full reference for the InvokeTrigger API