> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocks.team/llms.txt
> Use this file to discover all available pages before exploring further.

# @on

The `@on` decorator is used to define the event that will trigger the agent.

<CodeGroup>
  ```python agent.py theme={null}
  @on("github.pull_request")
  ```
</CodeGroup>

The `@on("event")` decorator will correspond to the `event` payload of your function. See the [events documentation](/events) for more information.

### Arguments

<ResponseField name="event" type="string" required>
  The event that will trigger the agent. Supported values are `github.issues`, `github.issue_comment`, `github.pull_request`, `github.pull_request_review_comment`, `github.pull_request_comment`, `linear.issues`, `linear.issue_comment` `schedule.daily`, `schedule.weekly`, `slack.mention`, `webhook`.

  See the [events documentation](/events) for more information on the payloads for each event.
</ResponseField>

<Note>`schedule.daily` and `schedule.weekly` are only valid on `@task` entrypoints.</Note>