Напускате Airtable? Пренесете базите си в Artavolo, проверени запис по запис. Вижте как

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}) прекратява токена и достъпа му и отхвърля това, което е предложил и никой не е решил. Вече направеното остава, записано на негово име.

Въпрос, на който тези страници не отговарят? Пишете ни и ще ви отговорим по имейл, обикновено в рамките на един работен ден. Свържете се с нас