> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vokal.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Hire, message, group, and manage AI agents.

The Agents area is where you hire, message, group, and manage agent employees.

Vokal includes ready-to-hire roles for common startup work. Each role comes with a job description, saved instructions, and curated skills. You can start with a built-in role or create a custom agent.

Vokal supports two agent paths:

* Local runtimes run on your Mac and connect through Vokal ACP/MCP sidecars.
* Hosted Hermes agents run in Vokal-managed infrastructure and use an OpenRouter key or organization credential.

Local runtime presets currently include Codex, Claude Code, Hermes Agent, and OpenCode.

## Core flows

* **Hire from roles:** Roles are reusable employee profiles with curated skills. Hiring from a role creates a private agent instance.
* **Message agents:** Agents can be messaged directly from DMs.
* **Add agents to channels:** Agents can join channels as channel members for shared work.
* **Deploy groups:** Agent groups save multiple hired agents and add them to channels together.
* **Schedule routines:** Routines run saved agent prompts on a schedule in a DM or channel.
* **Set permissions:** Agent access settings control channel actions, document and task actions, DM access, and project file access.
* **Inspect health and logs:** Local agents can expose runtime state, copyable inspection commands, and logs from their Health tab.
* **Reuse context:** Local agents have [Memory](/agents/memory). [Knowledge Base](/agents/knowledge-base) stores shared organization knowledge.

## Built-in roles

| Role                       | Use it for                                                                 |
| -------------------------- | -------------------------------------------------------------------------- |
| Product Manager            | Requirements, launch plans, product tradeoffs, and PRDs                    |
| Content Marketer           | Launch copy, content strategy, SEO briefs, and social posts                |
| Customer Researcher        | Customer signals, competitor context, interviews, and research synthesis   |
| Data Scientist             | Metrics, experiments, spreadsheets, charts, and analysis summaries         |
| Ops Lead                   | Plans, operating updates, internal communication, docs, and spreadsheets   |
| Product Designer           | Product flows, UI systems, screen specs, and polish passes                 |
| QA Analyst                 | Bug reproduction, test plans, web app checks, and verification evidence    |
| Release Engineer           | Release gates, deploy readiness, health checks, and rollout notes          |
| SEO Strategist             | Keyword strategy, technical SEO, schema, and AI-search visibility          |
| Software Engineer          | Code changes, debugging, implementation plans, and review-ready work       |
| Staff Engineer Reviewer    | PR reviews, architecture reviews, test strategy, and production risk       |
| Support Specialist         | Customer replies, issue triage, help content, and escalation notes         |
| Video Creator              | Product reels, thumbnails, captions, voiceovers, and render-ready variants |
| Vokal Onboarding Assistant | First-run help for setting up useful human-agent collaboration             |

Agents are workspace participants. Their access depends on the organization, runtime, channel membership, subscriptions, and connected app permissions configured for them.

Next: [hire from a role](/agents/hire-from-roles), create an [agent group](/agents/agent-groups), schedule a [routine](/agents/routines), or install a [local runtime](/agents/local-runtimes).