Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

TrueFoundry への Agno Agent のデプロイ

Updated: November 3, 2026

Published: July 2, 2026

このガイドでは、最小限の DevOps や MLOps の専門知識で AI デプロイをシンプルにするために設計されたプラットフォームである TrueFoundry に Agno agent をデプロイする方法を説明します。TrueFoundry はインフラストラクチャ管理、スケーリング、モニタリングを自動化するため、デプロイの複雑さに対応するのではなく、インサイトの抽出に集中できます。わずか数クリックで、自然言語のリクエストを SQL クエリや動的なチャートに変換し、データ探索をシームレスかつインテリジェントに行うことができます。手動でのクエリ作成は不要です!

これを直接試してみたい方は、TrueFoundry プラットフォームにアクセスし、Live Demos から agno-Streamlit(agent ワークフローのライブデモ)に移動してください。

アーキテクチャの概要

このプロジェクトは、連携して動作するいくつかの主要コンポーネントで構成されています。

Query Agent

  • 自然言語理解に GPT-4o を使用
  • ClickHouse 用の適切な SQL クエリを生成
  • 事前設定された SQL database に対して SQL クエリを実行
  • visualization agent への入力としてデータを表形式で返却

Visualization Agent: 以下の処理を行う2つ目の AI agent

  • データを基に最も適切な可視化タイプを決定
  • matplotlib/seaborn を使用してプロットを生成
  • 可視化のフォーマットとスタイリングを処理

FastAPI Backend: 以下の機能を持つ RESTful API

  • agno を使用して agent 間の連携を制御
  • 非同期ジョブ処理を管理
  • プロット画像と結果を提供

Streamlit Frontend: 以下の機能を持つユーザーインターフェース

  • 直感的なクエリインターフェースを提供
  • リアルタイムの処理ステータスを表示
  • インタラクティブな可視化を表示

データフロー

ユーザーが Streamlit を通じて自然言語のクエリを送信します。

  • Query Agent が GPT-4o 搭載の agno を使用して ClickHouse 用の SQL クエリを生成
  • ClickHouse データベースに対して SQL クエリを実行
  • 結果が表形式で返され、Visualization Agent への入力となる
  • Visualization Agent が可視化を生成し、表示用の画像を返却

はじめに

リポジトリのクローン

まず、TrueFoundry Getting Started Examples リポジトリに移動し、クローンを作成します。

agno Plot Agent ディレクトリへの移動:

環境のセットアップ

仮想環境を作成して有効化します。

依存関係のインストール:

環境変数の設定

.env ファイルを作成します。

‍
注: TrueFoundry LLM Gateway を使用する場合、モデル ID のフォーマットは provider-name/model-name(例: openai-main/gpt-4o)にする必要があります。.env ファイルに、環境設定セクションに示されている正しい LLM Gateway 認証情報が含まれていることを確認してください。

ClickHouse の認証情報を取得するには、clickhouse でアカウントを作成してサインインし、サービスを作成します。サービスをクリックすると、左サイドバーの中央に「Connect」ボタンが表示され、クリックすると以下に示す認証情報を確認できます。ファイルをアップロードしてデータベースを作成することも、事前定義されたデータベースを使用することもできます。

Agno Agent の実装

サービスの実行

agno ワークフローの開始

FastAPI バックエンドの開始:

Streamlit UI の開始(新しいターミナル):

TrueFoundry へのデプロイ

前提条件

TrueFoundry CLI のインストール:

TrueFoundry へのログイン:

デプロイ手順

  1. TrueFoundry の Deployments セクションに移動します。
  1. 下部にある Service をクリックします。
  2. クラスタのワークスペースを選択します。
  3. ノート PC、GitHub、または Docker からデプロイできます。ノート PC からデプロイする場合は、上記の前提条件を完了していることを確認してください。
  4. TrueFoundry プラットフォームは deploy.py ファイルを生成し、プロジェクトに追加します。このファイルを編集して環境変数を追加する必要があります。生成されたファイル内の env セクションを見つけ、認証情報を追加します。
  5. 生成された deploy.py を使用し、env セクションを編集します。

デプロイのテスト

テストクエリの送信:

成功レスポンスの例:

API エンドポイント

  • クエリの送信:
  • クエリステータスの確認:
  • プロット画像の取得:

フロントエンドと CORS

FastAPI での CORS の設定:

Streamlit での環境変数の定義:

デプロイ後の注意事項

  • Streamlit から FastAPI への API 接続性をテストします。
  • Streamlit の .env ファイルを FastAPI エンドポイントで更新します。
  • CORS 設定が Streamlit からのリクエストを許可していることを確認します。

TrueFoundry を通じたデプロイメントの監視と管理:

  • ログの表示
  • リソース使用状況のモニタリング
  • オートスケーリング規則の設定
  • バックエンドのヘルスチェック(/health)、API ドキュメント(/docs)、および /metrics でのメトリクスの確認

Agent へのトレースの追加

トレース機能を使用すると、agent の実行が呼び出されたときに内部で何が起こっているかを理解できます。TrueFoundry のトレース機能を使用すれば、わずか数行のコードを追加するだけで、agent 実行時のパス、呼び出されたツール、使用されたコンテキスト、レイテンシーを把握できます。

以下をインストールする必要があります

次に、トレースを有効にするための必要な環境変数を追加します

agent を定義しているコードベース内で、トレースを有効にするには以下の行を追加するだけです

その後、以下のように agent やワークフローにデコレータを追加します

以上の手順により、agno agent ワークフローが TrueFoundry 上に正常にデプロイされました!

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
Guide to Langgraph vs Langchain
November 16, 2026
|
5 min read

LangChain vs LangGraph:どちらが最適か?

比較
A detailed guide on Claude Fable 5
November 16, 2026
|
5 min read

Claude Fable 5: API、ベンチマーク、料金、使い方

エンジニアリングとプロダクト
openrouter vs litellm
November 16, 2026
|
5 min read

LiteLLMとOpenRouter:あなたに最適なのはどちらか?

比較
November 16, 2026
|
5 min read

大規模言語モデルにおけるトランスフォーマーアーキテクチャ

LLM用語
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour