SDK
Користите Beeuni Computer као позадински систем за агенте вашег производа.
Користите @beeuni/sdk за управљање пројектима, покретање сесија агената и повезивање алата.
Инсталација
npm install @beeuni/sdk
Креирање клијента
Креирајте API кључ у Account → Tokens. Серверске API кључеве чувајте на свом серверу.
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();
SDK позива getToken при сваком захтеву. Ваша апликација управља чувањем и обнављањем токена; погледајте Аутентификација.
Позовите Connector
Пронађите алате доступне у пројекту и проверите улазну шему алата. Beeuni управља приступним подацима веза.
Поставите BEEUNI_PROJECT_ID на ID постојећег пројекта коме ваш 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'));
Замените toolName именом алата из резултата претраге и попуните args према улазној шеми. Позиви захтевају ауторизовану везу и дозволу за коришћење алата.
const toolName = 'your_connector.your_action';
console.log(await connectors.describe(toolName));
const args = {};
const result = await connectors.call(toolName, args);
console.log(result);
Покрените прву сесију
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() покреће или наставља сесију и чека да буде спремна. Без додатних параметара, send() користи модел и агента подешене у пројекту. Сесије троше кредите.
За пријем догађаја и читање одговора погледајте потпун пример. За React интерфејс користите React hooks.