Translation Not Available Yet

 

     

Discord · 𝕏 · LinkedIn

🎉 発表: Julep Open Responses API (アルファ版)

Julepは、データおよびMLチームが高度なAIワークフローを構築するのを支援するサーバーレスプラットフォームです。複雑なAI操作のオーケストレーション、インタラクション間の状態管理、既存のデータインフラやツールとの統合のための堅牢な基盤を提供します。

データパイプラインを構築する場合でもAIワークフローを作成する場合でも、Julepはインフラ管理なしでLLM駆動のワークフローを構成・スケールすることを容易にします。単純な質問に答えるだけでなく、複雑なタスクを処理し、過去のインタラクションを記憶し、他のツールやAPIを使用する必要があるAIエージェントを構築したい場合、Julepが役立ちます。私たちのプラットフォームが重労働を処理するので、ビジネス向けのインテリジェントなソリューション構築に集中できます。

💡 Julepの詳細については、**ドキュメント**をご覧ください。

📖 目次

• ✨ 主な機能
• 🧠 メンタルモデル
• 📦 インストール
  • 🛠️ Julep SDK
  • 🛠️ Julep CLI
• 🚀 クイックスタート
  • 次は何をすればよいですか？
• 🔍 リファレンス
  • 📚 SDKリファレンス
  • 🛠️ APIリファレンス
• 💻 ローカルセットアップ
  • 1. リポジトリをクローン
  • 2. ルートディレクトリに移動
  • 3. 環境変数を設定
  • 4. バックアップ用Dockerボリュームを作成
  • 5. Docker Composeでプロジェクトを実行
  • 6. インタラクション
  • 7. トラブルシューティング
• 👥 コントリビューター
  • コミュニティに参加しましょう！ 🌟
• 📄 ライセンス

✨ 主な機能

💡 Julepの詳細については、**ドキュメント**をご覧ください。

🧠 メンタルモデル

Julepは以下のコンポーネントで構成されています:

• Julepプラットフォーム: ワークフローを実行するクラウドサービス。ワークフローを記述する言語、それらを実行するサーバー、プラットフォームと対話するためのSDKが含まれます。
• Julep SDK: ワークフローを構築するためのライブラリセット。PythonとJavaScript用のSDKがあり、さらに増える予定です。
• Julep CLI: ターミナルから直接Julepプラットフォームと対話できるコマンドラインツール。
• Julep API: Julepプラットフォームと対話するためのRESTful API。

Julepを、高度なAIエージェントを構築するためにクライアントサイドとサーバーサイドの両方のコンポーネントを組み合わせたプラットフォームと考えてください。以下のように視覚化できます:

1. アプリケーションコード:

   • アプリケーションでJulep SDKを使用してエージェント、タスク、ワークフローを定義できます。
   • SDKはこれらのコンポーネントを設定・管理するための関数とクラスを提供します。
   • Julep CLIを使用して、ターミナルから直接Julepプラットフォームと対話できます。

2. Julepバックエンドサービス:

   • SDKはネットワーク経由でJulepバックエンドと通信します。
   • CLIはSDK経由でJulepバックエンドと通信します。
   • バックエンドはタスクの実行、セッション状態の維持、ドキュメントの保存、ワークフローのオーケストレーションを処理します。

3. ツールとAPIとの統合:

   • ワークフロー内で外部ツールやサービスを統合できます。
   • バックエンドはこれらの統合を容易にし、エージェントがWeb検索、データベースアクセス、サードパーティAPI呼び出しなどを実行できるようにします。

📦 インストール

  npm install @julep/sdk

  # or

  bun add @julep/sdk

  pip install julep

🛠️ Julep CLI

Julep CLIは、ターミナルから直接Julepプラットフォームと対話できるコマンドラインツールです。コードを書く必要なく、AIワークフロー、タスク、エージェントを管理する便利な方法を提供します。

pip install julep-cli

詳細については、**Julep CLIドキュメント**を確認してください。

[!NOTE] CLIは現在ベータ版で、Pythonのみ利用可能です。Node.jsサポートは近日公開予定！

🚀 クイックスタート

以下のことができるリサーチAIエージェントを想像してください:

1. トピックを受け取り、
2. そのトピックに関する30の検索クエリを作成、
3. それらのWeb検索を並列実行、
4. 結果を要約、
5. 要約をDiscordに送信。

[!NOTE] Julepでは、これは80行未満のコードの単一タスクであり、完全に管理された状態で単独で実行されます。すべてのステップはJulepのサーバー上で実行され、ユーザーは何もする必要がありません。

以下はタスク定義の完全な例です:

# yaml-language-server: $schema=https://raw.githubusercontent.com/julep-ai/julep/refs/heads/dev/schemas/create_task_request.json
name: Research Agent
description: A research assistant that can search the web and send the summary to Discord
########################################################
####################### INPUT ##########################
########################################################

# Define the input schema for the task
input_schema:
  type: object
  properties:
    topic:
      type: string
      description: The main topic to research
    num_questions:
      type: integer
      description: The number of search queries to generate

########################################################
####################### TOOLS ##########################
########################################################

# Define the tools that the agent can use
tools:
  - name: web_search
    type: integration
    integration:
      provider: brave
      setup:
        api_key: "<your-brave-api-key>"

  - name: discord_webhook
    type: api_call
    api_call:
      url: https://discord.com/api/webhooks/<your-webhook-id>/<your-webhook-token>
      method: POST
      headers:
        Content-Type: application/json

########################################################
####################### MAIN WORKFLOW #################
########################################################

# Special variables:
# - steps[index].input: for accessing the input to the step at that index
# - steps[index].output: for accessing the output of the step at that index
# - _: for accessing the output of the previous step

# Define the main workflow
main:
# Step 0: Generate search queries
- prompt:
    - role: system
      content: >-
        $ f"""
        You are a research assistant.
        Generate {{steps[0].input.num_questions|default(30, true)}} diverse search queries related to the topic:
        {steps[0].input.topic}

        Write one query per line.
        """
  unwrap: true

# Step 1: Evaluate the search queries using a simple python expression
- evaluate:
    search_queries: $ _.split(NEWLINE)

# Step 2: Run the web search in parallel for each query
- over: $ _.search_queries
  map:
    tool: web_search
    arguments:
      query: $ _
  parallelism: 5

# Step 3: Collect the results from the web search
- evaluate:
    search_results: $ _

# Step 4: Summarize the results
- prompt:
    - role: system
      content: >
        $ f"""
        You are a research summarizer. Create a comprehensive summary of the following research results on the topic {steps[0].input.topic}.
        The summary should be well-structured, informative, and highlight key findings and insights. Keep the summary concise and to the point.
        The length of the summary should be less than 150 words.
        Here are the search results:
        {_.search_results}
        """
  unwrap: true
  settings:
    model: gpt-4o-mini

# Step 5: Send the summary to Discord
- evaluate:
    discord_message: |-
      $ f'''
      **Research Summary for {steps[0].input.topic}**
      {_}
      '''

# Step 6: Send the summary to Discord
- tool: discord_webhook
  arguments:
    json_: 
      content: $ _.discord_message[:2000] # Discord has a 2000 character limit

以下はJulep SDKを使用して上記のワークフローを実行する方法です:

from julep import Client
import yaml
import time

# Initialize the client
client = Client(api_key=JULEP_API_KEY)

# Create the agent
agent = client.agents.create(
  name="Julep Browser Use Agent",
  description="A Julep agent that can use the computer tool to interact with the browser.",
)

# Load the task definition
with open('./research_agent.yaml', 'r') as file:
  task_definition = yaml.safe_load(file)

# Create the task
task = client.tasks.create(
  agent_id=agent.id,
  **task_definition
)

# Create the execution
execution = client.executions.create(
    task_id=task.id,
    input={
        "topic": "artificial intelligence",
        "num_questions": 30
    }
)

# Wait for the execution to complete
while (result := client.executions.get(execution.id)).status not in ['succeeded', 'failed']:
    print(result.status)
    time.sleep(1)

# Print the result
if result.status == "succeeded":
    print(result.output)
else:
    print(f"Error: {result.error}")

import { Julep } from '@julep/sdk';
import yaml from 'yaml';
import fs from 'fs';

// Initialize the client
const client = new Julep({
  apiKey: 'your_julep_api_key'
});

// Create the agent
const agent = await client.agents.create({
  name: "Julep Browser Use Agent",
  description: "A Julep agent that can use the computer tool to interact with the browser.",
});

// Parse the task definition
const taskDefinition = yaml.parse(fs.readFileSync('./research_agent.yaml', 'utf8'));

// Create the task
const task = await client.tasks.create(
  agent.id,
  taskDefinition
);

// Create the execution
const execution = await client.executions.create(
  task.id,
  {
    input: { 
      "topic": "artificial intelligence",
      "num_questions": 30
    }
  }
);

// Wait for the execution to complete
let result;
while (true) {
  result = await client.executions.get(execution.id);
  if (result.status === 'succeeded' || result.status === 'failed') break;
  console.log(result.status);
  await new Promise(resolve => setTimeout(resolve, 1000));
}

// Print the result
if (result.status === 'succeeded') {
  console.log(result.output);
} else {
  console.error(`Error: ${result.error}`);
}

この例では、Julepは自動的に並列実行を管理し、失敗したステップを再試行し、APIリクエストを再送信し、タスクが確実に完了するまで実行し続けます。

これは30秒未満で実行され、以下の出力を返します:

次は何をすればよいですか？

• 📚 クックブックでさらに多くの例を探索
• 🔧 ツール統合について学ぶ
• 🧠 エージェントメモリを理解
• 🔄 複雑なワークフローに深く入る

[!TIP] 💡 ドキュメントのチュートリアルセクションでさらに多くのチュートリアルをチェックしてください。

💡 初心者の方は、クイックスタートガイドから始めることをお勧めします。

💡 さらにアイデアが必要な場合は、リポジトリのアイデアセクションをチェックしてください。

💡 クックブックスタイルのレシピに興味がある場合は、リポジトリのクックブックセクションをチェックしてください。

🔍 リファレンス

📚 SDKリファレンス

• Node.js SDKリファレンス | NPMパッケージ
• Python SDKリファレンス | PyPIパッケージ

🛠️ APIリファレンス

エージェント、タスク、ツール、Julep CLIに関する詳細は、APIドキュメントを参照してください: APIリファレンス

💻 ローカルセットアップ

1. リポジトリをクローン

希望するソースからリポジトリをクローン:

git clone <repository_url>

2. ルートディレクトリに移動

プロジェクトのルートディレクトリに移動:

cd <repository_root>

3. 環境変数を設定

• ルートディレクトリに.envファイルを作成
• 必要な変数のリストについては.env.exampleファイルを参照
• .envファイルですべての必要な変数が設定されていることを確認

4. バックアップ用Dockerボリュームを作成

grafana_data、memory_store_data、temporal-db-data、prometheus_data、seaweedfs_dataという名前のDockerボリュームを作成:

docker volume create grafana_data
docker volume create memory_store_data
docker volume create temporal-db-data
docker volume create prometheus_data
docker volume create seaweedfs_data

5. Docker Composeでプロジェクトを実行

シングルテナントまたはマルチテナントの2つのモードでプロジェクトを実行できます。要件に基づいて以下のいずれかのコマンドを選択:

1. シングルテナントモード

シングルテナントモードでプロジェクトを実行:

docker compose --env-file .env --profile temporal-ui --profile single-tenant --profile self-hosted-db --profile blob-store --profile temporal-ui-public up --build --force-recreate --watch

注: シングルテナントモードでは、APIキーなしで直接SDKと対話できます。

2. マルチテナントモード

マルチテナントモードでプロジェクトを実行:

docker compose --env-file .env --profile temporal-ui --profile multi-tenant --profile embedding-cpu --profile self-hosted-db --profile blob-store --profile temporal-ui-public up --force-recreate --build --watch

注: マルチテナントモードでは、SDKと対話するためにAPIキーとして機能するJWTトークンをローカルで生成する必要があります。

JWTトークンの生成(マルチテナントモードのみ)

JWTトークンを生成するには、jwt-cliが必要です。次の手順に進む前にインストールしてください。

以下のコマンドを使用し、.envファイルの対応するキーでJWT_SHARED_KEYを置き換えてJWTトークンを生成:

jwt encode --secret JWT_SHARED_KEY --alg HS512 --exp=$(date -d '+10 days' +%s) --sub '00000000-0000-0000-0000-000000000000' '{}'

このコマンドは10日間有効なJWTトークンを生成します。

6. インタラクション

• Temporal UI: .envファイルで指定されたポートからTemporal UIにアクセス可能
• Julep SDK: Julep SDKはJulep APIと対話できるPython/Node.jsライブラリ

from julep import Client

client = Client(api_key="your_jwt_token")

注: マルチテナントモードのSDKでは、SDKと対話するためにAPIキーとして機能するJWTトークンをローカルで生成する必要があります。さらに、クライアントを初期化する際に、環境をlocal_multi_tenantに設定し、APIキーを前のステップで生成したJWTトークンに設定する必要があります。一方、シングルテナントモードでは、APIキーなしで直接SDKと対話でき、環境をlocalに設定します。

7. トラブルシューティング

• 必要なすべてのDockerイメージが利用可能であることを確認
• .envファイルで不足している環境変数をチェック
• デバッグにはdocker compose logsコマンドを使用して詳細なログを表示

👥 コントリビューター

コミュニティに参加しましょう！ 🌟

Julepプロジェクトに新しいコントリビューターを迎えることを楽しみにしています！始めやすいように「good first issues」をいくつか作成しました。

貢献方法:

1. 📖 CONTRIBUTING.mdファイルでガイドラインを確認
2. 🔍 good first issuesを閲覧
3. 💬 Discordに参加してヘルプやディスカッション

大小を問わず、あなたの貢献は私たちにとって貴重です。一緒に素晴らしいものを作りましょう！ 🚀

私たちの素晴らしいコントリビューター:

📄 ライセンス

Julep は Apache License 2.0 のもとでライセンスされています。

詳細については LICENSE ファイルをご覧ください。