Zum Inhalt
Für Agenten

MCP Reference

agent_trigger_list

List Agent Triggers

Markdown Tools als JSON

Beschreibung

Lists every trigger for one AgentSchedule, sorted by next_run_at ascending so the soonest-to-fire row comes first. Inactive (active = false) triggers are included — filter client-side if you only want firing ones.

Zugriff

Zugriffsprofil: gated. Module: none. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
agent_schedule_id string Ja Schedule prefix id (asch_…).

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "agent_schedule_id": {
      "type": "string",
      "description": "Schedule prefix id (asch_…)."
    }
  },
  "required": [
    "account_id",
    "agent_schedule_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "agent_triggers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "agent_schedule_id": {
            "type": "string"
          },
          "frequency": {
            "type": "string"
          },
          "run_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "weekday": {
            "type": [
              "integer",
              "null"
            ]
          },
          "day_of_month": {
            "type": [
              "integer",
              "null"
            ]
          },
          "cron_expression": {
            "type": [
              "string",
              "null"
            ]
          },
          "timezone": {
            "type": "string"
          },
          "next_run_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_run_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "active": {
            "type": "boolean"
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "agent_schedule_id",
          "frequency",
          "timezone",
          "active",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "agent_triggers"
  ],
  "type": "object"
}
Seiten