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

# User Management

# Managing access to the TechWolf Analyst Agent

Your own administrators manage agent access, per user, in the TechWolf
Console's **User Management**. It is the same user management you already use
for Console access; there is no separate admin surface.

Two independent things determine what a user can do:

* **Whether they can reach the agent:** the **Viewer** role under **TechWolf
  Agent**, assigned per user.
* **What they see once inside:** their **Data Foundation** roles and entity
  access. The agent never widens access.

<Note>
  Signing in through single sign-on is not by itself enough to reach the
  agent. Nobody has the agent role until an administrator assigns it; a user
  without it sees a no-access message.
</Note>

# Granting access

Any user who can manage users in your Console can grant agent access.

<Steps>
  <Step title="Open the user in User Management">
    In the TechWolf Console, go to **User Management**. Use **Add users**
    to add a new user, or **Edit users** to update an existing one.

    <Frame caption="Add a user in User Management.">
      <img src="https://mintcdn.com/techwolf/tsN6h2ZCZ5XiSEJ7/integrations/analyst-agent/copilot/images/console-add-user.png?fit=max&auto=format&n=tsN6h2ZCZ5XiSEJ7&q=85&s=f14ea3af1562a76b11f7a2dc043bf953" alt="Adding a user in the TechWolf Console" width="2000" height="1096" data-path="integrations/analyst-agent/copilot/images/console-add-user.png" />
    </Frame>
  </Step>

  <Step title="Check the user's Data Foundation roles">
    The **Data Foundation** roles determine which data the user, and so the
    agent on their behalf, is allowed to see. Confirm they match what you
    expect the user to be able to analyse; see [What determines what a user
    sees](#what-determines-what-a-user-sees).

    <Frame caption="Assign the user's data roles.">
      <img src="https://mintcdn.com/techwolf/tsN6h2ZCZ5XiSEJ7/integrations/analyst-agent/copilot/images/console-roles-data-foundation.png?fit=max&auto=format&n=tsN6h2ZCZ5XiSEJ7&q=85&s=c9a9bb9c65b23f25e11d225e0f4033c6" alt="Data Foundation roles" width="834" height="878" data-path="integrations/analyst-agent/copilot/images/console-roles-data-foundation.png" />
    </Frame>
  </Step>

  <Step title="Grant the agent role">
    Under **TechWolf Agent**, set **Roles** to **Viewer**, then select
    **Add** (or save your changes for an existing user).

    <Frame caption="Grant the TechWolf Agent role, then add the user.">
      <img src="https://mintcdn.com/techwolf/tsN6h2ZCZ5XiSEJ7/integrations/analyst-agent/copilot/images/console-agent-role.png?fit=max&auto=format&n=tsN6h2ZCZ5XiSEJ7&q=85&s=b832bfa650b637990f4efdc8a8937b5a" alt="TechWolf Agent role set to Viewer" width="1344" height="272" data-path="integrations/analyst-agent/copilot/images/console-agent-role.png" />
    </Frame>

    <Note>
      Access changes apply immediately. Users do not need to sign out and
      back in.
    </Note>
  </Step>
</Steps>

To see who has access today, review the **Analyst Agent** column in **User
Management**. To remove access, clear the user's **Viewer** role there; this
also takes effect immediately.

# What determines what a user sees

The agent inherits each user's Console access exactly. If a user cannot see
something in the Console, the agent will not show it or reason over it on their
behalf. These are the settings that shape the answers a user gets:

| Console access          | Effect in the agent                            |
| ----------------------- | ---------------------------------------------- |
| **Skill Supply Roles**  | Whether the user sees employee skills at all   |
| **Employee Org Units**  | Which employees are in scope                   |
| **Skill Demand Roles**  | Whether the user sees job skills at all        |
| **Tasks on Jobs Roles** | Whether the user sees job tasks                |
| **Jobs**                | Which jobs are in scope, all or a named subset |

<Note>
  A user whose access is narrowed gets a correspondingly narrower answer, not
  an error. If an answer looks incomplete, check the user's data access
  first.
</Note>

<Warning>
  A user cannot be given view access to all jobs while owning only some of
  them. If a user owns a subset of jobs, they see only that subset, and the
  agent answers accordingly. Differing view permissions per job are not
  supported today.
</Warning>

# Which data the agent can draw on

Separately from per-user access, the agent only uses the TechWolf data products
your organization subscribes to. These dataset entitlements are enforced
server-side on every request, **default-deny** and applied **per tenant**, not
per user. A tenant scoped to Market Intelligence receives only Market
Intelligence; when a question needs data outside your subscription, the agent
explains what is not covered rather than returning a partial answer. Access is
**read-only by construction**: the agent cannot execute actions in any HR
system.

<Note>
  Restricting specific user groups *within* a tenant to a subset of data
  sources is a roadmap item rather than a capability available today.
  Entitlements are applied at the tenant level.
</Note>

# Access through Microsoft 365 Copilot

Reaching the agent through Copilot changes nothing about who can see what.
Every message carries a verified Microsoft Entra identity, resolved to that
user's existing TechWolf role and data scope before any data is read. Users
still need the **Viewer** role, assigned exactly as above. See [How It
Works](./copilot/how-it-works) for the full identity and access model.

# Troubleshooting

* **A user cannot open the agent.** Confirm the **Viewer** role is assigned
  under **TechWolf Agent**. This is the most common cause.
* **A user sees fewer employees or jobs than expected.** This is data access
  working as intended. Review their organizational unit and job access.
* **Nobody in the organization can open the agent.** Contact
  [support@techwolf.ai](mailto:support@techwolf.ai). Access checks fail closed,
  so a temporary service issue results in access being denied, never granted.
