ES
Documentación
Documentación/Crear y operar

API y agentes externos

Usa un contrato compartido de operaciones que respeta los permisos mediante HTTP, MCP o la CLI.

En esta página

Autentica una conexión

Crea una credencial de agente con permisos delimitados desde Roles y acceso, o completa el flujo OAuth habilitado en la instancia. La API HTTP de operaciones requiere un encabezado Authorization: Bearer; una sesión interactiva del navegador no basta para autorizar estos endpoints.

Configura NONDRO_URL con la URL base completa de tu instancia, incluido cualquier prefijo de montaje, y proporciona NONDRO_TOKEN mediante tu mecanismo de credenciales. Usa HTTPS fuera del desarrollo local. El endpoint MCP es esa misma URL base seguida de /mcp/, incluida la barra final.

Descubre operaciones y recupera contexto

GET /api/agent/tools devuelve los nombres y los esquemas de entrada de las operaciones disponibles para quien hace la solicitud. POST /api/agent/call/{operation} acepta un objeto arguments. Consulta ese catálogo antes de construir solicitudes: los permisos y las funciones habilitadas afectan el contrato disponible.

Las siguientes llamadas muestran las herramientas y recuperan un paquete de contexto limitado. Estas operaciones utilizan el servicio determinista compartido; no inician una conversación con el modelo de nondro.

bash
curl --fail-with-body \
  -H "Authorization: Bearer $NONDRO_TOKEN" \
  "$NONDRO_URL/api/agent/tools"

curl --fail-with-body \
  -H "Authorization: Bearer $NONDRO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"arguments":{"limit":10}}' \
  "$NONDRO_URL/api/agent/call/get_context"

Usa referencias exactas y resultados limitados

Busca registros del catálogo y luego utiliza los identificadores devueltos en read_definition o read_objects. Respeta las definiciones proyectadas o parciales: la creación mediante agentes admite los esquemas declarados de objetos y relaciones, no todas las capacidades interactivas del catálogo.

Sigue los cursores devueltos para recuperar más páginas. Los cursores están vinculados con la conexión, la solicitud y los permisos efectivos; los cambios pueden invalidarlos. Un paquete de contexto limitado no es una copia completa de toda la organización, y una búsqueda sin resultados visibles no demuestra que un registro no exista.

Modificaciones, reintentos y CLI

Las modificaciones requieren un idempotency_key. Si la respuesta es incierta, reintenta con la misma clave y argumentos idénticos. Usa una clave nueva para un nuevo cambio previsto. Las ediciones que dependen de una versión también requieren expected_version; una versión desactualizada debe revisarse en lugar de sobrescribirse.

Crear o validar un borrador no lo promueve. Las propuestas de acciones con gobierno requieren los permisos adecuados y una decisión humana. La CLI de nondro instalada utiliza el mismo contrato HTTP y las mismas variables de entorno.

bash
nondro agent tools
nondro agent context