View Source Agens.Job.Node (agens v0.2.0)

The Node struct defines a single node within a Job.

A Node is a combination of a text :objective, zero or more MCP :tools and :resources, an optional :agent_id for loading context, and an optional :sub Job to run in place of this Node's inference call. The :serving field is the only required link to a running process — it names the Agens.Serving that performs inference (or, when :sub is set, the Serving whose Agens.Serving.handle_sub/3 callback maps the Sub-Job's result back into this Node's outputs and routing).

Fields

  • :serving - The Agens.Serving to run inference against. Required, even when :sub is set; the Serving owns routing for the Node's result (via the Router's outputs/1 + resolve/2, or via handle_sub/3 when :sub is set).
  • :agent_id - The agent identifier used to load context for this Node (see Serving.load_context/2).
  • :sub - The id of a sub-Job to run in place of a Serving inference call. The Node's Serving is still used to route the Sub's result via Agens.Serving.handle_sub/3.
  • :objective - An optional string added to the LM prompt explaining the purpose of this Node.
  • :tools - Tool definitions made available to the Serving for this Node.
  • :resources - List of Agens.Resource structs to be loaded prior to inference.

Summary

Types

schema()

A tool schema, opaque to the Job.

t()

Functions

from_map(m)

Builds a Agens.Job.Node from a decoded map (e.g. the output of Jason.decode!/1).

Types

Link to this type

schema()

View Source 
@type schema() :: binary()

A tool schema, opaque to the Job.

Link to this type

t()

View Source 
@type t() :: %Agens.Job.Node{
  agent_id: binary() | nil,
  objective: String.t() | nil,
  resources: [Agens.Resource.t()] | nil,
  serving: atom(),
  sub: binary() | nil,
  tools: [schema()] | nil
}

Functions

Link to this function

from_map(m)

View Source 
@spec from_map(map()) :: t()

Builds a Agens.Job.Node from a decoded map (e.g. the output of Jason.decode!/1).

String keys are expected. The "serving" field, if present, is converted to an existing atom.