SDK
Utilisez Beeuni Computer comme backend d’agents pour votre produit.
Utilisez @beeuni/sdk pour gérer vos projets, exécuter des sessions d’agents et connecter vos outils.
Installation
npm install @beeuni/sdkCréer un client
Créez une clé API dans Account → Tokens. Conservez les clés API du serveur sur votre serveur.
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();Le SDK appelle getToken à chaque requête. Votre application gère le stockage et le renouvellement des tokens ; voir Authentification.
Appeler un Connector
Recherchez les outils disponibles dans votre projet, puis consultez le schéma d’entrée d’un outil. Beeuni gère les identifiants des connexions.
Définissez BEEUNI_PROJECT_ID avec l’identifiant d’un projet existant accessible à votre clé 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'));Remplacez toolName par un nom renvoyé par la recherche et remplissez args selon son schéma d’entrée. Les appels nécessitent une connexion autorisée et la permission d’utiliser l’outil.
const toolName = 'your_connector.your_action';
console.log(await connectors.describe(toolName));
const args = {};
const result = await connectors.call(toolName, args);
console.log(result);Démarrer votre première session
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() démarre ou reprend la session et attend qu’elle soit prête. Sans paramètres de remplacement, send() utilise le modèle et l’agent configurés dans le projet. Les sessions consomment des crédits.
Pour recevoir les événements et lire la réponse, consultez l’exemple complet. Pour une interface React, utilisez React hooks.