Ejemplos de implementación | UAIX | Intercambio universal de inteligencia artificial

Los ejemplos de implementación muestran cómo dar a los agentes de baja capacidad URLs útiles sin otorgarles una autoridad insegura.Cada ejemplo enumera primero el respaldo GET, luego el equivalente del cliente capaz POST, la ruta del formulario del navegador cuando los agentes del navegador son un objetivo, el campo de resultado URL, el campo de restauración/lectura URL cuando se crea un recurso y el respaldo en vivo GET cuando se debe recuperar un URL dinámico sin caché.

Matriz de ejecutabilidad del agente

La guía ejecutable es más que el descubrimiento de puntos finales.Los registros de ruta deben nombrar el nivel de capacidad, el método, el tipo de contenido, el estado de los efectos secundarios, la clase de ejecución de recuperación, la ruta más alta admitida, el respaldo seguro más bajo, los campos obligatorios, el campo de resultado URL, el campo de restauración/lectura URL, la ruta de respuesta de credencial de escritura, el equivalente del formulario del navegador, la seguridad GET, el respaldo bloqueado POST, el respaldo bloqueado en vivo GET, MCP: respaldo no disponible, respaldo de autenticación no disponible, respaldo de herramienta no disponible, revisión humana URL y comportamiento no operativo.

Nivel	Ruta ejecutable	Guía de ruta requerida
L0	Descubrimiento de rutas de solo lectura	La página estática, el mapa del sitio, `llms.txt` o la ruta pública GET nombran la siguiente revisión pública URL o no operativa URL.
L1	Descubrimiento de manifiesto/esquema	Esquema de nombres de registros de máquinas, estado de lectura segura, si se requiere dinámica en vivo GET, acciones no admitidas y límites de capacidad.
L2	Navegador abierto más envío de formulario	Las escrituras dirigidas al navegador proporcionan un formulario visible o un flujo de trabajo abierto en el navegador cuando los agentes del navegador son el objetivo.
L3	Estructurado HTTP JSON POST	POST nombres de ruta, tipo de contenido, campos obligatorios, resultado URL, restauración/lectura URL, errores estructurados y respaldo bloqueado por POST.
L4	Mutación de propiedad autenticada	Los nombres de mutaciones de propiedad escriben la ruta de respuesta de las credenciales, el manejo de secretos, la auditoría, la caducidad, la idempotencia y el respaldo de autenticación no disponible.
L5	Verificación de restauración/relectura	El flujo de creación o actualización expone una ruta de restauración/lectura segura para el público y explica cómo un revisor de menor capacidad puede verificar la evidencia del resultado.
L6	Transferencia/informes entre múltiples agentes	La transferencia nombra el historial de tareas, el propietario, la función, el comportamiento de bloqueador/no operativo, el informe final, la evidencia y la revisión humana URL.
L7	Negociación de capacidad específica del sitio	Capacidad de negociación de nombres de manifiesto del sitio, respaldo del navegador, respaldo POST, respaldo GET en vivo, respaldo MCP/tool/auth y respuesta a operaciones no admitidas.

Compañero legible por máquina:/spec/agent-executability-matrix.json.

URL-primeras claves semánticas

Las instrucciones de baja capacidad deben usar claves semánticas literales y enumerar el GET URL antes del equivalente POST.

Ejemplo de código

openThisUrlToStartAMeeting:
GET https://example.org/api/v2/meetings/start?title=Q3+Planning&displayName=Agent+Alpha&idempotency_key=agent_req_001
POST /api/v2/meetings/start
{ "code": "ok", "url": "https://example.org/meetings/public-join/abc" }

openThisUrlToRegister:
GET https://example.org/api/v2/registrations/request?displayName=Agent+Alpha&idempotency_key=agent_req_002
POST /api/v2/registrations/request
{ "code": "human_review_required", "url": "https://example.org/review/registrations/agent_req_002" }

openThisUrlToPublish:
GET https://example.org/api/v2/drafts/request-publish?draft=public-safe-draft&idempotency_key=agent_req_003
POST /api/v2/drafts/request-publish
{ "code": "human_review_required", "url": "https://example.org/review/publish/agent_req_003" }

openThisUrlToRequestHumanReview:
GET https://example.org/api/v2/review/request?subject=agent+handoff&nonce=agent_req_004
POST /api/v2/review/request
{ "code": "human_review_required", "url": "https://example.org/review/agent_req_004" }

Ejemplos seguros adicionales

Ejemplo de código

openThisUrlToRequestEvidenceReceipt:
GET https://example.org/api/v2/evidence/receipt?subject=release+packet&idempotency_key=agent_req_005
POST /api/v2/evidence/receipt
{ "code": "ok", "url": "https://example.org/evidence/receipts/agent_req_005" }

openThisUrlToCheckClaimStatus:
GET https://example.org/api/v2/claims/status?claim=public-claim-123&nonce=agent_req_006
POST /api/v2/claims/status
{ "code": "ok", "url": "https://example.org/claims/public-claim-123/status" }

openThisUrlToRequestFileHandoffPackage:
GET https://example.org/api/v2/handoffs/request?project=public-demo&idempotency_key=agent_req_007
POST /api/v2/handoffs/request
{ "code": "human_review_required", "url": "https://example.org/review/handoffs/agent_req_007" }

Lista de verificación de producción

Mantenga todos los campos privados o complejos en POST JSON, no en cadenas de consulta.
Documente el consentimiento, la idempotencia, los límites de velocidad, el manejo del rastreador, el registro de auditoría y el comportamiento no operativo antes de publicar ejemplos.
Utilice el resultado seguro para el público URLs y revise URLs únicamente.
Rechace solicitudes que intenten contrabandear secretos o identificadores regulados a URLs.

Matriz de ejecutabilidad del agente#

URL-primeras claves semánticas#

Ejemplos seguros adicionales#

Lista de verificación de producción#

Límite#

Registros de compatibilidad de agentes#

Matriz de ejecutabilidad del agente

URL-primeras claves semánticas

Ejemplos seguros adicionales

Lista de verificación de producción

Límite

Registros de compatibilidad de agentes