콘텐츠로 이동

규격서 읽는 법

/agent_skills 에서 스킬을 짤 때 보는 문서입니다. 여기에 짠 @zio_skill 함수가 에이전트 빌더의 skillFunction 노드가 되고, 배치와 디버거가 그대로 부릅니다.

30초 퀵스타트 — 모든 작업은 이 네 걸음입니다

섹션 제목: “30초 퀵스타트 — 모든 작업은 이 네 걸음입니다”
  1. 폴더: /agent_skills/<폴더명>/ 을 만듭니다. 폴더 하나가 배포 단위(가상환경) 하나입니다.
  2. 코드: 그 안 <아무이름>.py@zio_skill 함수를 적습니다. 데이터는 Zio.code(기초코드) · Zio.node(그래프) · Zio.ontology(설계서) · Zio.entity(usr 표) · Zio.view(가상화 뷰) 로 읽고 씁니다 — 데이터에 닿는 길은 이 SDK 하나뿐이고, Zio.raw() 의 SQL·Cypher 는 막혀 있습니다.
  3. 라이브러리 (필요할 때만): requirements.txt 에 패키지명을 적습니다. 가상환경이 이미 있는데 나중에 더했으면 zio deps <폴더명>.
  4. 실행 — 고친 뒤엔 이 한 줄입니다. 다시 띄우고 부르는 것을 한꺼번에 합니다.
    터미널 창
    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 사용자 자가 진단
  • 문제 해결

이 폴더는 읽기 전용입니다. 고쳐도 다음 배포 때 되돌아갑니다. 내용이 틀렸거나 빠진 것이 있으면 엔진 담당자에게 말하십시오.