OpenAI Agents

pip install aira-sdk[openai-agents]

npm install aira-sdk
# peer dep
npm install @openai/agents

from aira import Aira
from aira.extras.openai_agents import AiraGuardrail
from agents import Agent, Runner, function_tool

aira = Aira(api_key="aira_live_...")
guardrail = AiraGuardrail(
    client=aira,
    agent_id="payments-agent",
    model_id="gpt-4o",
)

def send_wire_transfer_impl(amount: float, to: str) -> str:
    """Raw tool function — side-effect happens here."""
    return f"Wire sent: €{amount} to {to}"

# Wrap it — this is where authorize() runs
send_wire_transfer = function_tool(
    guardrail.wrap_tool(send_wire_transfer_impl, "send_wire_transfer")
)

agent = Agent(
    name="payments",
    instructions="You are a payments agent.",
    tools=[send_wire_transfer],
)

result = Runner.run_sync(agent, "Send €75,000 to vendor-x")

import { Aira } from "aira-sdk";
import { AiraGuardrail } from "aira-sdk/extras/openai-agents";
import { Agent, run } from "@openai/agents";

const aira = new Aira({ apiKey: "aira_live_..." });
const guardrail = new AiraGuardrail(aira, "payments-agent", {
  modelId: "gpt-4o",
  strict: false,
});

async function sendWireTransferImpl(args: { amount: number; to: string }) {
  return `Wire sent: €${args.amount} to ${args.to}`;
}

// wrapTool() returns the wrapped execute function
const sendWireTransfer = {
  name: "send_wire_transfer",
  description: "Send a wire transfer",
  parameters: {
    type: "object",
    properties: {
      amount: { type: "number" },
      to: { type: "string" },
    },
    required: ["amount", "to"],
  },
  execute: guardrail.wrapTool(sendWireTransferImpl, "send_wire_transfer"),
};

const agent = new Agent({
  name: "payments",
  instructions: "You are a payments agent.",
  tools: [sendWireTransfer],
});

const result = await run(agent, "Send €75,000 to vendor-x");