Nimble 검색

Nimble 검색을 LiteLLM /search 엔드포인트에서 사용하는 방법을 안내할게요. LiteLLM v1.98.0+부터 지원돼요.

출처: 문서

본문

API 키 받기: https://online.nimbleway.com/settings/api-keys

info

LiteLLM v1.98.0+부터 지원돼요.

LiteLLM Python SDK

Nimble Search

import os
from litellm import search

os.environ["NIMBLE_API_KEY"] = "..."

response = search(
    query="latest AI developments",
    search_provider="nimble",
    max_results=5
)

LiteLLM AI Gateway

1. config.yaml 설정

config.yaml

model_list:
  - model_name: gpt-5.6
    litellm_params:
      model: gpt-5.6
      api_key: os.environ/OPENAI_API_KEY

search_tools:
  - search_tool_name: nimble-search
    litellm_params:
      search_provider: nimble
      api_key: os.environ/NIMBLE_API_KEY

2. 프록시 시작

litellm --config /path/to/config.yaml

# RUNNING on http://0.0.0.0:4000

3. 검색 엔드포인트 테스트

Test Request

curl http://0.0.0.0:4000/v1/search/nimble-search \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest AI developments",
    "max_results": 5
  }'

제공자별 파라미터

Nimble Search with Provider-specific Parameters

import os
from litellm import search

os.environ["NIMBLE_API_KEY"] = "..."

response = search(
    query="latest tech news",
    search_provider="nimble",
    max_results=5,
    # Nimble-specific parameters
    focus="news",                    # 'serp', 'general', 'news', 'location', 'coding',
                                     # 'academic', 'geo', 'shopping', 'social'
    search_depth="deep",             # 'lite', 'fast', 'deep' ('fast' needs focus='general')
    time_range="week",               # 'hour', 'day', 'week', 'month', 'year'
    output_format="markdown"         # 'plain_text', 'markdown', 'simplified_html'
)

도메인은 통합 search_domain_filter(여기서 - 접두어는 호스트를 제외) 또는 Nimble 자체의 include_domains/exclude_domains(둘 다 주어지면 이게 우선)로 제한할 수 있어요. content_type, start_date, end_date를 포함한 전체 파라미터 세트는 Nimble Search API 레퍼런스를 참고하세요.

기본 https://sdk.nimbleway.com/v2 엔드포인트를 재정의하려면 NIMBLE_API_BASE를 설정하세요.

더 알아보기 (Learn more)