SDK
Nutze Beeuni Computer als Agent-Backend für dein Produkt.
Mit @beeuni/sdk verwaltest du Projekte, führst Agent-Sitzungen aus und verbindest deine Tools.
Installation
npm install @beeuni/sdkClient erstellen
Erstelle einen API-Schlüssel unter Account → Tokens. Bewahre Server-API-Schlüssel auf deinem Server auf.
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();Das SDK ruft getToken bei jeder Anfrage auf. Deine Anwendung verwaltet Tokens und ihre Erneuerung; siehe Authentifizierung.
Connector aufrufen
Finde die verfügbaren Tools deines Projekts und prüfe das Eingabeschema eines Tools. Beeuni verwaltet die Zugangsdaten der Verbindungen.
Setze BEEUNI_PROJECT_ID auf ein bestehendes Projekt, auf das dein API-Schlüssel zugreifen darf.
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'));Ersetze toolName durch einen Namen aus den Suchergebnissen und fülle args gemäß dem Eingabeschema aus. Aufrufe benötigen eine autorisierte Verbindung und die Berechtigung für das Tool.
const toolName = 'your_connector.your_action';
console.log(await connectors.describe(toolName));
const args = {};
const result = await connectors.call(toolName, args);
console.log(result);Erste Sitzung starten
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() startet oder setzt die Sitzung fort und wartet auf Bereitschaft. Ohne Überschreibungen verwendet send() das konfigurierte Modell und den Agenten des Projekts. Sitzungen verbrauchen Guthaben.
Ereignisse und Antworten zeigt das vollständige Beispiel. Für eine React-Oberfläche nutze React hooks.