Documentation
Guides for using Harriet — organised by role. For in-app search and AI help, log in to your Harriet account.
Search by title, summary, tags, or category.
HR
- HR operations in Harriet
How HR teams use Harriet for day-to-day employee support and admin tasks.
- Working with tickets
Create tickets, follow threads, and keep employee requests organized.
- How do we organise knowledge so employees get clearer answers?
Structure the Knowledge Base around employee questions, owners, and plain language so Harriet cites the right material.
- How do we publish different policies for different countries or teams?
Publish separate knowledge documents with the right groups and geography metadata for each audience.
- How do we support managers who occasionally need another region's policy?
Give managers who need global context membership in a narrow group that can see reference documents without opening them to all staff.
- How do we use employee profiles to personalise answers without overexposing data?
Personalisation comes from HRIS-backed attributes and roles—balance helpful defaults with least data exposure.
- How do we use tickets when Harriet cannot fully resolve an issue?
Open a ticket for human follow-up, escalations, or anything that needs a tracked thread beyond a chat answer.
- How do we spot gaps in our knowledge base from recurring questions?
Review tickets, chat themes, and search misses to decide what to publish next in the Knowledge Base.
- Beginner's guide to workflows: building a new starter onboarding flow
A step-by-step introduction to building a real workflow—using new starter onboarding to cover triggers, authoring agent steps, assigning skills, reaching out to stakeholders, and pausing for replies.
- How do we design manager-safe analytics queries?
Keep workforce questions scoped, aggregated, and aligned with what managers are allowed to know about their teams.
- What workflows are available and where do I find them?
Harriet workflows are configured by your team—there are no locked-in templates, but common patterns for onboarding, leave, and data collection are straightforward to set up.
- What triggers a workflow to start?
Workflows can be started by a new ticket, a chat request, a scheduled time, or a webhook from an external system—choose the trigger that fits your process.
- How do we use workflows for repeatable HR and IT processes?
Workflows automate multi-step tasks with triggers, agent steps, and optional human checkpoints—separate from ad-hoc chat.
- How do approvals work in workflows?
Some workflow actions pause until an approver confirms them—often on the linked ticket—then the run continues automatically.
- How do workflows interact with tickets?
A ticket can trigger workflows, host approvals, and collect replies that resume a paused run—without duplicate noise loops.
- When does Harriet create a ticket for a workflow, and when does it not?
Running a workflow from chat may create a support ticket by default; many other triggers reuse an existing ticket or run without one.
- How do waiting steps work in workflows?
Workflows can pause for approvals, ticket replies, external replies, scheduled time, or sub-tasks—each resumes automatically when its condition is met.
- How do we design a workflow that pauses for information and then resumes cleanly?
Combine clear questions, ticket threading, and explicit resume behavior so pauses feel predictable to employees and HR.
- When should I use a single-step agent workflow instead of the canvas editor?
Start with one configurable agent step when plain-language instructions and skills are enough; open Advanced mode (canvas editor) when you need multiple separate automated phases or branching. Delegation runs one conversation at a time.
- How does the AI agent step work in a workflow?
The configurable agent step runs an AI agent inside a workflow—you write plain-language instructions, assign skills, and the agent completes the task, pausing where it needs human input.
- How do I collect information from employees or contacts via Slack or email?
Use the data-gathering agent step to have Harriet reach out by Slack DM or email, ask follow-up questions, and return a structured summary when the conversation is complete.
- How do complex workflows delegate tasks to other agents?
A workflow agent can hand off a bounded sub-task to a specialist sub-agent, wait for it to complete, and use the results to continue—enabling sophisticated multi-step automation without losing oversight.
- How do I run a workflow on a recurring schedule?
Scheduled workflows run automatically at set times—useful for regular reports, proactive reminders, and recurring compliance checks.
- How does a workflow agent remember what happened in previous steps?
Workflow agents maintain full conversation history within a run, so context from earlier steps is always available when the workflow resumes after any pause.
- How do I design a complex multi-step workflow?
Complex workflows combine a trigger, one or more agent steps with skills, pause mechanisms for human input, and clear error paths—designed in layers and tested before going live.
IT
- Integrations overview for IT
How Harriet connects to your HR and productivity systems safely—including MCP connectors managed alongside other integrations.
- Permissions and groups
Control who can manage knowledge, workflows, integrations, and sensitive data.
- How to set up Okta with Harriet
Step-by-step guide to Okta SSO (OIDC) and SCIM user provisioning in Harriet, including group push for roles.
- Skills and external tools (MCP)
How optional skills extend Harriet, how MCP connectors are governed, and how Endpoint AI review fits in for some organizations.
- How do we show information to only a limited group of people?
Use user groups on knowledge documents so only the right people see them in search.
- How do we decide between groups, tags, countries, and regions?
Choose the right metadata on knowledge documents for access control versus filtering and discovery.
- How do we let one group access global information without making it the default answer?
Combine group membership with geography and structure so local answers rank first but wider context stays available.
- How do we structure knowledge so Harriet answers with the right version first?
Split versions by audience and geography, write clear titles, and avoid one giant document that mixes jurisdictions.
- How do we connect Harriet to an HRIS and what profile data can it use?
Directory and HRIS integrations supply employee data Harriet can use for answers and automations, within your plan and permissions.
- How do we perform custom data mappings when our fields do not match Harriet's defaults?
Map vendor-specific HRIS or webhook fields to Harriet so syncs and automations use the right attributes.
- How do employee analytics permissions work?
Who can run workforce analytics in Harriet depends on roles, features, and any metadata scoping your admins configure.
- How to create an MCP connector (Company settings)
Step-by-step expectations for adding a new MCP connector in Company settings, syncing tools, and Endpoint AI review when enabled.
- What employee analytics questions can Harriet answer for admins and managers?
Example prompts for workforce analytics and what you need before they work reliably.
- MCP from GitHub and registries—sandboxed connectors vs skill packages
Two different ways GitHub and package registries show up in Harriet—sandboxed MCP connectors from npm-style commands vs GitHub-synced skill packages in Endpoint AI.
- How do we connect external tools using MCP?
MCP connectors let Harriet call approved third-party tools through governed skills—create them with New connector in Company settings, sync tools, and control who can use them.
- How do MCP tools work inside workflow agents?
MCP tools are exposed to workflow agents through skills—IT controls which tools are visible, which require confirmation before executing, and which may be used by sub-agents.
- How does MCP authorization work and what credentials are stored?
MCP servers may use org secrets, per-user OAuth, or API keys—know what Harriet retains, how the connector wizard maps to these patterns, and how approvals work in workflows.
- Single-step agent workflows vs Advanced mode (canvas editor)
Prefer a workflow with one configurable agent step unless teams need multiple canvas steps, branching, or strict separation of phases. Delegation is always serial—no parallel sub-agents.
- How do calendar integrations work, and when can Harriet book meetings?
Calendar features depend on which calendar integration is enabled and which user has connected their calendar to Harriet.
- How do I configure an agent step in a workflow?
Agent steps are the core of powerful workflows—choose skills carefully, configure delegation correctly, and always set a sub-agent timeout to avoid stuck runs.
- What is the security model for workflow sub-agents?
Sub-agents are isolated by design—they only see explicitly delegated skills, cannot access parent workflow data, and cannot delegate further.
- How do calendar permissions affect what Harriet can see or schedule?
The connected user’s calendar scopes and sharing settings determine list, read, and create access.
- How does expense filing work in Harriet?
When expenses are enabled, Harriet can help employees submit or check claims through your connected expense system, within that system’s rules.
- What can Harriet do with Word, Excel, and PowerPoint files?
Upload Office formats to the Knowledge Base, use them in automations where supported, and use template-based document generation—not full desktop editing in the assistant.
- How do public Slack or Teams channels improve answer quality for product-specific questions?
Dedicated public channels give Harriet a clear context so SSO, policies, and docs match the product or team the channel is for—not a generic default.
- What is the public website widget and how do we use it?
The embeddable Harriet widget lets visitors chat from your marketing or help sites with scoped knowledge, skills, and ticketing—without signing into Harriet.
Endpoint AI
- Rolling out Harriet with Endpoint AI
A practical sequence for enabling Harriet across chat platforms, embeds, and optionally Endpoint AI–managed desktops.
- Enrol a device — Harriet Desktop first
Recommended install order for Endpoint AI — secret enrollment link, Harriet Desktop download, link the device, then optional Claude Desktop for organizations that use it.
- What is Endpoint AI and when should we use it?
Endpoint AI is Harriet’s deployment and governance surface for consistent Harriet access on desktops and managed endpoints, including skills and connector review.
- How does Endpoint AI relate to provisioning skills?
Align endpoint deployments with the same skill catalog and restrictions admins approve in Harriet, then provision approved skills to teams or users.
- What rollout checks should we complete before turning on new integrations or skills?
Checklist before enabling integrations, MCP connectors, or new skills—including Endpoint AI review for connectors and package skills when your organization uses it.
- Using Skilify to build skills locally, submit for review, and provision them
Use the built-in Skilify skill on your endpoint to author Anthropic-style skill packages, push them into Harriet’s review queue, then have admins provision approved skills to teams or users.
- How do I share Harriet skills with my team?
After skills are approved, use the Endpoint AI console to assign Harriet skills or profiles to teams or users—including Quick assign from the Harriet skills list.
- Claude Desktop and desktop targets (Endpoint AI)
When to use Claude Desktop alongside Harriet, and how the default desktop target setting affects new devices.