Skip to content
K-AgentK-Agent Docs

Changelog

View as Markdown

v1.0 — 2026-10-06

Section titled “v1.0 — 2026-10-06”

The first release of K-Agent: one agent, use it anywhere. API version 2026-10-06.

Use your agent anywhere

Section titled “Use your agent anywhere”
  • One-shot answers with POST /v1/agents/{agent}/ask, including caller-supplied history, per-request overrides, a private store: false mode and opt-in actions.
  • Chat sessions with platform sess_ IDs or your own external_id, get-or-create, addressable by either ID everywhere — the published session ID contract.
  • Streaming over Server-Sent Events, resumable with Last-Event-ID, with authoritative *.completed events.
  • Concurrency policies per session: queue, reject and interrupt.
  • OpenAI-compatible endpoint at /openai/v1/chat/completions, with the agent slug as the model, optional sessions and a kagent extension.
  • Web widget (<k-agent-chat>) with publishable keys, allowed origins, anonymous visitors and verified users via client tokens.

Configure once, see everything

Section titled “Configure once, see everything”
  • One configuration document covering identity, Arabic dialect and tone, instructions, knowledge, tools, guardrails, handoff, business hours, conversation, model, variables, overrides, fallback and widget — always returned complete.
  • Drafts and versions: auto-published v1, If-Match editing with JSON merge patch, publish, restore, diff, export and import, config_hash on every run.
  • Prompt X-ray (prompt_preview) showing every block with its source, version and tokens.
  • Readiness with explicit blockers, and pause switches ai_paused and actions_paused.
  • Starter templates: customer support, sales questions, booking assistant and internal FAQ.

Safety in code

Section titled “Safety in code”
  • The never-handle list, on by default and placed last in the prompt.
  • The verbatim escalation reply for liability handoffs, in Arabic and English.
  • Truthful handoff results (queued, recorded, recorded_closed, already, failed) and the never-silent rule with retries, fallback models and a fallback message.
  • Sliding handoff expiry, technical handoffs that don’t mute the conversation, and the Handoff Desk with claim, reply, internal notes, release, close and take-over.

Tools and knowledge

Section titled “Tools and knowledge”
  • Built-in tools: transfer_to_human, create_ticket, flag_conversation and search_knowledge.
  • HTTP tools with fail-closed templating, secrets with allowed hosts, identity from verified end users, response projection, a live test endpoint and signed outbound calls.
  • Client tools with requires_action and submit_tool_outputs.
  • Knowledge sources (text, catalog, api) in always or searchable mode, with Arabic-aware search and scheduled API refresh that keeps the last good copy.
  • A protected network client for every URL you configure.

Platform

Section titled “Platform”
  • Secret keys with scopes and agent restrictions, publishable keys, client tokens, and team roles (owner, admin, developer, editor, support, viewer).
  • Standard Webhooks with retries, a delivery log and test events; an event log at /v1/events.
  • The AI conversation billing unit with model weights, quotas and alerts, and the usage API.
  • Bring your own model key (OpenAI, Anthropic, DeepSeek or any OpenAI-compatible provider), checked live.
  • Audit log, end-user erasure and retention settings.
  • Bilingual docs in Arabic and English, an interactive API reference, llms.txt and a Markdown version of every page.