SDK
Usa Beeuni Computer como backend de agentes para tu producto.
Usa @beeuni/sdk para gestionar proyectos, ejecutar sesiones de agentes y conectar tus herramientas.
Instalación
npm install @beeuni/sdkCrear un cliente
Crea una clave de API en Account → Tokens. Guarda las claves de API del servidor en tu servidor.
import { createBeeuni } from '@beeuni/sdk';
const beeuni = createBeeuni({
backendUrl: 'https://api.beeuni.ai/v1',
getToken: async () => process.env.BEEUNI_API_KEY ?? null,
});
const projects = await beeuni.projects.list();El SDK llama a getToken en cada solicitud. Tu aplicación gestiona el almacenamiento y la renovación de tokens; consulta Autenticación.
Llamar a un Connector
Busca las herramientas disponibles en tu proyecto y revisa el esquema de entrada de una herramienta. Beeuni gestiona las credenciales de las conexiones.
Establece BEEUNI_PROJECT_ID con el ID de un proyecto existente al que pueda acceder tu clave API.
const projectId = process.env.BEEUNI_PROJECT_ID!;
const connectors = beeuni.project(projectId).connectors;
console.log(await connectors.catalog());
console.log(await connectors.search('search email'));Sustituye toolName por un nombre devuelto por la búsqueda y rellena args según su esquema de entrada. Las llamadas requieren una conexión autorizada y permiso para usar la herramienta.
const toolName = 'your_connector.your_action';
console.log(await connectors.describe(toolName));
const args = {};
const result = await connectors.call(toolName, args);
console.log(result);Iniciar tu primera sesión
const created = await beeuni.project(projectId).sessions.create({
name: 'My first SDK session',
});
const session = beeuni.session(projectId, created.session_id);
await session.ensureReady();
await session.send('Describe your capabilities in one paragraph.');ensureReady() inicia o reanuda la sesión y espera hasta que esté lista. Sin parámetros de sustitución, send() usa el modelo y el agente configurados en el proyecto. Las sesiones consumen créditos.
Para recibir eventos y leer la respuesta, consulta el ejemplo completo. Para una interfaz React, usa React hooks.