Call an action from a workflow

What you'll build

Detect a specific bot in a Surface workflow and fire a custom trigger. Firing the trigger runs any Action configured for that trigger.

1. Prerequisites

1. A Component Workflow in a Surface
2. A trigger with slug claude-visit and an Action that listens to it. See Send a Slack message from an Action for a complete example.

2. Fire the trigger from the surface

Update the surface workflow to detect Claude and fire the claude-visit trigger:

const workflow: SurfaceWorkflow = async ({ identity, context, utils }) => {
  const isClaude = context.botTags.some(
    (tag) => tag.product === "Claude User" || tag.operator === "Anthropic",
  );

  if (isClaude) {
    await utils.triggers.fire(
      "claude-visit",
      { rawUrl: context.rawUrl },
      identity,
    );
  }

  return {};
};

export default workflow;

Result

When Claude visits the surface, the workflow fires claude-visit. Any action configured for that trigger runs asynchronously with the payload you passed to utils.triggers.fire.

Additional resources

• Send a Slack message from an Action
• Triggers
• Actions
• Surface Workflows reference
• Action Workflows reference
• Observability