AI Hub

조직과 모델·에이전트를 공유하는 방법을 알아봐요. 개발자들이 다시 만들 필요 없이 어떤 것이 사용 가능한지 보여줘요.

출처: 문서

본문

이 기능은 v1.74.3-stable 이상에서 사용 가능해요.

개요

관리자는 공개 AI hub에 노출할 모델·에이전트를 선택할 수 있고 → 사용자는 공개 URL로 가서 무엇이 사용 가능한지 볼 수 있어요.

모델

사용법

1. Admin UI로 이동

Admin UI의 Model Hub 페이지로 이동해요 (PROXY_BASE_URL/ui/?login=success&page=model-hub-table)

2. 노출할 모델 선택

Select Models to Make Public을 클릭하고 노출할 모델을 선택해요.

3. 변경 사항 확인

4. 완료!

공개 URL(PROXY_BASE_URL/ui/model_hub_table)로 가서 사용 가능한 모델을 확인해요.

API 엔드포인트

GET /public/model_hub – 공개 모델 그룹 목록 반환. 유효한 사용자 API 키 필요.
GET /public/model_hub/info – 공개 모델 허브의 메타데이터(문서 제목, 버전, 유용한 링크) 반환.

에이전트

info: 에이전트는 v1.79.4-stable 이상에서만 사용 가능해요.

조직 전체에 사전 구축된 에이전트(A2A spec)를 공유해요. 사용자들은 재구축 없이 에이전트를 발견하고 사용할 수 있어요.

1. 에이전트 생성

A2A spec을 따르는 에이전트를 만들어요.

curl -X POST 'http://0.0.0.0:4000/v1/agents' \
--header 'Authorization: *** ' \
--header 'Content-Type: application/json' \
--data '{
  "agent_name": "hello-world-agent",
  "agent_card_params": {
    "protocolVersion": "1.0",
    "name": "Hello World Agent",
    "description": "Just a hello world agent",
    "url": "http://localhost:9999/",
    "version": "1.0.0",
    "defaultInputModes": ["text"],
    "defaultOutputModes": ["text"],
    "capabilities": {
      "streaming": true
    },
    "skills": [
      {
        "id": "hello_world",
        "name": "Returns hello world",
        "description": "just returns hello world",
        "tags": ["hello world"],
        "examples": ["hi", "hello world"]
      }
    ]
  }
}'

예상 응답:

{
  "agent_id": "123e4567-e89b-12d3-a456-426614174000",
  "agent_name": "hello-world-agent",
  "agent_card_params": {
    "protocolVersion": "1.0",
    "name": "Hello World Agent",
    "description": "Just a hello world agent",
    "url": "http://localhost:9999/",
    "version": "1.0.0",
    "defaultInputModes": ["text"],
    "defaultOutputModes": ["text"],
    "capabilities": {
      "streaming": true
    },
    "skills": [
      {
        "id": "hello_world",
        "name": "Returns hello world",
        "description": "just returns hello world",
        "tags": ["hello world"],
        "examples": ["hi", "hello world"]
      }
    ]
  },
  "created_at": "2025-11-15T10:30:00Z",
  "created_by": "user123"
}

2. 에이전트 공개

AI Hub에서 에이전트를 발견 가능하게 만들어요. AI Hub 페이지의 Agents 탭으로 이동해 공개할 에이전트를 선택하고 Make Public 버튼을 클릭해요.

옵션 1: 단일 에이전트 공개

curl -X POST 'http://0.0.0.0:4000/v1/agents/123e4567-e89b-12d3-a456-426614174000/make_public' \
--header 'Authorization: *** ' \
--header 'Content-Type: application/json'

옵션 2: 여러 에이전트 공개

curl -X POST 'http://0.0.0.0:4000/v1/agents/make_public' \
--header 'Authorization: *** ' \
--header 'Content-Type: application/json' \
--data '{
  "agent_ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "123e4567-e89b-12d3-a456-426614174001"
  ]
}'

예상 응답:

{
  "message": "Successfully updated public agent groups",
  "public_agent_groups": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "updated_by": "user123"
}

3. 공개 에이전트 보기

사용자는 이제 공개 엔드포인트로 에이전트를 발견할 수 있어요.

curl -X GET 'http://0.0.0.0:4000/public/agent_hub' \
--header 'Authorization: *** '

예상 응답:

[
  {
    "protocolVersion": "1.0",
    "name": "Hello World Agent",
    "description": "Just a hello world agent",
    "url": "http://localhost:9999/",
    "version": "1.0.0",
    "defaultInputModes": ["text"],
    "defaultOutputModes": ["text"],
    "capabilities": {
      "streaming": true
    },
    "skills": [
      {
        "id": "hello_world",
        "name": "Returns hello world",
        "description": "just returns hello world",
        "tags": ["hello world"],
        "examples": ["hi", "hello world"]
      }
    ]
  }
]

MCP 서버

사용법

1. MCP 서버 추가

지침은 MCP 개요를 참고해요.

2. MCP 서버 공개

AI Hub 페이지로 이동해 MCP 탭을 선택해요 (PROXY_BASE_URL/ui/?login=success&page=mcp-server-table)

curl -L -X POST 'http://localhost:4000/v1/mcp/make_public' \
-H "Authorization: Bearer ***" \
-H 'Content-Type: application/json' \
-d '{"mcp_server_ids":["e856f9a3-abc6-45b1-9d06-62fa49ac293d"]}'

3. 공개 MCP 서버 보기

사용자는 이제 공개 엔드포인트(PROXY_BASE_URL/ui/model_hub_table)로 MCP 서버를 발견할 수 있어요.

curl -L -X GET 'http://0.0.0.0:4000/public/mcp_hub' \
-H "Authorization: Bearer ***"

예상 응답:

[
    {
        "server_id": "e856f9a3-abc6-45b1-9d06-62fa49ac293d",
        "name": "deepwiki-mcp",
        "alias": null,
        "server_name": "deepwiki-mcp",
        "url": "https://mcp.deepwiki.com/mcp",
        "transport": "http",
        "spec_path": null,
        "auth_type": "none",
        "mcp_info": {
            "server_name": "deepwiki-mcp",
            "description": "free mcp server "
        }
    }
]

더 알아보기 (Learn more)

Admin UI 모델 관리
에이전트 관리
MCP 개요