Home Agents & sessions Agent lifecycle, start, stop, and sessions

Agent lifecycle, start, stop, and sessions

Last updated on Sep 17, 2026

Create and run

  1. In the workspace, create an agent with the runtime your plan provides.

  2. Start or open a session so the agent is addressable.

  3. Use chat, files, and git features as shown in the portal UI.

  4. Stop or archive when work is done so capacity is released.

IDE-connected agents use ACP. Context for a project often sits in .agenstra.

Common states

  • Ready / online: you can message the agent

  • Starting / provisioning: wait; check Cloud machines if it stays stuck

  • Offline / error: see Troubleshooting for offline agents

  • Waiting for approval: a ticket or policy is blocking further action

Tips

  • Prefer one clear session per task when debugging.

  • Capture agent or session IDs (not secrets) before contacting Support.

  • Deeper agent reference: docs.agenstra.com ai-agents.