cloud_agent_task_results

Creates, updates, deletes, gets or lists a cloud_agent_task_results resource.

Overview

Name	cloud_agent_task_results
Type	Resource
Id	railway.agents.cloud_agent_task_results

Fields

The following fields are returned by SELECT queries:

get

One CloudAgentTaskResult row.

Name	Datatype	Description
cloud_agent_id	string
session_id	string
task_id	string
completed_at	string
error	string
external_ref	string
metadata	object
session_state	string
status	string	(AWAITING_INPUT, COMPLETED, FAILED, PENDING, RUNNING)
structured_output	object
text	string

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	cloud_agent_id, session_id		Read the latest task on an agent/session without waking the VM. Backed by the Railway GraphQL query cloudAgentTask.
recover	exec	cloud_agent_id, session_id		Recover the latest task response from the agent. May wake the VM. Backed by the Railway GraphQL mutation cloudAgentTaskRecover.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
cloud_agent_id	string
session_id	string

SELECT examples

get

Read the latest task on an agent/session without waking the VM. Backed by the Railway GraphQL query cloudAgentTask.

SELECT
cloud_agent_id,
session_id,
task_id,
completed_at,
error,
external_ref,
metadata,
session_state,
status,
structured_output,
text
FROM railway.agents.cloud_agent_task_results
WHERE cloud_agent_id = '{{ cloud_agent_id }}' -- required
AND session_id = '{{ session_id }}' -- required
;

Lifecycle Methods

recover

Recover the latest task response from the agent. May wake the VM. Backed by the Railway GraphQL mutation cloudAgentTaskRecover.

EXEC railway.agents.cloud_agent_task_results.recover 
@cloud_agent_id='{{ cloud_agent_id }}', --required
@session_id='{{ session_id }}' --required
;