Reportar Anomalía
curl --request POST \
--url https://api.truthlocks.com/v1/agents/{agentId}/anomalies \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"anomaly_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({anomaly_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/agents/{agentId}/anomalies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload = { "anomaly_type": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload := strings.NewReader("{\n \"anomaly_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"anomaly_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"anomaly_type": "<string>",
"severity": "low",
"details": {},
"status": "open",
"resolution": "<string>",
"resolved_by": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Cumplimiento y anomalías
Reportar Anomalía
Reportar una anomalía de comportamiento detectada en la actividad de un agente de IA.
POST
/
v1
/
agents
/
{agentId}
/
anomalies
Reportar Anomalía
curl --request POST \
--url https://api.truthlocks.com/v1/agents/{agentId}/anomalies \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"anomaly_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({anomaly_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/agents/{agentId}/anomalies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload = { "anomaly_type": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload := strings.NewReader("{\n \"anomaly_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"anomaly_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"anomaly_type": "<string>",
"severity": "low",
"details": {},
"status": "open",
"resolution": "<string>",
"resolved_by": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Reporta una anomalía de comportamiento detectada en la actividad de un agente de IA. Las anomalías son observaciones marcadas que indican que un agente puede estar operando fuera de su envolvente de comportamiento esperado, como picos repentinos de velocidad, violaciones de alcance, caídas en la puntuación de confianza o anomalías de acceso geográfico.
Los informes de anomalías crean alertas procesables para los equipos de seguridad y pueden activar políticas de respuesta automatizadas (por ejemplo, limitación, revocación de sesión o suspensión de agentes) según la gravedad y la configuración del inquilino.
Tipos de anomalías
| Tipo | Descripción |
|---|---|
rate_spike | La tasa de solicitudes del agente supera significativamente la línea base histórica |
scope_violation | El agente intentó acceder a un recurso fuera de sus ámbitos concedidos |
trust_drop | La puntuación de confianza calculada del agente cayó por debajo del umbral |
pattern_deviation | El patrón de comportamiento del agente se desvía de su línea base entrenada |
geographic_anomaly | Agente accedido desde una ubicación geográfica o rango de IP inesperado |
Niveles de gravedad
| Gravedad | SLA | Respuesta automática |
|---|---|---|
low | Revisión de 24h | Solo registrado |
medium | Revisión de 4h | Agente limitado |
high | Revisión de 1h | Sesiones suspendidas |
critical | Revisión de 15min | Agente revocado pendiente de investigación |
Respuesta
Acción de respuesta automatizada tomada (si la hay), basada en la gravedad y la política del inquilino.
Cuerpo
application/json
Respuesta
Anomalía reportada

