Signaler une anomalie
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
}Conformité et anomalies
Signaler une anomalie
Signaler une anomalie comportementale détectée dans l’activité d’un agent IA.
POST
/
v1
/
agents
/
{agentId}
/
anomalies
Signaler une anomalie
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
}Signale une anomalie comportementale détectée dans l’activité d’un agent IA. Les anomalies sont des observations signalées qui indiquent qu’un agent pourrait opérer en dehors de son enveloppe comportementale attendue — telles que des pics de taux soudains, des violations de portée, des baisses de score de confiance ou des anomalies d’accès géographique.
Les rapports d’anomalies créent des alertes exploitables pour les équipes de sécurité et peuvent déclencher des politiques de réponse automatisées (par exemple, limitation, révocation de session ou suspension d’agent) en fonction de la gravité et de la configuration du locataire.
Types d’anomalies
| Type | Description |
|---|---|
rate_spike | Le taux de requêtes de l’agent dépasse significativement la ligne de base historique |
scope_violation | L’agent a tenté d’accéder à une ressource en dehors de ses portées autorisées |
trust_drop | Le score de confiance calculé de l’agent est tombé sous le seuil |
pattern_deviation | Le comportement de l’agent s’écarte de sa ligne de base entraînée |
geographic_anomaly | Agent accédé depuis un emplacement géographique ou une plage d’adresses IP inattendus |
Niveaux de gravité
| Gravité | SLA | Réponse automatique |
|---|---|---|
low | Examen de 24h | Seulement enregistré |
medium | Examen de 4h | Agent ralenti |
high | Examen d’1h | Sessions suspendues |
critical | Examen de 15 min | Agent révoqué en attente d’enquête |
Réponse
Action de réponse automatisée prise (le cas échéant), basée sur la gravité et la politique du locataire.
Corps
application/json
Réponse
Anomalie signalée

