agent-types

Suggest Triggers

Analyze agent type system instructions and propose trigger configurations.

Uses the trigger-suggester platform agent to generate suggestions based on the agent’s described responsibilities. Returns event, schedule, and conversation trigger proposals that the user can accept, modify, or reject.

Returns: Trigger suggestions with agent type ID and proposed configurations.

Raises: HTTPException: 400 if agent type has no system instructions. HTTPException: 503 if the platform agent call fails or returns an invalid structured response.

POST

agents

types

{agent_type_id}

suggest-triggers

Suggest Triggers

curl --request POST \
  --url https://api.example.com/agents/types/{agent_type_id}/suggest-triggers

{
  "agent_type_id": "<string>",
  "suggestions": [
    {
      "name": "<string>",
      "description": "<string>",
      "configuration": {}
    }
  ]
}

Path Parameters

agent_type_id

string

required

Response

Successful Response

Response containing all trigger suggestions for an agent type.

Attributes: agent_type_id: SurrealDB ID of the analyzed agent type. suggestions: Ordered list of suggested triggers.

agent_type_id

string

required

suggestions

TriggerSuggestion · object[]

required

Show child attributes

Improve TaskRefine a task title and description. Routes to the seeded ``assist-improve-task`` platform agent and returns the agent's structured response. Returns: Improved title, description, and rationale.

Suggest Triggers

curl --request POST \
  --url https://api.example.com/agents/types/{agent_type_id}/suggest-triggers

{
  "agent_type_id": "<string>",
  "suggestions": [
    {
      "name": "<string>",
      "description": "<string>",
      "configuration": {}
    }
  ]
}

Documentation Index

Path Parameters

Response