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 레지스트리 객체 인증에 필요한 인증서를 저장할 수 있습니다.
- 홈 페이지에서
AI 레지스트리를 누릅니다. - 인증서 탭을 누른 다음 인증서 생성을 누릅니다.
- 인증서에 대한 이름과 설명을 입력합니다.
- 드롭다운 메뉴에서 자격 증명 유형을 선택합니다.
- 드롭다운 메뉴에서 권한 부여 유형을 선택합니다.
- 인증서에 대한 권한 부여 URL, 액세스 토큰 URL, 클라이언트 ID, 클라이언트 암호 및 새로고침 URL을 입력합니다.
- 범위 이름 및 값을 입력합니다. 하나 이상의 범위 이름 및 값이 필요합니다. 범위 추가를 눌러 범위 이름과 값을 추가합니다.
- 재지정 URL을 복사합니다. 재지정 URL을 ID 도메인의 기밀 애플리케이션에 붙여넣어야 합니다. 다음 예에서는 리디렉션 URL을 Oracle Cloud Infrastructure로 복사하는 방법을 보여줍니다.
- OCI 콘솔에 로그인합니다.
- ID 및 보안, 도메인, 통합 애플리케이션 순으로 누릅니다.
- 재지정 URL을 업데이트할 애플리케이션을 선택합니다.
- OAuth 구성 탭을 누른 다음 OAuth 구성 편집을 누릅니다.
- 필요한 재지정 URL을 적용한 다음 제출을 누릅니다.
- 생성을 누릅니다.
AI 레지스트리에 로컬 에이전트 등록
액세스 권한이 있는 Oracle AI Data Platform 작업영역에서 로컬 AI 에이전트를 등록할 수 있습니다.
- 홈 페이지에서
AI 레지스트리를 누릅니다. - 등록, 에이전트 순으로 누릅니다.
- 로컬 에이전트를 누릅니다.
- 작업 영역 드롭다운 메뉴에서 로컬 에이전트가 있는 작업 영역을 선택합니다.
- 에이전트 드롭다운 메뉴에서 등록할 에이전트를 선택합니다.
- 선택 사항: 에이전트 카드를 미리 보려면 카드 아이콘 위로 마우스를 갖다 대십시오.
- 다음을 누릅니다.
- 에이전트 세부정보가 올바른지 확인한 다음 등록을 누릅니다.
AI 레지스트리에 외부 에이전트 등록
지원되는 소스에서 AI 레지스트리에 외부 AI 에이전트를 등록할 수 있습니다. 이러한 에이전트는 A2A 프로토콜을 준수해야 합니다.
- 홈 페이지에서
AI 레지스트리를 누릅니다. - 등록, 에이전트 순으로 누릅니다.
- 외부 에이전트를 누릅니다.
- 에이전트 카드 URL을 입력합니다.
- 선택 사항: 끝점에 보안 인증서가 필요한 경우 인증 필요를 선택한 다음 인증서 드롭다운 메뉴에서 인증서를 선택합니다.
- 다음을 누릅니다.
- 선택 사항: 인증 필요(Required authentication)를 선택한 경우 나타나는 대화 상자에서 에이전트에 대한 자격이 부여된 계정에 대한 자격 증명을 입력합니다.
- 상담원 세부정보를 정확하게 검토한 후 등록을 누릅니다.
AI 레지스트리에 MCP 서버 등록
MCP 서버는 에이전트가 표준 인터페이스를 통해 검색 및 호출할 수 있는 도구 세트를 노출합니다. AI 레지스트리에 도구를 등록하면 플랫폼에서 해당 도구를 사용할 수 있습니다.
주:
MCP 서버에 인증이 필요한 경우 먼저 AI 레지스트리에서 OAuth 자격 증명을 만들어야 합니다. 자격 증명은 MCP 서버 등록의 일부로 추가할 수 없습니다.- 홈 페이지에서
AI 레지스트리를 누릅니다. - 등록을 누른 다음 MCP 서버를 누릅니다.
- MCP 서버 끝점의 URL을 입력합니다.
- 유용한 표시 이름 및 설명을 입력합니다. 사용자와 에이전트는 이를 사용하여 MCP 서버의 목적을 식별합니다.
- 드롭다운 메뉴에서 전송 방법을 선택합니다.
- 선택 사항: MCP 서버에 보안 자격 증명이 필요한 경우 인증 필요를 선택합니다. 인증서 드롭다운 메뉴에서 인증서를 선택합니다.
- 계속을 누릅니다.
- 선택한 MCP 서버에 대해 포함된 도구 목록을 검토합니다. 개별적으로 포함할 도구를 선택하거나 모두 선택을 눌러 나열된 모든 도구를 포함합니다.
- 등록을 누릅니다.