codecell-germany/facilioo-agent-skill

facilioo-agent-cli

사용 시점

이 스킬은 Facilioo 내에서 실제 작업이 필요하고, 웹 UI보다 터미널 워크플로우가 선호되는 작업에 사용합니다.

특히 에이전트가 다음을 수행해야 할 때 사용합니다:

• 터미널에서 Facilioo에 인증
• 자산, 입구, 유닛 또는 연락처에 대한 컨텍스트 구축
• 문의, 프로세스, 작업 명령, 약속, 사용자 작업, 알림 또는 공지사항 검사
• 문서 다운로드 또는 업로드
• 회의 의제 또는 프로토콜 작업
• 임시 HTTP 호출 없이 보호된 업데이트 수행

전제 조건

• facilioo-agent-cli를 제품 표면으로 취급합니다.
• 먼저 PATH에 존재하는지 확인합니다:
  • facilioo-agent-cli --help
  • facilioo-agent-skill --help
• 누락된 경우 공개 패키지를 통해 설치합니다:
  • npm install -g @codecell-germany/facilioo-agent-skill
  • facilioo-agent-skill install --force
• 레포지토리 로컬의 dist/, 숨겨진 Codex 도구 폴더 또는 이전 로컬 shim을 탐색하여 공개 CLI를 우회하지 마십시오.
• CLI가 이미 워크플로우를 제공하는 경우 임시 Swagger 호출로 시작하지 마십시오.

첫 실행 감지

실제 Facilioo 작업 전에 다음을 실행하십시오:

facilioo-agent-cli auth status --json
facilioo-agent-cli doctor --profile auth --json

다음 중 하나라도 해당되면 환경을 준비되지 않은 것으로 간주합니다:

• CLI가 누락됨
• 저장된 세션이 없음
• 설정된 인증 방법이 API 키 로그인이지만 API 키를 사용할 수 없음
• doctor 명령 실패
• 사용자가 첫 번째 설정이라고 말함

설정이 완료되지 않은 경우 즉시 온보딩 모드로 전환합니다. context, ops, documents 또는 conferences로 시작하지 마십시오.

온보딩 모드

새 사용자 또는 부분적으로 설정된 사용자를 위한 정확한 첫 실행 순서입니다:

1. 사용자에게 설정이 아직 완료되지 않았음을 알립니다.
2. 사용자 선호 언어로 내장된 설정 가이드를 출력합니다:
   • 영어: facilioo-agent-cli setup --language en
   • 독일어: facilioo-agent-cli setup --language de
3. 먼저 정적 값만 수집합니다:
   • FACILIOO_BASE_URL
   • FACILIOO_API_VERSION
   • FACILIOO_AUTH_METHOD
4. 터미널에 사람이 있는 경우 로컬 비밀번호 흐름을 기본값으로 사용합니다:
   • facilioo-agent-cli auth login --method password --interactive --persist
5. 사용자가 명시적으로 기술적 또는 자동화 지향 설정을 원하는 경우에만 API 키 로그인을 사용합니다:
   • FACILIOO_API_KEY
   • facilioo-agent-cli auth login --method api-key --persist
6. 절대 요청하지 마십시오:
   • 액세스 토큰
   • 리프레시 토큰
   • 원시 브라우저 쿠키
7. 로그인 후 다음을 다시 실행합니다:
   • facilioo-agent-cli auth status --json
   • facilioo-agent-cli doctor --profile core-read --json
8. 그런 다음에만 비즈니스 명령으로 진행합니다.

핵심 워크플로우

1. 설정 확인:
   • facilioo-agent-cli auth status --json
   • facilioo-agent-cli doctor --profile core-read --json
2. 컨텍스트 구축:
   • facilioo-agent-cli context lookup --search "Musterstraße 12" --json
   • facilioo-agent-cli context property --id 123 --include entrances,units,tenant,documents,ops --json
   • facilioo-agent-cli context unit --id 456 --include documents,ops --json
3. 운영 큐 작업:
   • facilioo-agent-cli ops inbox --property-id 123 --json
   • facilioo-agent-cli ops processes search --property-id 123 --open-only --json
   • facilioo-agent-cli ops tasks mine --json
   • facilioo-agent-cli ops notifications mine --json
4. 문서 작업:
   • facilioo-agent-cli documents search --property-id 123 --search "Versicherung" --json
   • facilioo-agent-cli documents download --id 5001 --output /absolute/path/file.pdf --json
5. 회의 작업:
   • facilioo-agent-cli conferences search --property-id 123 --json
   • facilioo-agent-cli conferences protocol --id 7001 --json

보호 장치

• 읽기 작업은 기본적으로 안전합니다.
• 쓰기 작업에는 다음이 필요합니다:
  • --execute --confirm-write yes
• 모든 노출된 삭제에는 다음이 필요합니다:
  • --execute --allow-delete --confirm-delete yes
• 민감한 변경 또는 삭제 전에 --preview를 사용하십시오.
• 비밀번호 로그인은 대화형 전용이며 실제 TTY에서 인간이 로컬로 완료해야 합니다.
• auth export는 옵트인이며 다른 프로세스가 명시적으로 환경 내보내기가 필요한 경우에만 사용해야 합니다.
• 토큰을 프롬프트, 티켓, 채팅 또는 스크린샷에 붙여넣지 마십시오.
• 상위 수준 명령이 존재하는 경우 원시 API 경로를 일반 경로로 취급하지 마십시오.

삭제 규칙

삭제 규칙은 이 스킬에서 전역적이며 프로세스별로만 적용되지 않습니다.

예시:

facilioo-agent-cli ops processes delete --id 987 --preview --json
facilioo-agent-cli ops processes delete --id 987 --execute --allow-delete --confirm-delete yes --json

facilioo-agent-cli documents delete --id 5001 --preview --json
facilioo-agent-cli documents delete --id 5001 --execute --allow-delete --confirm-delete yes --json

사용자가 삭제를 명시적으로 승인하지 않은 경우 실행하지 마십시오.

참고 자료

• 에이전트 온보딩 런북: references/agent-onboarding.md
• 주요 개요: references/overview.md
• 명령 치트 시트: references/command-cheatsheet.md
• 첫 실행 설정: references/facilioo-first-run.md