Juicebox Hello World

概要

Juicebox AIを使用して人物検索を行うための最小限の動作例を作成します。

前提条件

• Juicebox SDKがインストール済み（juicebox-install-authが完了）
• 有効なAPIキーが設定済み
• Node.jsまたはPython環境

手順

ステップ1: 検索スクリプトを作成

// search.ts
import { JuiceboxClient } from '@juicebox/sdk';

const client = new JuiceboxClient({
  apiKey: process.env.JUICEBOX_API_KEY
});

async function searchPeople() {
  const results = await client.search.people({
    query: 'software engineer at Google',
    limit: 5
  });

  console.log(`Found ${results.total} people`);
  results.profiles.forEach(profile => {
    console.log(`- ${profile.name} | ${profile.title} at ${profile.company}`);
  });
}

searchPeople();

ステップ2: 検索を実行

npx ts-node search.ts

ステップ3: 出力を確認

想定される出力:

Found 150 people
- Jane Smith | Senior Software Engineer at Google
- John Doe | Staff Engineer at Google
- ...

出力結果

• 動作する検索スクリプト
• 検索結果を含むコンソール出力
• 名前、職位、企業を含むプロフィールデータ

エラーハンドリング

エラー	原因	解決方法
結果なし	クエリが具体的すぎる	検索条件を広げる
タイムアウト	結果セットが大きい	limitパラメータを追加
無効なクエリ	構文エラー	クエリ形式を確認

例

Pythonの例

from juicebox import JuiceboxClient
import os

client = JuiceboxClient(api_key=os.environ.get('JUICEBOX_API_KEY'))

results = client.search.people(
    query='product manager in San Francisco',
    limit=10
)

for profile in results.profiles:
    print(f"- {profile.name} | {profile.title}")

高度な検索

const results = await client.search.people({
  query: 'senior engineer',
  filters: {
    location: 'New York',
    company_size: '1000+',
    experience_years: { min: 5 }
  },
  limit: 20
});

リソース

• Search API Reference
• Query Syntax Guide

次のステップ

最初の検索を実行した後、本番環境対応のコードについてはjuicebox-sdk-patternsを探索してください。