Session

This page is auto-generated from the formations OpenAPI spec. Do not edit manually — run pnpm generate-formations-resource-docs to regenerate.

Creates a session attached to an agent within the formation's project.

Syntax

type: session
properties:
  agent_id: String
  name: String
  actor_id: String
  auto_generate: Boolean
  tool_context: Object

Output

The physical resource ID is the public ID of the created resource. Reference it from other resources with a ref expression:

      some_field:
        ref: MySession

Properties

agent_id

Public ID of the agent that owns this session

Required: Yes Type: String

---

name

Human-readable label for the session

Required: No Type: String Nullable: Yes

---

actor_id

Public ID of an actor to associate with this session

Required: No Type: String Nullable: Yes

---

auto_generate

Whether to automatically generate a response when messages are sent

Required: No Type: Boolean

---

tool_context

Optional context object passed to tool calls

Required: No Type: Object Nullable: Yes

---