Paquetes npm
@cognitiondesk/clientv0.2.0
SDK liviano por comandos para asistentes, workflows y tareas — sin dependencias de UI del widget.
Ver en npm backendUrl → api.cognitiondesk.com (por defecto)
Instalación
Shell
npm install @cognitiondesk/clientInicio rápido
Corrido el 2026-09-25 contra api.cognitiondesk.com con una API key y un asistente descartables (los dos borrados después).
JavaScript
import { createCognitionDeskClient } from '@cognitiondesk/client';
// backendUrl is OPTIONAL since 0.2.0: without it, this only ever talks to
// https://api.cognitiondesk.com (DEFAULT_COGNITIONDESK_BACKEND in the
// source). Pass it only if you're talking to a different backend
// (self-hosted, staging).
const client = createCognitionDeskClient({
apiKey: process.env.COGNITIONDESK_API_KEY,
});
// Run 2026-09-25 against api.cognitiondesk.com with a throwaway key —
// returned exactly the requested text:
const text = await client.invokeAssistantText({
assistantId: 'YOUR_ASSISTANT_ID',
prompt: 'Reply with exactly: hello from client test',
userContext: { platform: 'my-app', conversationId: 'conv-1' },
});
console.log(text); // -> "hello from client test"API key vs. token de Firebase
JavaScript
// "Runtime" methods (invokeAssistant*, streamAssistantEvents, clearThread)
// accept EITHER an API key or a Firebase token.
//
// "Command" methods (assistants.list, getAssistant, patchAssistant,
// workflows.*, tasks.*) ALWAYS require a Firebase token — an API key alone
// gets 403. Verified live: invokeAssistantText with apiKey worked;
// getAssistant with the same key returned 403 "No token provided.".
const withFirebase = createCognitionDeskClient({
getAuthToken: async () => firebaseAuth.currentUser.getIdToken(),
});
const assistants = await withFirebase.listAssistants();API
invokeAssistant / invokeAssistantText / invokeAssistantStream / streamAssistantEvents | Corre el runtime del asistente desde código, sin UI de widget. API key o token de Firebase. |
clearThread(threadId, opts) | Reinicia un hilo de conversación. |
listAssistants / getAssistant / createAssistant / patchAssistant | Llamadas "command" — sólo token de Firebase. |
executeCommand(name, params) | Ejecuta un command crudo para lo que no está envuelto arriba. |