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.agent._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_URL environment variable to connect to KAgent backend.
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_URL- KAgent backend URL (default: http://localhost:8083)LOG_LEVEL- Logging level (default: INFO)
Examples
See samples/openai/ for complete examples:
basic_agent/- Simple agent with custom tools- More examples coming soon
See Also
License
See repository LICENSE file.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kagent_openai-0.9.12.tar.gz.
File metadata
- Download URL: kagent_openai-0.9.12.tar.gz
- Upload date:
- Size: 15.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9dad06c610673cf6b0a8f20cd7c479bdd3b75bf4caaed46dbd96af1609a2ee35
|
|
| MD5 |
823bcb780ecc45c3c1fa60f07736d3bc
|
|
| BLAKE2b-256 |
cea02d1959dbc4b94d9ca3e1ba0e572be083f0d9b71db162216401d2c044358b
|
File details
Details for the file kagent_openai-0.9.12-py3-none-any.whl.
File metadata
- Download URL: kagent_openai-0.9.12-py3-none-any.whl
- Upload date:
- Size: 16.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc3881086062ed2aa9034f554f99b8edb0619ba80ec614b4c8d951f94be2869c
|
|
| MD5 |
e259b0cde5862d4f6fa51623f1f86f86
|
|
| BLAKE2b-256 |
6adf1d8a3a0aa9f136de74c515977305569ccf07348bddb331dcededeebc4324
|
