This is the document you refer to when creating skills in /agent_skills.
The @zio_skill function written here becomes the skillFunction node of the agent builder, and the batch and debugger invoke it unchanged.
30‑Second Quick Start — All Tasks Follow These Four Steps
Folder: Create /agent_skills/<folder_name>/. One folder represents one deployment unit (virtual environment).
Code: Inside it, write a <any_name>.py file containing an @zio_skill function.
Data is read and written using Zio.code (base code) · Zio.node (knowledge graph · ABox) · Zio.ontology (ontology · TBox) · Zio.entity (usr table) · Zio.view (virtual view). The only way to touch data is through this SDK, and SQL·Cypher via Zio.raw() is blocked.
Library (only when needed): List package names in requirements.txt. If you later change it, run a single restart below — the server will reload with the updated packages.
Run — After making changes, this one line remains. No need to restart manually; the server detects file changes and automatically loads the new code.
There’s no way to verify whether import works, and there’s no need to — this environment lacks python·pip, and the code runs in a runner. Whether it succeeds is answered by the call above.
The place where you write code differs from where it runs. This location has no python·pip; execution is handled by the skill runner container that receives the call above. .venv/ and main.py are created by the runner, so do not modify them. Engine source or database connection information is also absent here.
Calling out to the outside world with curl is allowed — weather data, public datasets, any external REST API. The same applies inside a skill (requirements.txt can include requests). What’s blocked is the path back to us — you cannot reach https://<platform_address>.
Only these three endpoints are callable from here into our engine. The port is always 8002.
POST /api/artifacts/skills/call/<폴더명>/execute/<함수명> 부르기 (고쳤으면 서버가 알아서 다시 띄움)
GET /api/artifacts/skills/logs?skill_name=<폴더명> 안 뜬 까닭
POST /api/artifacts/skills/restart 다시 띄우기 — requirements.txt 를 고쳤을 때 · 프로세스가 꼬였을 때 {"skill_name":"<폴더명>"}
External addresses cannot be called from here (403). Data is read within the skill using the SDK.
Use only the necessary parts. Reading everything will overwhelm you with manual context. If you’re new, start with Creating a Skill (@zio_skill) and then explore the rest of the documentation.
This folder is read‑only. Even if you edit it, it will revert on the next deployment.
If something is wrong or missing, tell the engine responsible person.