Manual de Incorporación de Agentes de OpenAI

Propósito

Este manual es la ruta de incorporación prioritaria en corrección para nuevos equipos que utilizan OpenAI Agents con Decision Gate.

La preparación se basa en la corrección determinista y la validez del artefacto, no en el tiempo calendario transcurrido.

Entradas Canónicas

• Contrato de protocolo: guía nativa de LLM
• Paquete de fixture de incorporación: examples/agentic/onboarding/basic
• Corredor de extremo a extremo: examples/frameworks/openai_agents_live_loop.py

Flujo de extremo a extremo

1. Capability discovery:
   • decision_gate_providers_list
   • decision_gate_provider_contract_get
   • decision_gate_provider_check_schema_get
2. Authoring artifacts:
   • reclamar_inventario
   • matriz_de_capacidades
   • claim_condition_map
3. Fast loop:
   • decision_gate_schemas_register
   • decision_gate_precheck
4. Live boundary:
   • decisión_puerta_escenario_definir
   • decision_gate_scenario_start
   • decision_gate_scenario_next
5. Verification:
   • decision_gate_runpack_export
   • decision_gate_runpack_verify

Libro de ejecución

1. Iniciar el punto final Decision Gate MCP.
2. Asegúrate de que las dependencias del adaptador de OpenAI Agents estén instaladas.
3. Ejecuta el bucle de incorporación:

python3 examples/frameworks/openai_agents_live_loop.py \
  --fixture-dir examples/agentic/onboarding/basic

4. Inspeccionar el JSON de salida en busca de artefactos requeridos y estado de verificación.

Aceptación de Corrección

La incorporación se completa solo si todas las verificaciones pasan:

1. Required artifacts are present and structurally valid:
   • reclamar_inventario
   • matriz_de_capacidades
   • claim_condition_map
   • veredicto_de_ejecución
2. El resultado de límite en vivo es un estado de pase permitido para su política de límite.
3. runpack_verify.status es pass.
4. Los escenarios de bloqueo emiten razones de bloqueo explícitas.

Taxonomía de Fallos

Clasificar fallos en grupos deterministas:

• capability_mismatch
• incompatibilidad_de_esquema
• desajuste_de_comparador_o_tipo
• requisito_de_carril_no_cumplido
• verificación_de_runpack_fallida

No utilice un bucket unknown no clasificado para decisiones de lanzamiento.