synaptiai/uim-protocol

UIM 프로토콜의 개념과 배경을 숙지해 보세요.
UIM 프로토콜이 실제로 작동하는 것을 확인하기 위해 프로토타입 구현체를 탐색해 보세요.

본 프로젝트는 의존성 관리를 위해 Poetry를 사용합니다. Poetry는 의존성 해결(dependency resolution), 가상 환경(virtual environments) 등 기능을 통해 Python 의존성을 관리하는 더 나은 방법을 제공합니다.

• Python 3.10 이상

• Poetry

• 레포지토리를 클론하세요:

git clone https://github.com/synaptiai/uim-protocol.git cd uim-protocol

• Poetry로 의존성을 설치하세요:

poetry install

이 명령어는 가상 환경을 생성하고 모든 의존성을 설치합니다.

• 가상 환경을 활성화하세요:

poetry shell

본 프로젝트는 Poetry의 의존성 그룹(dependency groups)을 사용하여 의존성을 구성합니다:

Main: UIM Protocol의 핵심 의존성
Dev: 개발 의존성 (테스트, 린팅 등)
Docs: 문서화 의존성 (MkDocs 등)
NLP: 자연어 처리(Natural language processing) 의존성 (spaCy 등)

특정 그룹만 설치하려면:

# 문서화 의존성만 설치
poetry install --only docs
# 메인 의존성과 개발 의존성을 설치
...

cd uim-docs
poetry run mkdocs build

poetry run pytest

개발자, AI 제공업체(AI providers), 서비스 운영자(service operators), 그리고 기술/AI 애호가들을 초대하여 초안 사양을 검토하고, 구현체를 테스트하며, 피드백을 공유해 주시기를 바랍니다. 여러분의 입력은 프로토콜을 다듬고 개선하는 데 매우 중요합니다.

초안 제안서 검토하기 (Review the Draft Proposal): 초안 사양을 확인하고 프로토콜의 설계 및 구현을 탐색해 보세요.토론 참여하기 (Join the Discussion): 토론 탭에서 대화를 시작하세요. 프로토콜 설계, 잠재적 사용 사례 또는 우려 사항에 대한 여러분의 생각을 듣고 싶습니다.이슈 제기하기 (Raise Issues): 버그를 발견했거나 제안할 것이 있나요? 이슈를 열어 알려주거나 풀 리퀘스트(Pull Request)를 제출하여 직접 기여하세요. 자세한 내용은 기여 가이드라인(Contributing Guidelines)을 참고해 주세요.널리 알리기 (Share the Word): UIM 프로토콜에 대한 인지도를 높이는 데 도움을 주고, 이 저장소를 여러분의 네트워크와 공유해 주세요. 블로그 게시물 작성, 트윗 업로드 또는 동료들과 프로젝트를 공유하세요. 여러분의 지원에 감사드립니다!**

통합 의도 중개자(Unified Intent Mediator, UIM) 프로토콜은 AI 에이전트가 정의된 의도(intents), 메타데이터 및 실행 방법을 통해 웹 서비스와 상호 작용할 수 있는 표준화된 프레임워크를 정의합니다. 이러한 상호 작용에 일관성과 보안성을 도입함으로써, UIM은 AI 기반 애플리케이션의 효율성, 확장성 및 신뢰성을 향상시킵니다.

의도 (Intents): 웹 서비스가 노출할 수 있는 구조화된 액션으로, 제품 검색, 주문 처리 또는 데이터 검색과 같은 특정 작업을 정의합니다.메타데이터 및 매개변수 (Metadata and Parameters): 각 의도는 메타데이터(이름, 설명, 카테고리)와 정의된 매개변수를 포함하며, 이는 컨텍스트와 특정 입력 요구 사항을 제공합니다.정책 준수 토큰 (Policy Adherence Tokens, PATs): 권한, 청구 및 규정 준수 규칙을 캡슐화하는 디지털 서명 토큰입니다.발견 및 실행 API (Discovery and Execution APIs): AI 에이전트는 발견 API를 쿼리하여 사용 가능한 의도를 찾고, 실행 API를 사용하여 작업을 수행할 수 있습니다.DNS TXT 레코드 및 agents.json 파일: 엔드포인트 검색을 위한 혁신적인 방법으로, AI 에이전트가 API 엔드포인트를 찾아 인증할 수 있게 합니다.

UIM 프로토콜은 여러 아키텍처 접근 방식을 지원합니다:**

중앙 집중식 아키텍처 (Centralized Architecture): 중앙 저장소가 의도(intent) 등록, 검색, 실행 및 정책 관리를 담당합니다.분산형 아키텍처 (Decentralized Architecture): AI 에이전트가 중앙 중개자 없이 웹 서비스와 직접 상호 작용합니다.하이브리드 접근 방식 (Hybrid Approach): 중앙 집중식 검색과 분산형 실행 및 PAT(Policy Access Token) 발급을 결합합니다.

uim-protocol/
├── implementations/ # 레퍼런스 구현체
│ ├── centralized-discovery-service/
...

UIM 프로토콜은 현재 초안 제안 단계에 있습니다. 개발 로드맵은 저희의 로드맵을 참고해 주십시오.

본 프로젝트는 Apache License 2.0 하에 라이선스가 부여되어 있으며, 자세한 내용은 LICENSE 파일을 참조하십시오.