콘텐츠로 이동

규격서 읽는 법

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

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

섹션 제목: “30초 퀵스타트 — 모든 작업은 이 네 걸음입니다”
  1. 폴더: /agent_skills/<폴더명>/ 을 만듭니다. 폴더 하나가 배포 단위(가상환경) 하나입니다.

  2. 코드: 그 안 <아무이름>.py 에 @zio_skill 함수를 적습니다. 데이터는 Zio.code(기초코드) · Zio.node(지식 그래프 · ABox) · Zio.ontology(온톨로지 · TBox) · Zio.entity(usr 표) · Zio.view(가상화 뷰) 로 읽고 씁니다 — 데이터에 닿는 길은 이 SDK 하나뿐이고, Zio.raw() 의 SQL·Cypher 는 막혀 있습니다.

  3. 라이브러리 (필요할 때만): requirements.txt 에 패키지명을 적습니다. 나중에 고쳤으면 아래 restart 를 한 번 부릅니다 — 띄우면서 바뀐 것을 깝니다.

  4. 실행 — 고친 뒤에도 이 한 줄입니다. 다시 띄울 필요 없습니다 — 서버가 파일이 바뀐 것을 보고 알아서 새 코드로 띄웁니다.

    터미널 창
    curl -s -X POST http://api:8002/api/artifacts/skills/call/<폴더명>/execute/<함수명> \
    -H 'Content-Type: application/json' -H "X-Zio-Who: $ZIO_WHO" \
    -d '{"인자":"값"}'

    X-Zio-Who 는 감사에 「누가」를 남기는 줄입니다. $ZIO_WHO 는 로그인할 때 이미 들어와 있으니 그대로 쓰십시오.

    안 뜨면 까닭을 봅니다:

    터미널 창
    curl -s "http://api:8002/api/artifacts/skills/logs?skill_name=<폴더명>"

    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) 부터. 나머지는 찾아보는 문서입니다.

  • 이게 무엇인가요?
  • Zero-Trust 보안 및 격리 설계 지침
  • Zio SDK 호출 API 규격
  • 노드 표시명(_display) 자동 처리
  • 주요 컴포넌트 생태계
  • 스킬의 세 가지 모양
  • 폴더 구조
  • Agent Builder에서 사용하기
  • 지능형 파라미터 매핑
  • 실전 코드 작성 샘플
  • 짠 다음 — 돌려 보기
  • SSH 안에서 돌려 보기
  • 담당자의 말을 SDK 로 처리할 때 — 스킬을 짜는 법
  • 라이브러리를 나중에 더했다면
  • 진입점이 할 수 있는 것
  • 진입점마다 한 편씩 있습니다
  • 기초코드 API
  • 온톨로지 만들기 · 고치기
  • 온톨로지대로 세우기
  • 지식 그래프 탐색 API
  • 커스텀 테이블 API
  • MongoDB 조회
  • 무엇을 물어볼 수 있나
  • 수집데이터 Fluent CRUD API
  • 도구 만들기 — 바깥 REST API·원격 MCP 등록
  • 채우기 — render
  • 저작 — create · info · update
  • 한눈에
  • 순서
  • 실행 — 이미 돌고 있는 에이전트를 부르고 결과 받기
  • 데이터 수집 파이프라인
  • $테이블명.필드명
  • #온톨로지노드명.필드명
  • 부록 1. 구글 스프레드시트 서비스 계정 키 발급 받는 방법
  • 찾는 갈래는 여덟입니다
  • label 이 이 묶음의 전부입니다
  • 개요
  • 🚀 핵심 기능 및 특징
  • 구현 예시
  • 개요
  • 접속 및 사용 방법
  • 여러 사람이 함께 쓸 때
  • 🪟 Windows 사용자 자가 진단
  • 문제 해결

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

(주)지오유 · 경기 용인시 처인구 유림로154번길(유방동 673-2) 20-13

대표자 신달수·사업자등록번호 142-81-36612·통신판매업 신고번호 용인처인-0118호·개인정보 관리책임자 신달수·전자우편 shindalsoo@gmail.com·전화 1833-3623·팩스 02-6918-4006