A StackOne a Pydantic AI Harness új képessége lett

Egy kapu több száz SaaS-rendszerhez

A Pydantic 2026. augusztus 13-i bejelentése szerint a StackOne az integrációs átjáró a mesterségesintelligencia-ügynökök számára. A szolgáltatás több száz SaaS-rendszerhez biztosít hozzáférést, a csatlakozók mögött pedig több ezer végrehajtható művelet található.

Az ügynökök integrációjánál két gyakori megközelítés okoz nehézséget. Az egyikben minden végponthoz külön eszközt kell megírni, saját hitelesítéssel, lapozási logikával és sémával. A másik lehetőség, hogy minden elképzelhető műveletet átadnak a modellnek, ez viszont a kontextusablakot olyan sémákkal tölti meg, amelyeket az ügynök valószínűleg nem használ.

A StackOne ezeket a műveleteket átjárón keresztül kezeli. A keresés és végrehajtás funkció a kapun fut, ezért a teljes katalógust nem kell előre beilleszteni a modell promptjába.

Egy sorral hozzáadható az ügynökhöz

A Pydantic AI Harness a Pydantic AI hivatalos képességtára. A képesség eszközöket, horgokat, utasításokat és beállításokat fog össze, majd a capabilities tömbön keresztül adható hozzá az ügynökhöz. A StackOne a kódvégrehajtás, a memória, a tervezés és a korlátozások mellett jelenik meg a könyvtárban.

A StackOne(account_id=...) egy StackOne-hoz kapcsolt fiókhoz kötődik. Ez egy végfelhasználó hitelesített kapcsolata egy mögöttes rendszerhez, például a Workdayhez, a Salesforce-hoz vagy a Zendeskhez. Egy ügynök több fiókkal is dolgozhat.

A használathoz előbb csatlakozót kell beállítani a StackOne-ban, össze kell kapcsolni egy fiókot, majd a vezérlőpulton ki kell másolni a kapcsolt fiók azonosítóját. Szükség van olyan API-kulcsra is, amely műveletek végrehajtására jogosult. A Pydantic példája az OpenAI gpt-5 modelljével futtatja az ügynököt, amely a „List the first 5 employees” kérést kapja.

Keresés vagy külön eszköz minden művelethez

Alapértelmezés szerint az ügynök két eszközt kap. Az egyik a kéréshez illeszkedő műveletet keresi meg, a másik a keresés által visszaadott azonosító alapján hajtja végre azt. Ez a search_execute mód, amelynek kontextusköltsége nem nő az engedélyezett műveletek számával.

A másik lehetőség az individual mód, ahol minden engedélyezett művelet saját eszközt és sémát kap. Ez akkor lehet megfelelő, ha kevés művelet áll rendelkezésre, és fontos a pontos eszközválasztás. Az actions szűrő kis- és nagybetűtől független, teljes névre illeszkedő fnmatch mintákat használ. A beállítás egyben individual módra vált.

A Pydantic külön kiemeli, hogy az actions lista a modell által látott eszközök alakítására szolgál, nem hozzáférés-vezérlésre. A jogosultságok valódi határa a StackOne vezérlőpultján beállított konfiguráció. A műveletek igény szerinti betöltése a defer_loading beállítással kérhető, a capability alapértelmezett azonosítója pedig stackone.

Írás előtt jóváhagyásra és kimeneti korlátokra van szükség

Az adatokat módosító műveleteknél két beállítás válik fontossá. A szolgáltatói műveletek nagy válaszokat adhatnak vissza, például egy teljes alkalmazotti lista könnyen elfoglalhatja a kontextusablakot. A ToolOutputLimits az ügynök szintjén korlátozza a túlméretezett kimeneteket.

A jóváhagyás alapértelmezés szerint nincs bekapcsolva, ezért a Pydantic az iratrendszert módosító műveleteknél a StackOneToolset és a Pydantic AI eszközjóváhagyásának használatát javasolja. A példa egy munkatárs létrehozását igénylő művelethez kér jóváhagyást. Ilyenkor az alkalmazás kapja meg a függőben lévő jóváhagyási kérést, így ember állhat a modell és az írási művelet között.

A StackOneToolset alacsonyabb szintű belépési pontként is használható azokban az esetekben, amikor közvetlenül az Agent(toolsets=[...]) beállítására vagy más eszközkészlet-csomagolóra van szükség. A Pydantic AI Harness 0.x verziózást használ, ezért az API kiadások között változhat. A Pydantic szerint ahol ez megoldható, a törő változásokat elavulási figyelmeztetés előzi meg.