규격서 읽는 법
/agent_skills 에서 스킬을 짤 때 보는 문서입니다.
여기에 짠 @zio_skill 함수가 에이전트 빌더의 skillFunction 노드가 되고,
배치와 디버거가 그대로 부릅니다.
30초 퀵스타트 — 모든 작업은 이 네 걸음입니다
섹션 제목: “30초 퀵스타트 — 모든 작업은 이 네 걸음입니다”- 폴더:
/agent_skills/<폴더명>/을 만듭니다. 폴더 하나가 배포 단위(가상환경) 하나입니다. - 코드: 그 안
<아무이름>.py에@zio_skill함수를 적습니다. 데이터는Zio.code(기초코드) ·Zio.node(그래프) ·Zio.ontology(설계서) ·Zio.entity(usr표) ·Zio.view(가상화 뷰) 로 읽고 씁니다 — 데이터에 닿는 길은 이 SDK 하나뿐이고,Zio.raw()의 SQL·Cypher 는 막혀 있습니다. - 라이브러리 (필요할 때만):
requirements.txt에 패키지명을 적습니다. 가상환경이 이미 있는데 나중에 더했으면zio deps <폴더명>. - 실행 — 고친 뒤엔 이 한 줄입니다. 다시 띄우고 부르는 것을 한꺼번에 합니다.
안 뜨면
터미널 창 zio run <폴더명>/<함수명> '{"인자":"값"}'zio logs <폴더명>. 나머지 명령(call·restart·ls·ping)은 스킬 만들기 (@zio_skill) 의 「SSH 안에서 돌려 보기」 에 있습니다.
코드를 쓰는 곳과 도는 곳이 다릅니다. 이 자리에는
python·pip이 없고, 실행은zio run을 통해 스킬 러너 컨테이너가 합니다..venv/와main.py는 러너가 만들어 두는 것이라 손대지 않습니다. 엔진 소스도 DB 접속 정보도 여기엔 없습니다.
zio가 없는 환경이면curl로 같은 일을 합니다. 주소는 늘 이 하나이고 포트는 8000 입니다:POST http://api:8000/api/artifacts/skills/call/<폴더명>/execute/<함수명>
필요한 절만 여십시오. 전부 읽으면 문맥이 매뉴얼로 찹니다. 처음이라면 스킬 만들기 (@zio_skill) 부터. 나머지는 찾아보는 문서입니다.
- 이게 무엇인가요?
- Zero-Trust 보안 및 격리 설계 지침
- Zio SDK 호출 API 규격
- 노드 표시명(
_display) 자동 처리 - 주요 컴포넌트 생태계
- 스킬의 세 가지 모양
- 폴더 구조
- Agent Builder에서 사용하기
- 지능형 파라미터 매핑
- 실전 코드 작성 샘플
- 짠 다음 — 돌려 보기
- SSH 안에서 돌려 보기
- 라이브러리를 나중에 더했다면
- 진입점이 할 수 있는 것
- 진입점마다 한 편씩 있습니다
- 기초코드 API
- 설계서 만들기 · 고치기
- 설계서대로 세우기
- 온톨로지 그래프 탐색 API
- 커스텀 테이블 API
- MongoDB 조회
- 무엇을 물어볼 수 있나
- 수집데이터 Fluent CRUD API
- 도구 만들기 — 바깥 REST API·원격 MCP 등록
- 채우기 — render
- 저작 — create · info · update
- 한눈에
- create — 축약 스펙
- 다룰 때 순서
- 데이터 수집 파이프라인
- $테이블명.필드명
- #온톨로지노드명.필드명
- 부록 1. 구글 스프레드시트 서비스 계정 키 발급 받는 방법
- 찾는 갈래는 여덟입니다
- label 이 이 묶음의 전부입니다
- 개요
- 🚀 핵심 기능 및 특징
- 구현 예시
- 개요
- 접속 및 사용 방법
- 여러 사람이 함께 쓸 때
- 🪟 Windows 사용자 자가 진단
- 문제 해결
이 폴더는 읽기 전용입니다. 고쳐도 다음 배포 때 되돌아갑니다. 내용이 틀렸거나 빠진 것이 있으면 엔진 담당자에게 말하십시오.