Manual d'Integració d'Agents d'OpenAI

Estat de forma permanent

Els comandos a continuació només exerceixen contractes generats actualment. No exerceixen el model de condició i evidència permanent PF-01/PF-02, i els artefactes resultants no poden establir suport per al perfil inicial ni preparar el llançament. El contracte LLM permanent està documentat a llm_native_playbook.md; les seves projeccions executables romanen treball PF-09.

Propòsit

Aquest manual és el camí d’integració amb prioritat en la correcció per a nous equips que utilitzen OpenAI Agents amb Decision Gate.

La preparació de l’harnès d’integració es basa en les seves comprovacions deterministes nomenades i la validesa dels artefactes, no en el temps de calendari transcorregut. Aprovar aquest manual no qualifica un perfil de desplegament en producció ni tanca les llacunes de compromís distribuït, residència o entrega d’efectes del Decision Gate.

Entrades Canòniques

• Contracte de protocol: Docs/guides/llm_native_playbook.md
• Paquet d’instal·lació d’Onboarding: examples/agentic/onboarding/basic
• Referència del cicle de vida: examples/python/basic_lifecycle.py
• Evidència del sistema: system-tests/src/suites/monotone_dag.rs

Flux de principi a fi

1. Descobriment de capacitats:
   • llegir els recursos d’eina/esquema generats;
   • inspeccionar les autoritats d’adquisició local configurades exactament;
   • no inferir la capacitat de xarxa/proveïdor no disponible a partir del transport MCP.
2. Artefactes d’autoria:
   • claim_inventory
   • capability_matrix
   • claim_condition_map
3. Bucle ràpid:
   • decision_gate_schemas_register
   • decision_gate_scenario_precheck_stage
4. Límit en viu:
   • decision_gate_scenario_define
   • decision_gate_scenario_start
   • decision_gate_scenario_open_stage
   • decision_gate_scenario_evaluate_stage
5. Verificació:
   • decision_gate_runpack_export
   • decision_gate_runpack_verify

Runbook

1. Iniciar el punt d’entrada Decision Gate MCP.
2. Assegureu-vos que les dependències de l’adaptador d’Agents d’OpenAI estiguin instal·lades.
3. Executa el cicle d’integració:

bash scripts/adapters/adapter_tests.sh --frameworks=openai_agents --validate

4. Inspeccioneu el JSON de sortida per a artefactes requerits i l’estat de verificació.

Acceptació de la Correcció

Aquest exercici d’integració està complet només si totes les comprovacions passen:

1. Els artefactes obligatoris són presents i estructuralment vàlids:
   • claim_inventory
   • capability_matrix
   • claim_condition_map
   • enforcement_verdict
2. El run exactament limitat arriba a l’estat acceptat completed.
3. runpack_verify.status és passed.
4. Els escenaris de bloqueig emeten raons de bloqueig explícites.

El resultat públic de runpack_verify torna a validar la llei del escenari i l’evidència reconstituïble retinguda a través de constructors hostils abans de reproduir la història acceptada. No prova per si mateix fets de font no retinguts, compromís distribuït, entrega, vinculació externa o no-repudiació.

Taxonomia de Fallades

Classifiqueu les fallades en cubs deterministes:

• capability_mismatch
• schema_mismatch
• comparator_or_type_mismatch
• evidence_policy_unsatisfied
• runpack_verify_failed

No utilitzeu un contenidor unknown no classificat per a les decisions de llançament.