Manual d’Integració d’Agents d’OpenAI

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ó es basa en la correcció determinista i la validesa de l’artifacte, no en el temps de calendari transcorregut.

Entrades Canòniques

• Protocol contract: LLM-native playbook
• Paquet d’instal·lació d’Onboarding: examples/agentic/onboarding/basic
• Corrent de principi a fi: examples/frameworks/openai_agents_live_loop.py

Flux de principi a fi

1. Capability discovery:
   • decision_gate_providers_list
   • contracte_proveïdor_decisió_porta_obtenir
   • decision_gate_provider_check_schema_get
2. Authoring artifacts:
   • reclamar_inventari
   • matriu_de_capacitats
   • mapa_condicions_reclamació
3. Fast loop:
   • decision_gate_schemas_register
   • decision_gate_precheck
4. Live boundary:
   • decisió_porta_escenari_definir
   • decisió_porta_escenari_inici
   • decision_gate_scenario_next
5. Verification:
   • 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ó:

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

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

Acceptació de la Correcció

La incorporació només es completa si totes les comprovacions passen:

1. Required artifacts are present and structurally valid:
   • reclamar_inventari
   • matriu_de_capacitats
   • mapa_condicions_reclamació
   • veredicte_d'aplicació
2. El resultat de límit en viu és un estat de passada permès per a la vostra política de límits.
3. runpack_verify.status és pass.
4. Els escenaris de bloqueig emeten raons de bloqueig explícites.

Taxonomia de Fallades

Classifiqueu les fallades en cubs deterministes:

• capability_mismatch
• schema_mismatch
• comparador_o_tipus_incompatible
• requisit_de_carril_no_complert
• runpack_verify_failed

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