sypho run

Trigger a run for a deployed agent.

Usage

sypho run <AGENT> --input <INPUT> [OPTIONS]

Arguments

Argument	Description
AGENT	Agent name and version (name:version)

Options

Flag	Default	Description
--input <INPUT>	—	Inline JSON, or a path to a JSON file (required)
--entrypoint <NAME>	main	Entrypoint to execute
--deployment-type <TYPE>	—	Target deployment type
--deployment <NAME>	—	Target a specific deployment by name
--follow, -f	off	Stream logs after triggering

Examples

Inline input

sypho run my-agent:0.1.0 --input '{"message": "Hello"}'

Input from a file

echo '{"query": "What is the weather?"}' > input.json
sypho run weather-agent:0.1.0 --input input.json

Target a deployment

sypho run my-agent:0.1.0 --input '{"task": "process data"}' --deployment-type prod

Follow logs immediately

sypho run my-agent:0.1.0 --input '{"message": "Hello"}' --follow

Response

{
  "run_id": "run_8f2a19c4",
  "status": "pending",
  "agent_name": "my-agent",
  "version": "0.1.0"
}

Run Lifecycle

1. pending — run created, step queued
2. running — a runner has claimed the step and is executing the agent container
3. completed — execution finished successfully
4. failed — execution failed with an error

Next Steps

• logs Command
• deploy Command