폴더: /agent_skills/<폴더명>/ 을 만듭니다. 폴더 하나가 배포 단위(가상환경) 하나입니다.
코드: 그 안 <아무이름>.py 에 @zio_skill 함수를 적습니다.
데이터는 Zio.code(기초코드) · Zio.node(지식 그래프 · ABox) · Zio.ontology(온톨로지 · TBox) · Zio.entity(usr 표) · Zio.view(가상화 뷰) 로 읽고 씁니다 — 데이터에 닿는 길은 이 SDK 하나뿐이고, Zio.raw() 의 SQL·Cypher 는 막혀 있습니다.
라이브러리 (필요할 때만): requirements.txt 에 패키지명을 적습니다. 나중에 고쳤으면 아래 restart 를 한 번 부릅니다 — 띄우면서 바뀐 것을 깝니다.
실행 — 고친 뒤에도 이 한 줄입니다. 다시 띄울 필요 없습니다 — 서버가 파일이 바뀐 것을 보고 알아서 새 코드로 띄웁니다.
import 가 되는지 확인할 방법은 없고, 할 필요도 없습니다 — 이 자리에는 python·pip 이
없고 코드는 러너에서 돕니다. 되는지는 위 호출이 답합니다.
코드를 쓰는 곳과 도는 곳이 다릅니다. 이 자리에는 python·pip 이 없고,
실행은 위 호출을 받은 스킬 러너 컨테이너가 합니다. .venv/ 와 main.py 는
러너가 만들어 두는 것이라 손대지 않습니다. 엔진 소스도 DB 접속 정보도 여기엔 없습니다.
curl 로 바깥 세상을 부르는 것은 자유입니다 — 기상청·공공데이터·외부 REST 무엇이든.
스킬 안에서도 마찬가지입니다(requirements.txt 에 requests 를 적어 쓰십시오).
막혀 있는 것은 우리 쪽으로 되돌아오는 길뿐입니다 — https://<이 플랫폼 주소> 로는 못 나갑니다.
이 자리에서 우리 엔진에 부를 수 있는 것은 이 셋뿐입니다. 포트는 늘 8002 입니다.
POST /api/artifacts/skills/call/<폴더명>/execute/<함수명> 부르기 (고쳤으면 서버가 알아서 다시 띄움)
GET /api/artifacts/skills/logs?skill_name=<폴더명> 안 뜬 까닭
POST /api/artifacts/skills/restart 다시 띄우기 — requirements.txt 를 고쳤을 때 · 프로세스가 꼬였을 때 {"skill_name":"<폴더명>"}
이 밖의 주소는 여기서 부를 수 없습니다(403). 데이터는 스킬 안에서 SDK 로 읽습니다.
필요한 절만 여십시오. 전부 읽으면 문맥이 매뉴얼로 찹니다.
처음이라면 스킬 만들기 (@zio_skill) 부터. 나머지는 찾아보는 문서입니다.