Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.guild.ai/llms.txt

Use this file to discover all available pages before exploring further.

A session is a conversation with an agent. You provide input, the agent runs, asks questions if needed, and returns its output.

​
Starting a session

​
Web UI

  1. Open your workspace at app.guild.ai
  2. Click New session
  3. Select an agent, type a message, and press Enter

​
CLI

guild session create --agent <agent-name> --workspace <workspace-id>

​
How sessions work

  1. You send a message to an agent
  2. guildcore receives the request, authenticates it, and forwards it to the runtime
  3. The runtime loads the agent code and executes it
  4. The agent can call tools, invoke sub-agents, make LLM calls, and ask you questions
  5. When the agent finishes, its output is returned to your session

​
Session lifecycle

Sessions can be in one of several states:
StateDescription
ActiveThe agent is running or waiting for your input
CompletedThe agent has finished and returned its output
FailedThe agent encountered an error

​
Multi-turn sessions

Agents built with mode: "multi-turn" keep the session open for back-and-forth conversation. The session remains active until the agent calls the __submit__ tool to signal completion.

​
Managing sessions

# List sessions in a workspace
guild session list --workspace <workspace-id>

# Get session details
guild session get <session-id>