Skip to content

AgentService

katanakit-js / AgentService

Defined in: core/services/agent.service.ts:258

AgentService - Singleton facade con Strategy Pattern.

Centraliza el registro del proveedor AI y el bucle de completions, delegando la llamada HTTP en una IAiProviderStrategy intercambiable. Por defecto usa OpenAiCompatibleStrategy.

// Configurar el proveedor
AgentService.getInstance().useInitAgent({ apiKey: process.env.DASHSCOPE_API_KEY });
// Cambiar de estrategia en runtime (p. ej. un mock en tests)
AgentService.getInstance().useSetStrategy(new OpenAiCompatibleStrategy());
useChat(messages, options?): Promise<AiResult<string>>;

Defined in: core/services/agent.service.ts:373

Sends a single chat completion and returns the assistant text as a Safe Result.

Use this for review / questioning (single-shot). For autonomous multi-step work with tools, use useRunAgent.

Parameter Type Description
messages { content: string | null; name?: string; role: "system" | "user" | "assistant" | "tool"; tool_call_id?: string; tool_calls?: { function: { arguments: string; name: string; }; id: string; type: "function"; }[]; }[] Conversation messages (a system prompt is prepended if absent).
options? AiChatOptions Optional completion options.

Promise<AiResult<string>>

A AiResult with the assistant text.

import { useChat } from "katanakit-js";
const result = await useChat([
{ role: "user", content: "Summarize the benefits of solar energy in three bullet points." },
]);
if (result.ok) console.log(result.data);

useGetStrategy(): IAiProviderStrategy;

Defined in: core/services/agent.service.ts:304

Returns the currently active provider strategy.

IAiProviderStrategy


useInitAgent(config?): void;

Defined in: core/services/agent.service.ts:334

Registers the AI provider for the Kitt assistant.

apiKey falls back to process.env.DASHSCOPE_API_KEY; baseUrl, model and systemPrompt fall back to the kittPreset defaults.

Parameter Type Description
config? Partial<AiProviderConfig> Partial provider configuration.

void

import { useInitAgent } from "katanakit-js";
useInitAgent({
apiKey: process.env.DASHSCOPE_API_KEY,
model: "qwen3.8-max",
});

useRunAgent(goal, options?): Promise<AgentResult>;

Defined in: core/services/agent.service.ts:423

Runs the tool-calling agent loop against a goal until it emits a final answer or exhausts maxSteps.

Parameter Type Description
goal string The natural-language objective.
options? AgentRunOptions Tools, step budget and completion options.

Promise<AgentResult>

An AgentResult with the final message and executed steps.

import { useRunAgent } from "katanakit-js";
const result = await useRunAgent("Fix the type errors reported by tsc", {
tools: [
{
name: "runCommand",
description: "Runs a shell command and returns its output",
parameters: { type: "object", properties: { command: { type: "string" } } },
execute: (input) => shell.run(input.command),
},
],
maxSteps: 12,
});

useSetStrategy(strategy): void;

Defined in: core/services/agent.service.ts:299

Intercambia la estrategia de proveedor en runtime (Strategy Pattern).

Parameter Type Description
strategy IAiProviderStrategy La nueva estrategia a utilizar.

void


static create(strategy?): AgentService;

Defined in: core/services/agent.service.ts:290

Crea una instancia NO-singleton con una estrategia específica. Útil para tests o para aislar varios proveedores.

Parameter Type Description
strategy? IAiProviderStrategy Estrategia a inyectar.

AgentService

Una nueva instancia de AgentService.


static getInstance(): AgentService;

Defined in: core/services/agent.service.ts:276

Obtiene la instancia única del AgentService (Singleton).

AgentService

La instancia única de AgentService.