HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

Show HN: SwiftでLangGraphを構築しました

Show HN: I Built LangGraph for Swift (github.com)

16 pointsby christkarani3 コメント

要約

Swarmは、Swiftでエージェントとマルチエージェントワークフローを構築するためのフレームワークです。Swiftのコンカレンシー安全性を活用し、コンパイル時の型安全なツール呼び出し、クラッシュからの復旧、多様な基盤モデルとの連携を可能にします。宣言的なエージェント仕様やスキル定義もサポートしており、iOS/macOS開発者にとってAIエージェント構築の強力な選択肢となります。

全文翻訳

Swarm

Swiftで本番レベルのAIエージェントを構築する。

Swarmは、タイプセーフなツール、オンデバイスのApple Foundation Models、コンポーザブルなワークフロー、メモリ、ガードレール、ストリーミングを備えた、Swiftネイティブのエージェントランタイムです。同じエージェントループでiOS、macOS、Linux向けに構築できます。

[画像: Swift 6.2] [画像: Platforms] [画像: License: MIT] [画像: SPM]

はじめに · 例を見る · GitHubで⭐スターをつける

import Swarm

@Tool("Looks up a stock price")
struct PriceTool {
    @Parameter("Ticker symbol") var ticker: String

    func execute() async throws -> String {
        "AAPL: $182.50"
    }
}

let agent = try Agent(
    "Answer finance questions using available tools.",
    configuration: .default.name("Analyst"),
    inferenceProvider: .foundationModels()
) {
    PriceTool()
}

let result = try await agent.run("What is AAPL trading at?")
print(result.output)

この例では、対応デバイスでApple Foundation Modelsを使用しています。Foundation Modelsが利用できない場合は、OpenAI互換プロバイダー、Ollama、モックプロバイダー、または決定論的な例を使用してください。

インストール

Swift Package ManagerでSwarmを追加します。

dependencies: [
    .package(
        url: "https://github.com/christopherkarani/Swarm.git",
        from: "0.6.6"
    )
]

デフォルトパッケージは軽量です。コアSwarm、Foundation Models、およびマクロが含まれます。軽量版は swift-syntax(デフォルトで有効なMacrosトレイト経由)と swift-log のみを解決します。MCP Swift SDKやOpenTelemetryは解決しません。オプションのサーフェスにはトレイトを追加してください。

// Durable graph, ContextCore/Wax memory, Membrane, web helpers
.package(
    url: "https://github.com/christopherkarani/Swarm.git",
    from: "0.6.6",
    traits: ["Integrations"]
)

// MCP server adapter (SwarmMCP + MCP Swift SDK). Also enables Macros.
.package(
    url: "https://github.com/christopherkarani/Swarm.git",
    from: "0.6.6",
    traits: ["MCP"]
)

// OpenTelemetry wrappers (SwarmOpenTelemetry). Also enables Macros.
.package(
    url: "https://github.com/christopherkarani/Swarm.git",
    from: "0.6.6",
    traits: ["OpenTelemetry"]
)

マクロはデフォルトで有効になっています。マクロフリービルドが必要な場合は、traits: [] を使用し、FunctionTool でツールを定義してください。トレイトを指定するとデフォルトが上書きされるため、必要に応じて組み合わせてください。例: traits: ["Integrations", "MCP", "OpenTelemetry"]。

なぜSwarmか

SwarmはSwift 6.2の厳密な並行処理を使用しているため、アクター境界を越える値はコンパイラのチェックを通過する必要があります。

Apple Foundation Modelsは、対応デバイスにオンデバイス推論パスを提供します。ローカルHTTPモデルやクラウドAPIが必要な場合、同じエージェントループでOllama、LM Studio、OpenAI互換プロバイダー、または独自のプロバイダーを使用できます。

@Tool マクロは、コンパイル時にSwift型からツールスキーマを生成します。マクロを使用しない場合は FunctionTool が利用可能です。

Workflow を使用すると、エージェントの作業をチェーン化、並列化、ルーティング、繰り返し、タイムアウトさせることができます。Job はもう一つのコンポジションツールです。これは共有のメモボックスとヘルパーで、それぞれに短い指示が与えられ、早期のステップの後に必要なヘルパーの数がわかった場合でも機能します。

ニーズ使用するもの
前のエージェントの回答を次のエージェントの入力にするWorkflow
共有メモ、異なる指示、ステップ後に決定されるN個のヘルパーJob

アプリケーションの成長に合わせて、メモリ、ガードレール、リトライ、フォールバック、ストリーミング、トレーシング、MCP、オプションのチェックポイント/再開機能を追加できます。

ワークフローの構築

エージェントは、シーケンシャル、パラレル、ルーティングされたワークフローに構成できます。

let researcher = try Agent(
    "Research the topic and extract key facts.",
    inferenceProvider: .foundationModels()
)

let writer = try Agent(
    "Write a concise summary from the research.",
    inferenceProvider: .foundationModels()
)

let result = try await Workflow()
    .step(researcher)
    .step(writer)
    .run("Latest advances in on-device ML")

ファンアウトとルーティングの場合:

let result = try await Workflow()
    .parallel([bullAgent, bearAgent, analystAgent], merge: .structured)
    .run("Evaluate Apple's Q4 earnings.")

let routed = try await Workflow()
    .route { input in
        input.contains("$") ? mathAgent : generalAgent
    }
    .run("What is 15% of $240?")

プロバイダー

すべてのエージェントは、プラグ可能な InferenceProvider を使用します。プロバイダーを変更しても、エージェントループは同じままです。プロバイダーを毎回渡したくない場合は、await Swarm.configure(provider:) でプロセス全体でデフォルトを設定できます。

プロバイダー使用するタイミング
Apple Foundation Modelsオンデバイス推論、.privateCloudCompute() を介したOS 27 PCC、画像添付ファイル、ネイティブプロファイルセッション、reasoningLevel を所有するループ、Transcript にシードされたSwarmプロファイル履歴、または Transcript の再水和をキャプチャしたい場合
Ollama または LM Studio開発またはプライベートデプロイメント用のローカルHTTPモデルが必要な場合
OpenAI, Azure, または OpenRouterOpenAI互換APIを介してクラウドモデルを使用したい場合
カスタムプロバイダー別のモデルバックエンドまたは内部サービスが必要な場合
let local = try Agent(
    "Be helpful.",
    inferenceProvider: .openAICompatible(.ollama(model: "llama3.2"))
)

設定とプライバシーの詳細については、Remote Providers を参照してください。

例

完全な例をコピーするか、APIキーやApple Intelligenceなしで決定論的なデモモードで実行してください。

例表示内容
OnDeviceChatツール、ストリーミング、マルチターンの会話
MultiAgentPipelineシーケンシャルおよびパラレルワークフロー、チェックポイント/再開機能
WaxChat永続的なメモリとWeb検索(Integrationsを使用)
CodeReviewerSwarm上に構築された小さなCLI
cd Examples/OnDeviceChat
swift run OnDeviceChat --demo

その他の機能

機能説明
会話とメモリConversation を使用してマルチターンの状態を保持します。会話、スライディングウィンドウ、ベクトル、要約、またはハイブリッドメモリを選択できます。セッションはポータブルなJSONまたは FileSession ファイルにスナップショットされます。
弾力性バックオフと Retry-After、サーキットブレーカー、レート制限、FailoverProvider チェーン、ツールループ検出によるリトライ。
ガードレールアプリケーションに到達する前に、入力、出力、ツール引数を検証します。
ストリーミングAsyncThrowingStream を介して、ライフサイクル、ツール、思考、出力イベントを監視します。
弾力性プロバイダー推論のリトライ(maxAttempts は合計試行回数をカウントし、最小値は1)、サーキットブレーカー、レート制限、フォールバックチェーン。
永続的な実行Integrations トレイトが有効な場合、ワークフローの進行状況をチェックポイントし、プロセス再起動後に再開します。
MCPModel Context Protocolツールを発見し、ブリッジします。
可観測性OpenTelemetryまたはSwiftロギングを使用して、エージェントおよび推論トレースをエクスポートします。

要件

プラットフォーム最小バージョン
Swift6.2+
iOS / macOS / tvOS26.0+
LinuxUbuntu 22.04+ (Swift 6.2)

Foundation Modelsおよび一部のプラットフォーム統合はApple専用です。Integrationsメモリ/Membraneスタックは、Linux上でポータブルCPU/ハッシュバックエンド(Metal/CoreML/MetalANNSはAppleで高速化)で構築されます。デフォルトのSwarmグラフは、UbuntuでSwift 6.2を使用してCIテストされています。Foundation Models、SwiftData、OSLog、および一部の組み込みツール動作などのApple専用機能は、Linuxでは利用できないか、異なります。OpenAI互換プロバイダーを使用するか、モックを注入するか、決定論的な例を実行してください。

デフォルトグラフのプロバイダーをグローバルに設定するには:

await Swarm.configure(provider: myProvider)

ドキュメント

ガイド内容
Getting Startedインストールと最初のエージェント
Why Swarm?設計上の選択とアーキテクチャ
Remote ProvidersOpenAI, Azure, OpenRouter, Ollama, LM Studio
Secret StorageKeychainベースのAPIキー、マスキング、チェックポイントファイルパーミッション
Foundation Modelsキャプチャモードとネイティブセッションモード
Voice既存のエージェントをラップするターンベースの VoiceSession
Durable Executionチェックポイントと再開のセマンティクス、実行検査、チェックポイントからのフォーク
OpenTelemetry Tracingトレースと伝播
Front-Facing API公開APIの概要
API Catalog完全なシンボルリファレンス

貢献

./scripts/ci/lean-build-test.sh
swiftformat Sources Tests --lint --config .swiftformat

すべての公開型は Sendable であることが期待されます。バグレポートと機能リクエストはGitHub Issuesに投稿してください。

Swarmがあなたの開発に役立った場合は、リポジトリにスターをつけて、何を作ったか共有してください。

コミュニティとライセンス

ディスカッション · @ckarani7 · MIT License