KAgent OpenAI Agents SDK Integration

OpenAI Agents SDK integration for KAgent with A2A (Agent-to-Agent) protocol support, session management, and optional skills integration.

Quick Start

from kagent.openai import KAgentApp
from agents.agent import Agent

# Create your OpenAI agent
agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
    tools=[my_tool],  # Optional
)

# Create KAgent app
app = KAgentApp(
    agent=agent,
    agent_card={
        "name": "my-openai-agent",
        "description": "My OpenAI agent",
        "version": "0.1.0",
        "capabilities": {"streaming": True},
        "defaultInputModes": ["text"],
        "defaultOutputModes": ["text"]
    },
    kagent_url="http://localhost:8083",
    app_name="my-agent"
)

# Run
fastapi_app = app.build()
# uvicorn run_me:fastapi_app

Agent with Skills

Skills provide domain expertise through filesystem-based instruction files and helper tools (read/write/edit files, bash execution). We provide a function to load all skill-related tools. Otherwise, you can select the ones you need by importing from kagent.openai.tools.

from agents.agent import Agent
from kagent.openai import get_skill_tools

tools = [my_custom_tool]
tools.extend(get_skill_tools("./skills"))

agent = Agent(
    name="SkillfulAgent",
    instructions="Use skills and tools when appropriate.",
    tools=tools,
)

See skills README for skill format and structure.

Session Management

Sessions persist conversation history in KAgent backend:

from agents.agent import Agent
from agents.run import Runner
from kagent.openai._session_service import KAgentSession
import httpx

client = httpx.AsyncClient(base_url="http://localhost:8083")
session = KAgentSession(
    session_id="conversation_123",
    client=client,
    app_name="my-agent",
)

agent = Agent(name="Assistant", instructions="Be helpful")
result = await Runner.run(agent, "Hello!", session=session)

Local Development

Test without KAgent backend using in-memory mode:

app = KAgentApp(
    agent=agent,
    agent_card=agent_card,
    kagent_url="http://localhost:8083",
    app_name="test-agent"
)

fastapi_app = app.build_local()  # In-memory, no persistence

Deployment

Standard Docker deployment:

FROM python:3.13-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY agent.py .
CMD ["uvicorn", "agent:fastapi_app", "--host", "0.0.0.0", "--port", "8000"]

Set KAGENT_API_URL and KAGENT_GATEWAY_URL to connect to kagent.

Architecture

Component	Purpose
KAgentApp	FastAPI application builder with A2A support
KAgentSession	Session persistence via KAgent REST API
OpenAIAgentExecutor	Executes agents with event streaming

Environment Variables

KAGENT_API_URL - KAgent control-plane API URL
KAGENT_GATEWAY_URL - KAgent A2A and MCP gateway URL
KAGENT_LOG_LEVEL - Logging level (default: INFO)

Examples

See samples/openai/ for complete examples:

basic_agent/ - Simple agent with custom tools
More examples coming soon

License

See repository LICENSE file.

Metadata

Release files for kagent-openai 1.0.0a5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kagent-openai 1.0.0a5
File	Size	Uploaded
kagent_openai-1.0.0a5.tar.gz	15.2 kB	Sep 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kagent-openai 1.0.0a5
File	Interpreter	ABI	Platform	Reset
kagent_openai-1.0.0a5-py3-none-any.whl 14.0 kB Sep 27, 2026	Python 3	none	any	Details

Total release size: 29.2 kB

Release files / kagent_openai-1.0.0a5.tar.gz

Download URL	kagent_openai-1.0.0a5.tar.gz
Size	15.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`450baf9d18f56b506595f0b53f8a536ca9028d3499d8bc4d1d518fce4ef7588f`
BLAKE2b-256 checksum How to use checksums	`ac8b097472a26513ae49d0869e1f1044cdac3e479cec4e00c90cc43fe0a50c41`
Upload date	Sep 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / kagent_openai-1.0.0a5-py3-none-any.whl

Download URL	kagent_openai-1.0.0a5-py3-none-any.whl
Size	14.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0d9a32d366a419eac599814be7034cb42ffd779370a67684a7fde438f9f59f6f`
BLAKE2b-256 checksum How to use checksums	`eb63cdfd988f1e570e5c60927a908a2d7d1cbd5e9bd3a0df123b667e96d62fc9`
Upload date	Sep 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`