Grafo de ejecución de un agente

GET/api/public/v1/agents/{agent_id}/execution-graph beta

The agent's window as a set-membership graph: runs, surfaces, tools, artifacts. The window is an explicit from/to range of any span (window.key is then custom) or the deprecated rolling window key; with neither, the last 7 days. from wins over window; to without from or from after to is a 422.

cURL

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/execution-graph' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/execution-graph',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

Bash

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/execution-graph' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

PowerShell

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/execution-graph' -Headers $headers | ConvertTo-Json -Depth 20

Autorización

Rol en la organización	Este punto de conexión
owner	Permitido
admin	Permitido
editor	Permitido
viewer	Permitido

Una clave tiene el rol que su propietario ocupa en la organización. Consulte Autenticación.

Ámbito de la clave de API: agents:read

Parámetros de ruta

Parámetro	Tipo	Descripción
agent_id	string	Obligatorio.

Parámetros de consulta

Parámetro	Tipo	Descripción
window	string — one of 24h, 7d, 30d	Deprecated: send from (and optionally to) instead. A rolling window ending now — 24h, 7d or 30d. Ignored when from is sent.
from	string (date-time) or null	Start of an explicit range (ISO 8601), any distance in the past. Wins over window. Snapped down to 10 seconds; the response's window.key is then custom.
to	string (date-time) or null	End of the explicit range (ISO 8601), exclusive. Requires from, must not be before it (equal bounds are an empty window); defaults to now and is clamped to it. Snapped down to 10 seconds like from.
expand	array of string — one of session, tool, artifact or null
session_page	integer or null
session_page_size	integer or null
tool_page	integer or null
tool_page_size	integer or null
artifact_page	integer or null
artifact_page_size	integer or null

Respuesta

• 200 OK — la llamada se completó correctamente.
• 401 Unauthorized — UNAUTHORIZED
• 402 Payment Required — license_expired
• 403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
• 404 Not Found — NOT_FOUND
• 422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
• 429 Too Many Requests — TOO_MANY_REQUESTS
• 500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
• 503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Campos de la respuesta

Campo	Tipo	Descripción
action_tables_available	boolean	Obligatorio.
agent	object	Obligatorio. The agent the graph belongs to — the existing `AgentRead` subset.
agent.agent_id	string	Obligatorio.
agent.display_name	string or null	Obligatorio.
agent.first_seen_at	string (date-time)	Obligatorio.
agent.latest_arch	string or null	Obligatorio.
agent.latest_os	string or null	Obligatorio.
agent.platform	string	Obligatorio.
baseline_suppressed	boolean	Obligatorio.
edges	array of object	Obligatorio.
edges[].id	string	Obligatorio.
edges[].session_ids	array of string	Obligatorio.
edges[].source	string	Obligatorio.
edges[].target	string	Obligatorio.
edges[].weight	number	Obligatorio.
layer_page	object	Obligatorio.
nodes	array of object	Obligatorio.
nodes[].baseline_coverage	number	Obligatorio.
nodes[].baseline_observations	integer	Obligatorio.
nodes[].confidence	string — one of high, medium, low	Obligatorio.
nodes[].coverage	number	Obligatorio.
nodes[].entity	object	Obligatorio.
nodes[].id	string	Obligatorio.
nodes[].label	string	Obligatorio.
nodes[].layer	string — one of agent, session, surface, tool, artifact	Obligatorio.
nodes[].metrics	object or null	Obligatorio.
nodes[].observations	integer	Obligatorio.
nodes[].session_ids	array of string	Obligatorio.
nodes[].tier	string — one of hot, warm, rare, novel, fading	Obligatorio.
totals	object	Obligatorio. Window-wide figures. Never page-scoped (D50).
totals.baseline_events	integer	Obligatorio.
totals.baseline_sessions	integer	Obligatorio.
totals.events	integer	Obligatorio.
totals.mean_run_cost_tokens	number or null	Obligatorio.
totals.sessions	integer	Obligatorio.
totals.toolless_sessions	integer	Obligatorio.
totals.unidentified_actions	integer	Obligatorio.
window	object	Obligatorio. `{key, from, to, as_of}`.
window.as_of	string (date-time)	Obligatorio.
window.from	string (date-time)	Obligatorio.
window.key	string	Obligatorio.
window.to	string (date-time)	Obligatorio.

Ejemplo de respuesta

{
  "action_tables_available": false,
  "agent": {
    "agent_id": "agt_01jbwa2k1vfrn9y42xhgxhmzj2",
    "display_name": "release-bot",
    "first_seen_at": "2026-01-15T14:32:05Z",
    "latest_arch": "string",
    "latest_os": "string",
    "platform": "string"
  },
  "baseline_suppressed": false,
  "edges": [
    {
      "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "session_ids": [
        "ses_01jbwa2k1vfrn9y42xhgxhmzj2"
      ],
      "source": "string",
      "target": "string",
      "weight": 0.25
    }
  ],
  "layer_page": {},
  "nodes": [
    {
      "baseline_coverage": 0.25,
      "baseline_observations": 3,
      "confidence": "high",
      "coverage": 0.25,
      "entity": {
        "distinct_artifacts": 3,
        "distinct_tools": 3,
        "layer": "agent"
      },
      "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "label": "string",
      "layer": "agent",
      "metrics": {
        "cost_tokens": 3,
        "cost_tokens_uncached": 3,
        "cost_usd": "string",
        "duration_ms": 3,
        "requirements": {
          "business_value": 0.25,
          "compliance": 0.25,
          "economics": 0.25,
          "security": 0.25
        },
        "session_duration_ms": 3,
        "verdicts": {
          "allow": 3,
          "ask": 3,
          "block": 3,
          "optimize": 0,
          "undecided": 3
        }
      },
      "observations": 3,
      "session_ids": [
        "ses_01jbwa2k1vfrn9y42xhgxhmzj2"
      ],
      "tier": "hot"
    }
  ],
  "totals": {
    "baseline_events": 3,
    "baseline_sessions": 3,
    "events": 3,
    "mean_run_cost_tokens": 0.25,
    "sessions": 3,
    "toolless_sessions": 3,
    "unidentified_actions": 3
  },
  "window": {
    "as_of": "2026-01-15T14:32:05Z",
    "from": "2026-01-15T14:32:05Z",
    "key": "string",
    "to": "2026-01-15T14:32:05Z"
  }
}

Véase también

• GET Listar los agentes conectados a la organización autenticada
• DELETE Eliminar un agente, con sus sesiones, eventos y estadísticas.
• GET Obtener un agente por su ID