Enregistrer l'agent
curl --request POST \
--url https://api.truthlocks.com/v1/agents \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({display_name: '<string>'})
};
fetch('https://api.truthlocks.com/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/agents"
payload = { "display_name": "<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"
payload := strings.NewReader("{\n \"display_name\": \"<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))
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_type": "orchestrator",
"display_name": "<string>",
"description": "<string>",
"status": "active",
"scopes": [
"<string>"
],
"metadata": {},
"trust_score": 0.5,
"public_key": "<string>",
"session_count": 123,
"keys": [
{
"kid": "<string>",
"algorithm": "<string>",
"public_key": "<string>",
"status": "active"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_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
}Agents machine
Enregistrer l'agent
Enregistrer une nouvelle identité d’agent machine avec une paire de clés cryptographiques et des permissions délimitées
POST
/
v1
/
agents
Enregistrer l'agent
curl --request POST \
--url https://api.truthlocks.com/v1/agents \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({display_name: '<string>'})
};
fetch('https://api.truthlocks.com/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/agents"
payload = { "display_name": "<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"
payload := strings.NewReader("{\n \"display_name\": \"<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))
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_type": "orchestrator",
"display_name": "<string>",
"description": "<string>",
"status": "active",
"scopes": [
"<string>"
],
"metadata": {},
"trust_score": 0.5,
"public_key": "<string>",
"session_count": 123,
"keys": [
{
"kid": "<string>",
"algorithm": "<string>",
"public_key": "<string>",
"status": "active"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_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
}Enregistrer un agent
POST /v1/agents
Enregistre une nouvelle identité d’agent machine pour le locataire authentifié. La plateforme génère une paire de clés Ed25519 pour l’agent, attribue un ID d’agent conforme à MAIP et enregistre la clé initiale dans le registre de l’historique des clés. Les agents nouvellement enregistrés commencent avec le statut active et un score de confiance initial de 0.500.
Le nombre d’agents que vous pouvez enregistrer dépend de votre plan de facturation. Si vous
dépassent la limite de votre plan, l’API renvoie
402 Payment Required. Contactez les ventes
pour les limites d’agents de niveau entreprise.Authentification
Nécessite l’en-têteX-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.
Réponse
Identifiant d’agent conforme à MAIP au format
maip:<tenant8>:<ulid>. Utilisez cette valeur
dans tous les appels API ultérieurs faisant référence à cet agent.Niveau de confiance initial. Les agents nouvellement enregistrés commencent à
"authenticated".Score de confiance numérique (0,0 à 1,0). Les agents nouvellement enregistrés commencent à
0.500.Clé publique Ed25519 encodée en Base64url générée pour cet agent. Stockez ceci
en toute sécurité pour la vérification de la signature.
Identifiant unique de la clé de signature de l’agent. Référencé dans les reçus et
attestations.
Profondeur actuelle de la chaîne de délégation. Toujours
0 pour les agents directement enregistrés.
La profondeur maximale est de 8 par protocole MAIP.Exemple
curl -X POST https://api.truthlocks.com/v1/agents \
-H "X-API-Key: tl_live_..." \
-H "Content-Type: application/json" \
-d '{
"agent_type": "llm",
"display_name": "Customer Support Bot",
"description": "Handles Tier-1 customer support inquiries via chat",
"scopes": ["data:read", "tool:search.web", "!data:delete"],
"metadata": {
"team": "support",
"model": "claude-3.5-sonnet",
"environment": "production"
}
}'
Corps
application/json
Réponse
Agent enregistré

