AI агенти
Агентът е програма, която работи върху вашите таблици: скрипт, който извиква API, асистент в Claude, ChatGPT или Le Chat чрез конектора, или ваша собствена автоматизация. В Artavolo всеки агент има име, собствен токен и достъп до базите, които му дадете, а всичко, което промени, се записва на негово име в историята на записа и в дневника на промените.
Създаване на агент
Агенти създава собственикът на работно пространство. В API:
curl -u you@example.com:$YOUR_TOKEN -H "Content-Type: application/json" \
-d '{"name": "Invoice bot", "mode": "review", "bases": {"Aw7e1PXjM8": "write"}}' \
https://artavolo.com/api/v2/workspaces/$WORKSPACE_CODE/agents
Отговорът съдържа токена на агента, само веднъж. Пазете го като парола; нов може да се създаде по всяко време (POST .../agents/{id}/token) и старият спира да работи.
bases назовава всяка база, която агентът може да ползва: "read" му позволява да чете, "write" му позволява да променя записи. Правилата за таблиците на базата важат за него както за човек: таблиците, скрити от сътрудниците, са скрити и за него, а правило за редове („само записите, в които Собственик е той“) ограничава това, което вижда.
Какво правят промените му: режимът
direct: промените му се записват веднага, както при човек.преглед: промяната на запис се задържа като предложение, по едно за всяко поле, докато човек я приеме или отхвърли. Заявка, която променя запис, отговаря с202и предложенията вместо с200. Новите записи се добавят веднага, а изтриването отива в кошчето, откъдето може да се възстанови.
В режим review човек вижда предложенията до таблицата и решава:
GET /api/v2/bases/{base}/tables/{table}/proposals what is waiting, by agent
POST /api/v2/bases/{base}/tables/{table}/proposals/decide {"accept": ["p12"], "reject": ["p13"]}
Прието предложение се записва само ако клетката все още съдържа това, което агентът е видял; ако някой я е променил преди това, предложението е остаряло и нищо не се записва. Тогава историята на записа гласи „Invoice bot, прието от Dana“.
Агентът може да добави причина към промяната си, която човекът вижда:
PATCH /api/v2/bases/{base}/tables/{table}/rows/{id}
{"Status": "Paid", "_reason": "Bank statement of 3 March shows the payment"}
Свързване
Токенът работи навсякъде, където работи API токен:
- API за данни,
https://artavolo.com/api/v2, в заглавкатаAPI-KEY(data-api.md); - API, съвместимо с Airtable,
https://artavolo.com/v0, катоAuthorization: Bearer(airtable-api.md); - AI конекторът,
https://artavolo.com/mcp, катоAuthorization: Bearer(ai-connector.md). Неговите инструменти казват на асистента кога промяна е била задържана за преглед.
Наблюдение на това, което правят агентите
GET /api/v2/workspaces/{code}/agents изброява всеки агент с неговия достъп, колко промени е направил през последните 7 дни, колко от предложенията му са приети, отхвърлени или остарели, и дела на приетите.
Премахването на агент (DELETE .../agents/{id}) прекратява токена и достъпа му и отхвърля това, което е предложил и никой не е решил. Вече направеното остава, записано на негово име.