> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/agents/viewing-agents.md).

# Viewing Agents

### Overview

The **Agents** page provides a consolidated inventory of all agents in your BalkanID tenant, including agents discovered from integrations, manually registered agents, and agents uploaded by CSV.

Users, Risk Managers, and IT Administrators can navigate to **Configure → Agents** from the navigation bar.

<figure><img src="/files/ZjkdqjDBy6lVQvClLfWK" alt=""><figcaption></figcaption></figure>

For concepts such as owners, access associations, and extracted vs registered agents, see [Introduction to Agents](/agents/introduction-to-agents.md).

### Agent fields

The Agents page displays the following fields for each agent:

| **Name**        | Name of the agent                                                          |
| --------------- | -------------------------------------------------------------------------- |
| **Agent type**  | Type of agent                                                              |
| **Application** | The integrated application where the agent was discovered, when applicable |
| **Owner**       | The employee accountable for the agent                                     |
| **Status**      | Current state of the agent (for example, active or inactive)               |
| **Risk**        | Risk signal associated with the agent                                      |
| **Identities**  | Count of identities the agent has access to                                |
| **Credentials** | Count of credentials the agent has access to                               |
| **Updated**     | Timestamp indicating when the agent record was last updated                |

### Actions on the Agents page

Depending on your role, the Agents page may include:

* **Register agent** — Add agents manually
* **Upload CSV** — Import or update agents in bulk
* **Actions → Change owner** — Update owners for selected agents (Administrators)
* **Actions → Delete** — Delete selected manually registered agents (Administrators)

### Investigating agents

Use search and filters on the Agents page to prioritize:

* Agents without an owner
* Agents with elevated risk
* Agents tied to many identities or credentials
* Agents extracted from a specific application
* Agents that were manually registered or uploaded

Agents also appear in related discovery views:

* Application details → **Agents**
* Identity or credential details → **Accessible by agents**
* User details → **Agents owned**

### Viewing an individual agent

Open any agent to see its summary, associations, and access.

<figure><img src="/files/myHTHgEWDlJfSFPuPETO" alt=""><figcaption></figcaption></figure>

#### Summary

The agent summary can include Status, Risk, Agent type, Source, Owner, Identities, Credentials, Created, and Updated.

If an agent has no owner and you have permission to assign one, use **Assign owner**.

* For **manually registered** or **CSV** agents, you can edit agent fields and owner.
* For **extracted** agents, you can assign an owner; other fields remain read-only because they are controlled by the source integration.

#### Detail tabs

* **Has access to** — Connections and resources the agent can reach, including permissions and access providers.
* **Identities** — Identities the agent has access to. When NHI is enabled, filter by All / Human / Non-human. Use **Unmap from agent** to remove an association.
* **Credentials** — Credentials the agent has access to. Use **Unmap from agent** to remove an association.

#### Capabilities (extracted agents)

For agents synced from an application integration, BalkanID may also show:

* **MCP servers** — External tool servers the agent is configured to use
* **Built-in tools** — Native tools attached to the agent in the source system

If no capabilities are available, BalkanID shows that the agent has no MCP servers or built-in tools attached in the source integration.

**Metadata** opens a **Raw metadata** drawer with source details when available.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.balkan.id/agents/viewing-agents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.