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

# Accés per a agents d'IA: deixa que els agents dels teus usuaris actuïn per ells

> Amb Didit, els usuaris aproven que els seus agents d'IA actuïn per a ells en una sessió limitada que caduca sola i que es pot revocar.

L'accés d'agents de Didit Authentication permet que les persones que fan servir la teva aplicació aprovin els seus propis agents d'IA perquè actuïn en el seu nom.
La persona veu el que demana l'agent i l'aprova, i l'agent obté una sessió pròpia amb abast limitat. Aquesta sessió acaba automàticament i la persona o el teu equip la poden revocar en qualsevol moment.
El teu backend distingeix la sol·licitud d'un agent de la de la persona gràcies al camp `act` del token.

L'accés d'agents està inclòs en tots els plans, sense cap preu addicional.

## Com funciona

1. Un agent d'IA demana actuar en nom d'una persona a la teva aplicació, indicant els àmbits que necessita.
2. La persona inicia la sessió a la pantalla d'aprovació allotjada de la teva aplicació, o a la teva pròpia pantalla de consentiment, i veu el nom de l'agent, si està verificat i què sol·licita.
3. La persona pot restringir la sol·licitud (menys àmbits, una sessió més curta o només algunes de les seves [organitzacions](https://docs.didit.me/ca/authentication/organizations.md)), i després l'aprova, amb una clau d'accés nova quan la teva configuració ho demani.
4. L'agent rep un codi d'un sol ús i l'intercanvia pels seus propis tokens. Els seus tokens d'accés duren com a màxim 5 minuts, igual que els d'una persona.
5. Cada sol·licitud que l'agent fa al teu servidor porta un token en què la reclamació `act` indica l'agent i els àmbits que la persona ha aprovat.

La sessió de l'agent acaba quan s'acaba la seva durada, després del teu temps d'inactivitat, o quan la persona o el teu equip la revoquen.

## Activa'l i tria les regles

L'accés d'agents està desactivat per a una aplicació nova.
Activa'l a **Authentication > Agent access** i, després, tria **Edit settings**:

| Configuració | Opcions | Valor predeterminat |
| - | - | - |
| Què poden fer els agents | **Només lectura** (`read`): veure la informació del compte de la persona. **Actua en nom seu** (`act`): canviar la configuració i les preferències del compte de la persona. | Cap fins que triïs |
| Quins agents poden fer sol·licituds | Actualment, qualsevol agent pot fer una sol·licitud, i la pantalla d'aprovació mostra si està verificat. Permetre només agents verificats encara no està disponible. | Qualsevol agent |
| Quant dura una sessió | 1, 7 o 30 dies. | 7 dies |
| Finalitza després d'un període d'inactivitat de | 30 minuts, 2 hores o 24 hores. | 2 hores |
| Com aproven les persones | **Una clau d'accés**, o **El seu inici de sessió habitual**. | Una clau d'accés |
| Només les persones poden aprovar les sol·licituds dels agents | Cada aprovació necessita una aserció nova de la passkey pròpia de la persona que aprova. | Desactivat |

Les persones poden desactivar en la pantalla d'aprovació qualsevol àmbit que ofereixis, però mai activar-lo.
Els canvis s'apliquen a les noves aprovacions: les sessions d'agent actives conserven el que la persona va aprovar.

**Only people approve agent requests** (`agent_humans_only`) només pot canviar-ho un Owner o un Admin de la teva organització de Didit, que primer ha de tenir una passkey al seu compte de la consola.
Demostra que la persona que aprova ha utilitzat el seu propi autenticador amb verificació d'usuaris, mitjançant una aserció feta dins dels cinc minuts següents i vinculada a aquesta sol·licitud; no detecta l'automatització en general.
Per a la teva pròpia pantalla de consentiment, trobaràs les crides a [aprovació d'agents amb una passkey](https://docs.didit.me/ca/authentication/sign-in-methods.md#aprovació-d’agents-amb-una-passkey).

## Afegeix-ho a la teva aplicació

Els agents que ho admeten envien les persones a la teva pantalla d'aprovació per iniciativa pròpia.
La teva aplicació fa dues coses:

**Permet que les persones vegin i revoquin els seus agents.**
Amb React, renderitza `<ConnectedAgents />` a la pàgina de configuració del compte: mostra la llista d'agents que la persona ha aprovat, cadascun amb un botó **Revoke**.
Consulta la [guia d'inici ràpid de React](https://docs.didit.me/ca/authentication/quickstarts/react.md).

**Comprova l'afirmació `act` al backend.**
El token d'accés d'un agent es signa amb la mateixa clau i porta els mateixos `typ`, `iss` i `aud` que el d'una persona, de manera que només `act` els distingeix:

| `act` | Qui fa la crida | Què permetre |
| - | - | - |
| `null` | La persona. | Allò que la persona pot fer. |
| `{"sub", "agent", "scopes"}` | Un agent d'IA que actua en nom de la persona. | Només allò que concedeix `act.scopes`, a les rutes que obres als agents. Rebutja-ho a tots els altres llocs. |

`sid` en el token d'un agent és l'ID de l'accés que la persona ha concedit, i `GET /session/` sempre rebutja el token d'un agent.
Consulta [verifica un token al teu servidor](https://docs.didit.me/ca/authentication/tokens-and-jwks.md#verifica-un-token-al-teu-servidor) per veure les comprovacions en codi.

## Vigila i revoca des de la consola

**Authentication > Agent access** mostra:

* **At a glance:** les sessions d'agent actives, les sessions que les persones han aprovat en els últims 7 dies, les persones amb un agent i les revocacions d'aquest mes, per persones i per al teu equip.
* **Active agent sessions:** cada persona, l'agent amb la seva descripció i si està verificat, què pot fer, la seva última activitat i quan acaba, amb un botó **Revoke**.

![La pàgina Agent access a la Didit Business Console, amb la configuració de l'agent, les mètriques clau i les sessions d'agent actives amb un botó Revoke](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access.

Revocar posa fi immediatament a la sessió de l'agent, i pots enviar un correu electrònic a la persona per informar-la que s'ha acabat.
El teu equip també pot acabar totes les sessions d'agent d'una persona: bloquejar una persona, restablir-ne el MFA o revocar-ne les sessions des de **Users** també revoca el seu accés d'agent.

## Correus electrònics i esdeveniments

Quan el teu equip revoca l'accés d'un agent des de la consola, pots triar si s'envia un correu electrònic a la persona afectada.
El correu utilitza la teva marca, igual que qualsevol [correu electrònic d'inici de sessió](https://docs.didit.me/ca/authentication/branding-and-custom-domain.md#correus-d’inici-de-sessió).

Les aprovacions i les revocacions es registren com a esdeveniments `security.agent_access_approved` i `security.agent_access_revoked` a la cronologia de la persona.
Didit registra una aprovació quan la persona dóna el seu consentiment, fins i tot si l'agent no intercanvia mai el seu codi.
Consulta l'[auditoria d'aprovacions d'agents](https://docs.didit.me/ca/authentication/events-and-webhooks.md#auditoria-de-l’aprovació-de-l’agent).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.