기존 LangGraph 에이전트 마이그레이션

프로젝트 에 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 데코레이터를 추가합니다.

• app.llm() 메서드로 LLM을 래핑하여 플랫폼의 감사된 실행 경로를 통해 LLM 호출을 라우팅합니다.

• 플랫폼의 MongoDB 지원 체크포인터를 사용하려면 체크포인터를 app.checkpointer()로 바꾸세요.

• 모듈 하단에서 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 필드 와 네트워크 이그레스 정책이 포함된 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 필드 에이전트 샌드박스의 아웃바운드 액세스 정책을 선언합니다. 앞의 예시 플랫폼의 기본 정책을 제외한 모든 아웃바운드 트래픽을 차단합니다. 특정 대상에 대한 아웃바운드 액세스 활성화 방법을 학습 네트워크 이그레스 정책 관리를 참조하세요.

.env 파일 만듭니다.

다음 코드에 표시된 대로 프로젝트 루트에서 MongoDB 연결 문자열 과 LLM 제공자 API 키를 지정하는 .env 파일 생성합니다.

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

플랫폼에 프로젝트 등록합니다.

프로젝트 루트에서 다음 명령을 실행 프로젝트 등록하고 로컬 개발 파일을 생성합니다.

agentengine init

CLI 는 조직 및 프로젝트 선택하거나 생성하는 과정을 안내한 다음 로컬 개발 파일을 생성합니다.

에이전트 를 로컬에서 실행합니다.

마이그레이션된 에이전트 올바르게 실행되는지 확인하려면 다음 명령을 실행 로컬 개발 환경을 시작하세요.

agentengine dev up

스택 이 준비되면 브라우저에서 http://localhost:3000를 열어 에이전트 와 상호 작용 합니다.