Search documentation

Browse Awaken Workforce docs
Docs/Awaken Workforcev0.1.0/User manual/StartCreate and complete work with Awaken Workforce
Note·You're reading pre-release documentation (v0.1.0). Interfaces and behavior may change before a stable release.

User manual · Start

Create and complete work with Awaken Workforce

What this page covers

Create one Issue, define its finish line, assign the next step, handle exceptions, and accept the result from the system that owns it.

Use Workforce when one job must keep moving across Agent runs, human decisions, and external systems. Start with the job itself: who owns it, what result is needed, what may block it, and which system can say that it is complete.

Workforce is available through focused early access. The first useful result is one Issue that you can create, advance, stop with an exact reason, and resume without replacing its owner or Workflow revision.

Start from the decision in front of you

The browser console groups the same product facts by the decision a person needs to make:

If you need to…OpenWhat you can decide there
commission and direct delivery across ProjectsWorkspace Homedefine an Outcome, see the Commission → Decompose → Execute → Accept path, and identify delivery that needs intervention
resolve a human decision or exceptionNeeds youfilter approvals, Issue Attention, and Agent/platform readiness signals without watching every Run
resume a temporary Agent conversationWorkspace Chatscontinue one URL-addressed Awaken Session and issue an explicit command without turning Flow into a transcript owner
check whether one Project can moveProject Overviewreview execution readiness, dispatch health, open work, and the next blocking configuration
inspect or accept a commissioned resultOutcomesOutcome Reviewcompare formal deliverables with the acceptance boundary and take only the transitions currently permitted
review one persistent interactive resultProject Canvasesopen one exact admitted canvas_artifact Resource revision, review or edit it, and explicitly send a request back to an Agent
understand one accountable unit of workIssues → Issue detailinspect owner, next action, diagnosis, Workflow position, worklog, approvals, relationships, and Agent conversation
use a solution-specific operating viewsolution Workbenchfollow the installed value path, metrics, and queues while the underlying Issue and Workflow remain authoritative

Runs and Agent Center project Agents execution health into the composed console. Resources projects Objects business facts and actions. Workforce uses those products without taking ownership of their Session, Run, Resource, or Action truth.

Chats is a command workbench projected over an Awaken conversation; it is not a Flow transcript, Issue, or execution record. Canvases is an Objects-owned Resource surface with immutable revisions, isolated Preview, review, and an explicit Send-to-Agent bridge; it is not a second Design backend or Workforce aggregate.

How the three products work together

ProductOwnsRole in one Outcome
Awaken WorkforceOutcome, Issue, Workflow, responsibility, Attention, formal deliverables, acceptancecommission the result, coordinate work, and record the final decision
Awaken ObjectsResourceType, Resource, Relation, Action, Observation, provenance, exact business revisionsupply governed context, allowed changes, and external business evidence
Awaken AgentsAgent publication, Session, Run, tools, Worker, Sandbox, committed execution and recoveryperform the delegated WorkUnit and return committed execution evidence

The composed path is Workforce commissions → Objects grounds context and actions → Agents executes → evidence returns → Workforce accepts. A technical Run can finish before the Outcome is ready for acceptance.

Create the first Issue

  1. Follow the quickstart to validate the deployment, start the local topology, and bootstrap a Project.
  2. Create an Issue with an owner and the outcome you expect. Add its required inputs and active dependencies before dispatch.
  3. Pin the Workflow revision that defines states, named outputs, approvals, and transitions. Later edits produce another revision; they do not change this Issue underneath you.
  4. Assign the ready WorkUnit to an Agent, person, or automation. The assignment and each attempt remain attached to the Issue.
  5. If a required input, approval, or check is missing, resolve the recorded Attention and retry. End the Issue only after its declared completion conditions pass.

The visible result is an Issue with one pinned process, a current state, and a reason for every advance or stop. Workforce can evaluate declared Workflow rules and recorded facts. Put an external check behind the Connector or verifier owned by that system, then record its returned fact.

Workforce is the work, responsibility, and outcome plane. Awaken is the sole Agent execution and control plane. A WorkUnit may use an Agent configured in Awaken, a supported compatible Agent, or an existing publication; none of those choices replaces the Issue as the work record.

How Workforce carries that Issue

flowchart LR
    I["Issue"] -->|pins| W["WorkflowRevision"]
    W --> R["readiness and assignment"]
    R --> U["WorkUnit"]
    U --> A["Agent or human action"]
    A --> F["named outputs and Resource facts"]
    F --> G["guards, approvals and transition"]
    G -->|advance| I
    G -->|cannot advance| N["Attention"]
    N -->|resolve or retry| I

A schedule can recheck later, a reaction can recompute after facts change, and an active dependency can withhold dispatch until its upstream Issue terminates. Those paths return to the same Issue and Workflow authority; they are not parallel task systems.

Static structure and ownership

ComponentOwnsDoes not own
Issue + pinned WorkflowRevisiondurable intent, process state, dependency and terminal outcomean Agent process or transcript
Workflowstates, slots, requirements, named produces/requires, guards and transitionsundeclared external truth
WorkUnitone assigned attempt and its event/state historyIssue completion policy
Resource / ResourceTypegoverned objects, actions, events and credential rolesmodel/provider configuration
Approval and Attentionexplicit human decision or exact non-progress reasona second lifecycle
Awaken Agent planeAgent publication, model/credential resolution and governed executionWorkforce’s business-work truth

The separation is deliberate: Workforce owns work and responsibility; Awaken owns Agent configuration and execution. Deployment TOML selects process composition but does not duplicate the persisted model catalog or credential vault.

Continue with the task you need

GoalStart here
Start Workforce, bootstrap a Project, and create an IssueQuickstart
Manually advance one declared Workflow transitionAPI Workflow tutorial
Create, follow, and recover workUse Workforce
Design Resources, Workflows, Agents, and PacksDesign and automate
Deploy and operate separated rolesDeployment topologies
Look up generated and typed contractsReference
Extend the kernelContribute and extend

For application-facing Agent configuration, protocols, durable sessions, and sandbox operations, use Awaken. Enter Awaken Agents internals only when embedding or extending its Rust execution kernel.