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

# Identidad de Máquina (MAIP)

> Registre, autorice y supervise agentes de IA con identidad criptográfica y restricciones de comportamiento.

# Protocolo de Identidad de Máquina y de Agente

El **Protocolo de Identidad de Agente de Máquina (MAIP)** proporciona registros de identidad para agentes de IA, bots y servicios automatizados, para registrar agentes y registrar sus permisos y actividad.

> [!WARNING]
>
> Algunas operaciones de MAIP actualmente registran resultados proporcionados por el llamador en lugar de ejecutarlos o verificarlos de forma independiente. La extracción de documentos y los veredictos de IA se simulan; las barreras de seguridad clasifican una puntuación enviada; los manejadores de orquestación y flujo de trabajo crean registros de seguimiento. Varios recibos generados utilizan marcadores del sistema en lugar de firmas criptográficas. Lea las limitaciones de implementación de la operación antes de confiar en su salida como evidencia.

## ¿Por qué la identidad de la máquina?

A medida que los agentes de IA proliferan en los flujos de trabajo empresariales, las organizaciones se enfrentan a un desafío crítico: **¿Cómo saber qué agente hizo qué y si estaba autorizado?**

MAIP resuelve esto con:

* **Identidad de agente criptográfico** — Cada agente obtiene una ID única (`maip-agent:<ulid>`) y claves de firma
* **Autorización basada en alcance** — Los alcances de permisos granulares controlan lo que cada agente puede hacer
* **Aplicación de políticas en tiempo de ejecución** — [políticas MAIP](https://docs.truthlocks.com/es/guides/maip-policies.md) evalúan puntuaciones de confianza, alcances y profundidad de delegación antes de cada acción sensible
* **Puntuación de confianza** — La evaluación conductual continua produce una puntuación de confianza de 0 a 100
* **Gestión de sesiones** — Contextos de ejecución con límite de tiempo y caducidad automática
* **Delegación entre inquilinos** — Los agentes pueden delegar autoridad a través de los límites organizacionales
* **Interruptor de emergencia** — Revocación de emergencia instantánea del acceso de cualquier agente

## Arquitectura

```
┌─────────────────────────────────────────────┐
│              Your Application                │
│  ┌─────────┐  ┌─────────┐  ┌─────────────┐  │
│  │ Agent A │  │ Agent B │  │  Agent C    │  │
│  └────┬────┘  └────┬────┘  └──────┬──────┘  │
│       │            │              │          │
│  ┌────▼────────────▼──────────────▼──────┐  │
│  │         MAIP SDK (JS / Go / Py)       │  │
│  └────────────────┬──────────────────────┘  │
└───────────────────┼─────────────────────────┘
                    │ HTTPS
    ┌───────────────▼───────────────┐
    │   Machine Identity Service    │
    │  ┌──────┐ ┌───────┐ ┌──────┐ │
    │  │Agents│ │Scopes │ │Trust │ │
    │  │      │ │       │ │Scores│ │
    │  └──────┘ └───────┘ └──────┘ │
    └───────────────────────────────┘
```

## Pruébelo en el entorno de pruebas

Cada endpoint MAIP tiene un entorno de pruebas de API interactivo integrado en la documentación. Puede construir solicitudes, cambiar entre entornos de [Sandbox y Producción](https://docs.truthlocks.com/es/environments.md#try-it-in-the-api-playground) y enviarlas directamente, sin necesidad de una herramienta separada.

Todos los puntos finales de MAIP están cubiertos, abarcando diez grupos de API: [Agentes de Máquina](https://docs.truthlocks.com/es/api-reference/machine-identity/agents/register.md), [Sesiones y Herramientas de Agente](https://docs.truthlocks.com/es/api-reference/machine-identity/sessions/create.md), [Confianza y Testigo](https://docs.truthlocks.com/es/api-reference/machine-identity/trust-scores/get.md), [Políticas MAIP](https://docs.truthlocks.com/es/api-reference/machine-identity/policies/list.md), [Reclamaciones de Verdad y Documentos](https://docs.truthlocks.com/es/api-reference/machine-identity/truth-claims/create.md), [Cumplimiento y Anomalías](https://docs.truthlocks.com/es/api-reference/machine-identity/compliance/create-check.md), [Conjuntos de Datos y Modelos](https://docs.truthlocks.com/es/api-reference/machine-identity/datasets/attest.md), [Orquestaciones y Flujos de Trabajo](https://docs.truthlocks.com/es/api-reference/machine-identity/orchestrations/execute.md), [Barandales y Delegación](https://docs.truthlocks.com/es/api-reference/machine-identity/guardrails/check.md), y [Observabilidad](https://docs.truthlocks.com/es/api-reference/machine-identity/observability/events.md).

El entorno de pruebas admite autenticación `X-API-Key` y Bearer JWT. Utilice `X-API-Key` para pruebas rápidas y Bearer JWT cuando necesite autenticarse con un token de sesión de un agente en ejecución.

> [!TIP]
>
> Abra cualquier punto final en la referencia de la API de [Agentes de Máquina](https://docs.truthlocks.com/es/api-reference/machine-identity/agents/register.md) y haga clic en **Enviar** para probarlo en vivo contra el Sandbox.

## Inicio rápido

### 1. Registrar un agente

```bash cURL theme={null}
curl -X POST https://api.truthlocks.com/v1/agents \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order-processor",
    "type": "autonomous",
    "scopes": ["receipts:write", "attestations:read"],
    "metadata": {
      "framework": "langchain",
      "model": "gpt-4o",
      "owner": "platform-team"
    }
  }'
```

```javascript JavaScript theme={null}
import { TruthlocksMAIP } from "@truthlocks/sdk";

const maip = new TruthlocksMAIP({ apiKey: process.env.TL_API_KEY });

const agent = await maip.agents.register({
  name: "order-processor",
  type: "autonomous",
  scopes: ["receipts:write", "attestations:read"],
  metadata: {
    framework: "langchain",
    model: "gpt-4o",
    owner: "platform-team",
  },
});
```

### 2. Crear una sesión

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/agent-sessions \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "agent_id": "maip-agent:01JXXXX",
    "scopes": ["receipts:write"],
    "ttl_seconds": 3600,
    "ip_allowlist": ["10.0.0.0/8"]
  }'
```

### 3. Ejecutar con puntuación de confianza

Cada acción que realiza el agente se registra y se puntúa. La puntuación de confianza se actualiza continuamente:

```bash theme={null}
# Check current trust score
curl https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX \
  -H "X-API-Key: $API_KEY"
```

Respuesta:

```json theme={null}
{
  "agent_id": "maip-agent:01JXXXX",
  "score": 87,
  "factors": {
    "behavioral_compliance": 92,
    "scope_adherence": 95,
    "anomaly_score": 12,
    "peer_attestations": 78
  },
  "trend": "stable",
  "computed_at": "2026-04-06T12:00:00Z"
}
```

### 4. Interruptor de emergencia

Revoque instantáneamente todo acceso de agente:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/agents/maip-agent:01JXXXX/kill \
  -H "X-API-Key: $API_KEY" \
  -d '{ "reason": "Anomalous behavior detected", "revoke_sessions": true }'
```

## Conceptos básicos

### Tipos de agente

| Tipo | Descripción | Caso de uso |
| - | - | - |
| `autonomous` | Toma de decisiones totalmente autónoma | Bots de trading, motores de flujo de trabajo |
| `supervised` | Requiere aprobación humana para acciones críticas | Moderación de contenido, cumplimiento |
| `delegated` | Actúa en nombre de otro agente o usuario | Cuentas de servicio, proxies |
| `system` | Agente a nivel de infraestructura | Monitoreo, comprobaciones de estado |

### Alcances

Los alcances siguen un patrón `resource:action`:

* `agents:read` / `agents:write` — Gestión de agentes
* `receipts:write` — Emitir recibos de acción
* `attestations:read` — Leer datos de atestación
* `trust-scores:read` — Acceder a puntuaciones de confianza
* `delegations:offer` / `delegations:accept` — Delegación entre inquilinos
* `compliance:write` — Ejecutar comprobaciones de cumplimiento
* `orchestrations:execute` — Ejecutar flujos de trabajo multiagente

### Componentes de la puntuación de confianza

| Factor | Peso | Descripción |
| - | - | - |
| Cumplimiento conductual | 35% | Acciones dentro del alcance declarado |
| Adherencia al alcance | 25% | Sin intentos de acceso fuera de alcance |
| Puntuación de anomalía | 20% | Desviación de patrones históricos |
| Atestaciones de pares | 10% | Otros agentes que avalan el comportamiento |
| Higiene de sesión | 10% | Creación/terminación de sesión adecuada |

## Facturación y cuotas

Las características de identidad de máquina se miden según su plan. Se rastrean cuatro contadores de uso de MAIP en cada ciclo de facturación:

| Métrica | Qué cuenta | Desarrollador | Negocio | Empresa |
| :- | :- | :- | :- | :- |
| `maip.agents` | Agentes de máquina registrados | 2 | 50 | Depende del plan |
| `maip.sessions` | Sesiones de agente creadas por mes | 100 | 10,000 | Depende del plan |
| `maip.trust_computes` | Cálculos de puntuación de confianza bajo demanda | 50 | 5,000 | Depende del plan |
| `maip.compliance_checks` | Solicitudes de verificación de cumplimiento | 10 | 500 | Depende del plan |

Supervise su consumo con la [API de uso](https://docs.truthlocks.com/es/api-reference/billing/usage.md) o en la consola en **Configuración > Facturación > Uso** en la sección **MAIP**.

> [!NOTE]
>
> Consulte la [descripción general de facturación](https://docs.truthlocks.com/es/billing/overview.md#metered-products) para obtener la lista completa de 16 productos medidos. Actualice su plan en [console.truthlocks.com/billing](https://console.truthlocks.com/billing) para aumentar los límites.

## Integraciones de editor y pipeline

MAIP se integra con las herramientas que su equipo ya utiliza. Cada integración genera recibos criptográficos automáticamente.

| Categoría | Integraciones |
| :- | :- |
| **Plugins de editor** | [VS Code](https://docs.truthlocks.com/es/guides/maip-integrations.md#vs-code-extension), [JetBrains](https://docs.truthlocks.com/es/guides/maip-integrations.md#jetbrains-plugin), [Neovim](https://docs.truthlocks.com/es/guides/maip-integrations.md#neovim-plugin) (Telescope, statusline, auto-receipt al guardar) |
| **Asistentes de IA** | [MCP Server](https://docs.truthlocks.com/es/guides/maip-integrations.md#mcp-server) — 20 herramientas para asistentes de codificación de IA para consultar agentes, recibos y puntuaciones de confianza |
| **Pipelines de datos** | [Librería de flujo de eventos y conector Kafka](https://docs.truthlocks.com/es/guides/maip-integrations.md#event-streaming) — los adaptadores de proveedor requieren clientes concretos; la pasarela independiente no está lista |
| **CI/CD** | [GitHub Action](https://docs.truthlocks.com/es/guides/maip-integrations.md#github-action) — recibos para commits, PRs, releases y artefactos de construcción |
| **Marcos de IA** | LangChain, LlamaIndex, CrewAI, AutoGen, OpenAI, Anthropic, AWS Bedrock |
| **Herramientas de equipo** | Slack, Linear, Notion |

Consulte la [guía de integraciones de MAIP](https://docs.truthlocks.com/es/guides/maip-integrations.md) para obtener instrucciones de configuración y ejemplos de código.

## Próximos pasos

> [card] [Autorización del agente](https://docs.truthlocks.com/guides/agent-authorization.md)
>
> Profundice en la autorización basada en el alcance y la gestión de sesiones.

> [card] [Políticas MAIP](https://docs.truthlocks.com/guides/maip-policies.md)
>
> Reglas de aplicación en tiempo de ejecución basadas en puntuaciones de confianza, alcances y profundidad de delegación.

> [card] [Puntuaciones de confianza](https://docs.truthlocks.com/guides/trust-scores.md)
>
> Comprensión y configuración de la evaluación continua de la confianza.

> [card] [Delegación entre inquilinos](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Permitir que los agentes operen a través de los límites organizacionales.

> [card] [Orquestación de IA](https://docs.truthlocks.com/guides/ai-orchestration.md)
>
> Ejecución de flujo de trabajo multiagente con barandales de seguridad.

> [card] [Integraciones MAIP](https://docs.truthlocks.com/guides/maip-integrations.md)
>
> Conecte agentes a Slack, GitHub, VS Code, Neovim, LangChain y más.


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