既存の LongGraph エージェントの移行

SDK 依存関係をプロジェクトに追加します 。

pyproject.tomlファイルに移動し、プロジェクトルートから次のコマンドを実行して SDK 依存関係を追加します。

uv add agent-engine-runner-shared agent-engine-sdk-langgraph

エージェントをApp クラスでラップします。

プラットフォーム SDK を使用するようにエージェントのエントリ モジュールを次の変更で更新します。

• agent_engine_sdk_langgraph から App をインポートし、モジュール レベルで Appインスタンスを作成します。

• @app.tool() 修飾子を使用して各ツールを登録します。

• エージェント構築関数に @app.entrypoint 修飾子を追加します。

• LM を app.llm() メソッドでラップして、プラットフォームの監査された実行パスを通じて LM 呼び出しをルーティングします。

• チェックポイントを app.checkpointer() に置き換えて、プラットフォームのMongoDBベースのチェックポイントを使用します。

• モジュールの下部で app.run() メソッドを呼び出します。

次の例は、完全に移行されたエージェントモジュールを示しています。

from agent_engine_sdk_langgraph import App
from langgraph.graph import StateGraph, MessagesState
from langgraph.prebuilt import ToolNode
from langchain_openai import ChatOpenAI
app = App(app_name="my-agent")
@app.tool()
def lookup(query: str) -> str:
    """Search the knowledge base."""
    return f"result for {query}"
@app.entrypoint
def build_agent():
    llm = app.llm(ChatOpenAI(model="gpt-4o-mini"))
    tools = app.get_tools()
    def call_model(state: MessagesState):
        return {"messages": [llm.invoke(state["messages"])]}
    graph = StateGraph(MessagesState)
    graph.add_node("agent", call_model)
    graph.add_node("tools", ToolNode(tools))
    graph.set_entry_point("agent")
    graph.add_edge("tools", "agent")
    return graph.compile(checkpointer=app.checkpointer())
app.run()

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

プロジェクトルートに、次のコードに示すように、entrypointフィールドとエージェントサンドボックスのネットワーク Egress ポリシーを含む agent.yamlファイルを作成します。

entrypoint: my_agent.main:app
name: my-agent
framework: langgraph
sandboxes:
  agent:
    network:
      egress_mode: deny_all

entrypointフィールドは、module.path:attribute形式の Appインスタンスを点必要があります。

sandboxes.agent.network.egress_modeフィールドは、エージェントサンドボックスのアウトバウンド アクセス ポリシーを宣言します。上記の例では、プラットフォームの基本ポリシー以外のすべてのアウトバウンド トラフィックがブロックされます。特定の宛先へのアウトバウンド アクセスを有効にする方法については、「 ネットワーク Egress ポリシーの管理 」を参照してください。

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

プロジェクトルートに、次のコードに示すように、 MongoDB接続文字列と LM プロバイダーのAPIキーを指定する .envファイルを作成します。

MONGODB_URI=<your-mongodb-connection-string>
<PROVIDER>_API_KEY=<your-api-key>

プラットフォームにプロジェクトを登録します。

プロジェクトルートから次のコマンドを実行してプロジェクトを登録し、ローカル開発ファイルを生成します。

agentengine init

CLI は、組織とプロジェクトを選択または作成する方法をガイドし、ローカル開発ファイルを生成します。

エージェントをローカルで実行します。

移行したエージェントが正しく実行されることを確認するには、次のコマンドを実行中てローカル開発環境を起動します。

agentengine dev up

スタックが準備できたら、ブラウザで http://localhost:3000 を開いてエージェントを操作します。