AgentSkillsCN

juicebox-hello-world

创建一个Minimal Working Juicebox示例。 在开始使用Juicebox、创建你的第一个搜索，或测试基本人员搜索功能时使用。 可通过诸如“juicebox hello world”、“first juicebox search”、“simple juicebox example”、“test juicebox”等短语触发。

SKILL.md
--- frontmatter
name: juicebox-hello-world
description: |
  Create a minimal working Juicebox example.
  Use when getting started with Juicebox, creating your first search,
  or testing basic people search functionality.
  Trigger with phrases like "juicebox hello world", "first juicebox search",
  "simple juicebox example", "test juicebox".
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>

Juicebox Hello World

Overview

Create a minimal working example to search for people using Juicebox AI.

Prerequisites

  • •Juicebox SDK installed (juicebox-install-auth completed)
  • •Valid API key configured
  • •Node.js or Python environment

Instructions

Step 1: Create Search Script

typescript
// 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();

Step 2: Run the Search

bash
npx ts-node search.ts

Step 3: Verify Output

Expected output:

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

Output

  • •Working search script
  • •Console output with search results
  • •Profile data including name, title, company

Error Handling

ErrorCauseSolution
Empty ResultsQuery too specificBroaden search terms
TimeoutLarge result setAdd limit parameter
Invalid QueryMalformed syntaxCheck query format

Examples

Python Example

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}")

Advanced Search

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

Resources

Next Steps

After your first search, explore juicebox-sdk-patterns for production-ready code.