Ejemplos OKF - Biblioteca de Open Knowledge Format

Ejemplos OKF

Copia ejemplos prácticos de Open Knowledge Format para APIs, datasets, métricas, runbooks y documentación de producto.

Desarrolladores que buscan ejemplos OKF de API.

Ejemplo OKF de endpoint de API

Página de referencia de un endpoint para documentación de API legible por agentes.

---
type: api_reference
id: api-endpoint
title: "API Endpoint OKF Example"
description: "A single endpoint reference page for agent-readable API documentation."
tags: [api, openapi, reference]
---

# Create Customer Endpoint

Creates a customer record and returns the canonical customer ID.

## Request

POST /v1/customers

Required JSON fields:

- email: customer email address
- name: display name

## Response

Returns 201 with id, email, name, and created_at.

Abrir página dedicada

Equipos de datos que documentan catálogos para agentes.

Ejemplo OKF de dataset

Entrada de dataset con propiedad, notas de esquema y cadencia de actualización.

---
type: dataset
id: dataset
title: "Dataset OKF Example"
description: "A dataset entry with ownership, schema notes, and update cadence."
tags: [dataset, catalog, analytics]
---

# Revenue Events Dataset

Revenue Events stores normalized billing events used by finance dashboards and forecasting jobs.

## Owner

Data Platform team.

## Freshness

Updated hourly from the billing warehouse.

## Fields

- event_id: stable event identifier
- account_id: customer account identifier
- amount_usd: normalized revenue amount
- occurred_at: event timestamp

Abrir página dedicada

Equipos de análisis que estandarizan definiciones de métricas legibles por AI.

Ejemplo OKF de métrica

Definición de métrica con fórmula, advertencias y uso de negocio.

---
type: metric
id: metric
title: "Metric OKF Example"
description: "A metric definition with formula, caveats, and business usage."
tags: [metric, analytics, semantic-layer]
---

# Net Revenue Retention

Net Revenue Retention measures expansion and contraction in existing customer revenue.

## Formula

(Starting MRR + Expansion MRR - Contraction MRR - Churned MRR) / Starting MRR

## Usage

Use NRR for cohort-level retention analysis and investor reporting.

## Caveats

Exclude trial accounts and one-time services revenue.

Abrir página dedicada

Equipos DevOps que convierten conocimiento operativo en OKF.

Ejemplo OKF de runbook

Runbook de incidente de producción formateado para flujos de agentes.

---
type: runbook
id: runbook
title: "Runbook OKF Example"
description: "A production incident runbook formatted for agent workflows."
tags: [runbook, incident, devops]
---

# API Latency Incident Runbook

Use this runbook when p95 API latency exceeds 900ms for more than five minutes.

## Triage

1. Check current deploy status.
2. Inspect database connection saturation.
3. Compare cache hit rate with the previous hour.

## Rollback

Rollback the latest deploy if latency rose within 15 minutes of release.

## Escalation

Page the platform owner when error rate exceeds 2%.

Abrir página dedicada

Equipos SaaS que publican documentación de producto legible por agentes.

Ejemplo OKF de documentación de producto

Página de capacidad de producto con alcance claro y guía de flujo de trabajo.

---
type: product_doc
id: product-docs
title: "Product Docs OKF Example"
description: "A product capability page with concise scope and workflow guidance."
tags: [product-docs, saas, support]
---

# Workspace Invitations

Workspace Invitations let administrators invite teammates by email and assign default roles.

## Availability

Available on Team and Enterprise plans.

## Workflow

1. Open Settings.
2. Select Members.
3. Enter email addresses.
4. Choose a role.
5. Send invitations.

## Permissions

Only owners and administrators can invite new members.

Abrir página dedicada

Herramientas y guías OKF relacionadas

Validador OKF Generador web a OKF Conversor OpenAPI a OKF OKF vs JSON-LD OKF vs OpenAPI

FAQ

¿Para qué sirven estos ejemplos OKF?

Dan a los desarrolladores un punto de partida listo para copiar para publicar archivos Markdown tipados y legibles por agentes.

¿Puedo editar el frontmatter?

Sí. Mantén type no vacío y añade campos como title, description, id, tags, source_url y owner cuando haga falta.

¿Cómo debo validar un archivo copiado?

Pégalo en el Validador OKF antes de publicarlo o confirmarlo en un paquete de conocimiento.