Agno を使用して最初のエージェントを構築して実行します。エージェントは、言語モデルが実行フローを制御する AI プログラムです。
Agno 2.0 が AgentOS 環境を新たに装備してリリースされました。Agno はマルチエージェント・システムのための高性能なランタイムで、クラウドでセキュアなマルチエージェント・システムを構築・実行・管理できます。
Agno 2.0 : イントロダクション : クイックスタート – AgentOS の実行
作成 : クラスキャット・セールスインフォメーション
作成日時 : 09/13/2025
バージョン : Agno 2.0.3
* 本記事は docs.agno.com の以下のページを独自に翻訳した上で、補足説明を加えてまとめ直しています。スニペットはできる限り日本語を使用しています :
* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。
* ご自由にリンクを張って頂いてかまいませんが、sales-info@classcat.com までご一報いただけると嬉しいです。
Agno 2.0 : イントロダクション : クイックスタート – AgentOS の実行
Agno を使用して最初のエージェントを構築して実行します。
エージェントは、言語モデルが実行フローを制御する AI プログラムです。
10 行のコードで、ユーザ入力と利用可能なツールに基づいてアクションを実行するエージェントを構築できます。このエージェントは HackerNews からトップ・ストーリーを取得してそれらを要約します。
hackernews_agent.py
from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools.hackernews import HackerNewsTools
agent = Agent(
model=Claude(id="claude-sonnet-4-0"),
tools=[HackerNewsTools()],
markdown=True,
)
agent.print_response("Summarize the top 5 stories on hackernews", stream=True)
最初のエージェントの構築
toy デモの代わりに、拡張・構築可能なエージェントを構築しましょう。エージェントを MCP サーバ経由で Agno のドキュメントに接続し、会話履歴と状態を保存するデータベースを提供します。
これは単純ですが、任意の MCP サーバに接続することで拡張可能な完全な例です。
agno_agent.py
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os import AgentOS
from agno.tools.mcp import MCPTools
# Create the Agent
agno_agent = Agent(
name="Agno Agent",
model=Claude(id="claude-sonnet-4-0"),
# Add a database to the Agent
db=SqliteDb(db_file="agno.db"),
# Add the Agno MCP server to the Agent
tools=[MCPTools(transport="streamable-http", url="https://docs.agno.com/mcp")],
# Add the previous session history to the context
add_history_to_context=True,
markdown=True,
)
# Create the AgentOS
agent_os = AgentOS(agents=[agno_agent])
# Get the FastAPI app for the AgentOS
app = agent_os.get_app()
AgentOS の実行
AgentOS は、エージェントのサービス提供、監視と管理のためにすぐに利用できる API エンドポイントを備えた FastAPI アプリケーションを提供します。実行してみましょう。
- 仮想環境のセットアップ
uv venv --python 3.12 source .venv/bin/activate - 依存関係のインストール
uv pip install -U agno anthropic mcp 'fastapi[standard]' sqlalchemy - Anthropic API キーのエクスポート
export ANTHROPIC_API_KEY=sk-*** - AgentOS の実行
fastapi dev agno_agent.pyThis will start your AgentOS on http://localhost:8000
AgentOS に接続
Agno は、AgentOS に接続する web インターフェイスを提供しています、それを使用してエージェント型システムを監視・管理・テストできます。os.agno.com を開いてアカウントにサインインしてください。
- 上部のナビゲーションバーの “Add AgentOS” をクリックします。
- “Local” を選択して、ユーザのマシンで動作しているローカルの AgentOS に接続ます。
- AgentOS のエンドポイント URL を入力します。デフォルトは http://localhost:8000 です。
- AgentOS に、“Development OS” や “Local 8000” のような説明的な名前を与えます。
- “Connect” をクリックします。
Once connected, you’ll see your new OS with a live status indicator.
エージェントとチャット
次に、エージェントとチャットしましょう、サイドバーの Chat セクションに進み、エージェントを選択します。
- 「Agno とは何ですか？」と質問すると、エージェントは Agno MCP サーバを使用して回答します。
- Agno は履歴、ツールと指示を保持します ; ユーザを切り替えてもコンテキストは混在しません。
出力例
▰▰▱▱▱▱▱ Thinking... ┏━ Message ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ┃ ┃ hackernews のトップ 5 ストーリーを要約してください。 ┃ ┃ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━ Tool Calls ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ┃ ┃ • get_top_hackernews_stories(num_stories=5) ┃ ┃ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ┏━ Response (19.2s) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ┃ ┃ Hacker Newsのトップ5ストーリーを取得して要約いたします。## Hacker News トップ5ストーリーの要約 ┃ ┃ ┃ ┃ 1. Qwen3-Next (140ポイント) ┃ ┃ ┃ ┃ • 最新のAIモデルQwen3-Nextに関する発表 ┃ ┃ • Qwen.aiブログでの研究開発の最新進歩について ┃ ┃ • 46のコメントが寄せられている ┃ ┃ ┃ ┃ 2. Examples from The LaTeX Companion book (3rd edition) (15ポイント) ┃ ┃ ┃ ┃ • LaTeX Companionの第3版に含まれる実例集 ┃ ┃ • CTANパッケージとして提供されている ┃ ┃ • LaTeX利用者向けの参考資料 ┃ ┃ ┃ ┃ 3. Float Exposed (230ポイント) ┃ ┃ ┃ ┃ • 浮動小数点数の内部構造を可視化するWebサイト ┃ ┃ • プログラミングにおける浮動小数点演算の理解に役立つツール ┃ ┃ • 53のコメントが付いており、技術的な議論が活発 ┃ ┃ ┃ ┃ 4. Debian 13, Postgres, and the US time zones (125ポイント) ┃ ┃ ┃ ┃ • Debian 13、PostgreSQL、そして米国のタイムゾーンに関する技術記事 ┃ ┃ • システム管理者やデータベース開発者に関連する内容 ┃ ┃ • 50のコメントで議論されている ┃ ┃ ┃ ┃ 5. Top model scores may be skewed by Git history leaks in SWE-bench (399ポイント - 最も人気) ┃ ┃ ┃ ┃ • SWE-benchにおけるGit履歴リークによるモデルスコアの歪みに関する問題 ┃ ┃ • AI/MLモデルの評価における重要な課題 ┃ ┃ • 125のコメントが寄せられており、最も注目を集めている記事 ┃ ┃ ┃ ┃ これらのストーリーは、AI技術、システム管理、プログラミングツール、データベース管理など、技術分野の幅広いトピッ ┃ ┃ クをカバーしています。 ┃ ┃ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
事前構築済み API エンドポイント
AgentOS により生成される FastAPI は、製品を構築するために使用できる、事前構築済み SSE 互換 API エンドポイントを備えています。独自のルート、ミドルウェアやその他の FastAPI 機能を追加することもできますが、これは優れた開始点です。
Checkout the API endpoints at /docs of your AgentOS url, e.g. http://localhost:8000/docs.
以上