Governed agents, any runtime

K9-AIF Framework, K9X Ecosystem and OpenAI Agents SDK in Collaboration

An OpenAI agent finds the weather for a US zip code. K9-AIF governs every step it takes: who may ask, what reaches the model, each tool call and result, every reply, and which model does the thinking.

Demo login demo / demo · your session is private to you
OpenAI Agents SDK

Runs the agent

A well-made library for agent loops. From its documentation:

  • Agent loop calls the model, runs tools, repeats until done
  • Handoffs one agent delegates to a specialist
  • Guardrails on input, output and tools, per application
  • Approvals pause a run for a decision, then resume
  • Tracing every run, with pluggable processors
  • Any compatible model OpenAI's, or an OpenAI-compatible endpoint
+
K9-AIF Framework · K9X Ecosystem

Governs every step

One configuration that holds for every agent on every runtime:

  • k9x Shield on the request, each tool call and result, every reply
  • Zero Trust for the caller and for each agent that takes a turn
  • K9 Model Router picks each model, eligibility first
  • Agents in K9-AIF YAML declared, not coded; unknown tools fail at start-up
  • Sole broker the adapter builds every agent and tool itself
  • One layer, every runtime CrewAI, LangGraph, Claude Agent SDK, and now OpenAI
The path

Where every check happens

The adapter is a K9-AIF orchestrator wrapped around the SDK. Each numbered gate is a K9-AIF checkpoint on a real crossing.

k9x Shield + Zero Trust: every crossing is a checkpoint Visitor zip code · role K9-AIF orchestrator adapter OpenAIAgentsOrchestratorAdapter Answer + receipt every check, in order OpenAI Agents SDK Runner · WeatherAgent (YAML) K9 Model Router eligibility first · tool_calling lookup_zip zip → place current_weather zip → conditions Local model OpenAI-compatible API Public services zippopotam · open-meteo request 1 run() 2 every model call 4 tool call 5 tool result 6 reply → final answer 7 3
K9-AIF OpenAI Agents SDK Models Tools Checkpoint
How it works

Four moves, every one checked

The SDK does the work. K9-AIF decides at each crossing.

1
Admit Zero Trust checks the caller's role; Shield screens the request before the SDK starts.
›
2
Run The Runner starts WeatherAgent, built from YAML; Zero Trust checks the agent too.
›
3
Think and act The Model Router picks a tool-calling model; each tool call and result passes Shield.
›
4
Answer Every reply and the final answer pass Shield; you get the answer and its receipt.
See a run

One real request, and what to try

Recorded with ./run.sh --demo against a local model. In the demo, every request shows a receipt like this.

zip 30301 · role customerrecorded run
✓Zero Trustweather.lookup allowed
✓Shield ingressrequest checks passed
✓Zero Trustopenai_agent:WeatherAgent
·Model Routerweather → local_tools
✓Shield tool callcurrent_weather
✓Shield tool resultcurrent_weather
✓Shield replyreply text checked
✓Shield egressfinal answer
Atlanta, GA: 40.9°F, clear sky, wind 4.2 mph, humidity 67%.
A normal zip codeThe weather, with every check that ran.
A guest callerZero Trust refuses before any agent runs.
A prompt injectionShield refuses it before the SDK starts.
A poisoned upstream responseThe tool result is withheld; the model never reads it.

Built on the K9-AIF framework

The adapter is one more orchestrator. It extends the same BaseOrchestrator contract as every K9-AIF orchestrator, so the Router sends it work like any other. On this path the SDK's Runner and agent take the place of Squad and Agent, while Shield, Zero Trust and the Model Router stay shared with every other path.

The K9X ecosystem brings the framework to life: K9X SATAN fires attacks at Shield to prove it holds, K9X HIL handles human decisions, K9X Studio builds K9-AIF applications visually, and DAS is a full reference application.

Scope

What this demo is

US zip codesCurrent weather from two free public services.
One local GPURequests are queued and limited per visitor.
Role on the pageShows Zero Trust; real deployments take it from sign-in.
Private to youNothing you send or receive is stored or shared.
The adapterOn K9-AIF main now; on PyPI from 1.27.0.