27 AI 레지스트리

AI 레지스트리는 Oracle AI Data Platform용 에이전트 및 MCP 서버의 중앙 카탈로그입니다. MCP 및 A2A를 포함한 개방형 표준을 지원합니다.

AI Data Platform은 에이전트가 구축 및 배포되는 곳입니다. Oracle Agent Hub에서는 비즈니스 사용자가 대화할 수 있습니다. AI 레지스트리는 이들 사이의 계층입니다. AI 레지스트리는 에이전트 또는 도구가 내장된 환경 외부에서 검색 가능하고 사용 가능하도록 만듭니다. 에이전트 및 툴을 에이전트 허브에서 공유하려면 먼저 AI 레지스트리에 등록해야 합니다. Oracle Agent Hub 사용의 에이전트 허브에서 엔터프라이즈 AI 작동 방식을 참조하십시오.

AI Data Platform AI 레지스트리에서 다음 에이전트 및 툴을 등록할 수 있습니다.

유형 설명
AI Data Platform 에이전트 액세스 권한이 있는 작업영역에서 AI 데이터 플랫폼에 구축 및 배포된 에이전트입니다. AI 데이터 플랫폼 AI 레지스트리에서 로컬 에이전트라고도 합니다.
외부 상담원 AI 데이터 플랫폼 외부에서 호스트된 에이전트로, A2A 에이전트 카드 URL로 추가됩니다.
MCP 서버 에이전트가 호출할 수 있는 도구 세트를 노출하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

AI 레지스트리에서 AI 에이전트, MCP 서버 및 둘 다 사용하는 데 필요한 자격 증명을 관리할 수 있습니다. [AI 레지스트리] 페이지에서 에이전트, MCP 서버 및 자격 증명 탭을 사용하여 각 항목의 목록을 볼 수 있습니다. 검색 표시줄을 사용하여 이름 또는 설명별로 표시되는 옵션을 필터링할 수 있습니다. [에이전트] 탭에서 정렬 기준 드롭다운 메뉴를 사용하여 에이전트가 레지스트리에 추가된 최근 횟수를 기준으로 정렬할 수 있습니다.

에이전트 카드를 누르면 해당 에이전트에 대한 세부정보가 표시되며, 생성자, 소스, 버전, 에이전트 카드에 대한 URL 및 프로토콜 버전이 제공됩니다. 카드의 오른쪽 상단 모서리에 있는 옵션을 사용하여 카드의 세부정보 보기와 JSON 보기 간에 전환할 수 있습니다.

새 외부 에이전트 또는 MCP 서버를 등록하기 전에 먼저 인증서 탭에서 인증 자격 증명을 등록해야 합니다. 그런 다음 오른쪽 상단에서 등록을 누르고 적합한 옵션을 선택하여 새 에이전트 및 MCP 서버를 등록할 수 있습니다. AI 레지스트리에 대한 권한은 권한 탭에서 관리됩니다.

에이전트 카드 정보

에이전트 카드는 에이전트를 설명하는 메타데이터 구조입니다. AI 레지스트리는 등록 중 이를 읽고 커밋하기 전에 검토를 위해 사용자에게 표시합니다.

자세한 내용은 A2A 프로토콜 사양을 참조하십시오.

에이전트 카드에는 다음 정보가 포함됩니다.
  • 이름, 버전 및 설명입니다.
  • 카드 자체가 게시되는 에이전트 카드 URL입니다.
  • 프로토콜 버전.
  • 입력 및 입력 모드 텍스트, text/plain 또는 text/html을 예로 들 수 있습니다.
  • Streaming과 같은 기능.
  • 스킬은 각각 고유한 이름과 설명을 포함합니다.
이 카드는 통합관리가 일치하는 대상입니다. 사용자가 에이전트를 선택하지 않고 에이전트 허브에서 질문을 하면 이 카드의 이름, 설명, 기술 및 기능이 에이전트를 표시할지 여부를 결정합니다. 모호한 설명은 에이전트가 선택되지 않은 가장 일반적인 이유입니다.

AI 레지스트리에 인증서 생성

에이전트 및 MCP 서버와 같은 AI 레지스트리 객체 인증에 필요한 인증서를 저장할 수 있습니다.

  1. 홈 페이지에서 AI 레지스트리 아이콘AI 레지스트리를 누릅니다.
  2. 인증서 탭을 누른 다음 인증서 생성을 누릅니다.
  3. 인증서에 대한 이름과 설명을 입력합니다.
  4. 드롭다운 메뉴에서 자격 증명 유형을 선택합니다.
  5. 드롭다운 메뉴에서 권한 부여 유형을 선택합니다.
  6. 인증서에 대한 권한 부여 URL, 액세스 토큰 URL, 클라이언트 ID, 클라이언트 암호 및 새로고침 URL을 입력합니다.
  7. 범위 이름 및 값을 입력합니다. 하나 이상의 범위 이름 및 값이 필요합니다. 범위 추가를 눌러 범위 이름과 값을 추가합니다.
  8. 재지정 URL을 복사합니다. 재지정 URL을 ID 도메인의 기밀 애플리케이션에 붙여넣어야 합니다. 다음 예에서는 리디렉션 URL을 Oracle Cloud Infrastructure로 복사하는 방법을 보여줍니다.
    1. OCI 콘솔에 로그인합니다.
    2. ID 및 보안, 도메인, 통합 애플리케이션 순으로 누릅니다.
    3. 재지정 URL을 업데이트할 애플리케이션을 선택합니다.
    4. OAuth 구성 탭을 누른 다음 OAuth 구성 편집을 누릅니다.
    5. 필요한 재지정 URL을 적용한 다음 제출을 누릅니다.
  9. 생성을 누릅니다.

AI 레지스트리에 로컬 에이전트 등록

액세스 권한이 있는 Oracle AI Data Platform 작업영역에서 로컬 AI 에이전트를 등록할 수 있습니다.

에이전트를 AI 레지스트리에 등록하려면 먼저 AI 데이터 플랫폼에 배포해야 합니다. 에이전트 배포를 참조하십시오.
  1. 홈 페이지에서 AI 레지스트리 아이콘AI 레지스트리를 누릅니다.
  2. 등록, 에이전트 순으로 누릅니다.
  3. 로컬 에이전트를 누릅니다.
  4. 작업 영역 드롭다운 메뉴에서 로컬 에이전트가 있는 작업 영역을 선택합니다.
  5. 에이전트 드롭다운 메뉴에서 등록할 에이전트를 선택합니다.
  6. 선택 사항: 에이전트 카드를 미리 보려면 카드 아이콘 위로 마우스를 갖다 대십시오.
  7. 다음을 누릅니다.
  8. 에이전트 세부정보가 올바른지 확인한 다음 등록을 누릅니다.

AI 레지스트리에 외부 에이전트 등록

지원되는 소스에서 AI 레지스트리에 외부 AI 에이전트를 등록할 수 있습니다. 이러한 에이전트는 A2A 프로토콜을 준수해야 합니다.

외부 에이전트에 인증이 필요한 경우 먼저 AI 레지스트리의 인증서 탭에서 해당 인증서를 생성합니다.
  1. 홈 페이지에서 AI 레지스트리 아이콘AI 레지스트리를 누릅니다.
  2. 등록, 에이전트 순으로 누릅니다.
  3. 외부 에이전트를 누릅니다.
  4. 에이전트 카드 URL을 입력합니다.
  5. 선택 사항: 끝점에 보안 인증서가 필요한 경우 인증 필요를 선택한 다음 인증서 드롭다운 메뉴에서 인증서를 선택합니다.
  6. 다음을 누릅니다.
  7. 선택 사항: 인증 필요(Required authentication)를 선택한 경우 나타나는 대화 상자에서 에이전트에 대한 자격이 부여된 계정에 대한 자격 증명을 입력합니다.
  8. 상담원 세부정보를 정확하게 검토한 후 등록을 누릅니다.

AI 레지스트리에 MCP 서버 등록

MCP 서버는 에이전트가 표준 인터페이스를 통해 검색 및 호출할 수 있는 도구 세트를 노출합니다. AI 레지스트리에 도구를 등록하면 플랫폼에서 해당 도구를 사용할 수 있습니다.

주:

MCP 서버에 인증이 필요한 경우 먼저 AI 레지스트리에서 OAuth 자격 증명을 만들어야 합니다. 자격 증명은 MCP 서버 등록의 일부로 추가할 수 없습니다.
  1. 홈 페이지에서 AI 레지스트리 아이콘AI 레지스트리를 누릅니다.
  2. 등록을 누른 다음 MCP 서버를 누릅니다.
  3. MCP 서버 끝점의 URL을 입력합니다.
  4. 유용한 표시 이름 및 설명을 입력합니다. 사용자와 에이전트는 이를 사용하여 MCP 서버의 목적을 식별합니다.
  5. 드롭다운 메뉴에서 전송 방법을 선택합니다.
  6. 선택 사항: MCP 서버에 보안 자격 증명이 필요한 경우 인증 필요를 선택합니다. 인증서 드롭다운 메뉴에서 인증서를 선택합니다.
  7. 계속을 누릅니다.
  8. 선택한 MCP 서버에 대해 포함된 도구 목록을 검토합니다. 개별적으로 포함할 도구를 선택하거나 모두 선택을 눌러 나열된 모든 도구를 포함합니다.
  9. 등록을 누릅니다.