Strands Graph

Graph

노드는 에이전트, 엣지는 관계 — 복잡한 워크플로우의 그래프 표현

Graph 구조도

노드와 엣지로 사전 정의하는 실행 그래프 — 병렬 분기와 합류가 구조에 내장

Graph 구현

GraphBuilder로 노드와 엣지를 정의하는 Graph 패턴

핵심 포인트

add_node(agent, node_id=)

에이전트를 그래프 노드로 등록

add_edge(a, b, condition=)

실행 순서 정의 — condition 함수로 조건부 분기

state.results

조건 함수가 받는 GraphState — 노드 결과를 검사해 bool 반환

set_entry_point / build()

진입 노드 지정 후 그래프 완성·실행

코드

from strands import Agent
from strands.multiagent.graph import GraphBuilder

builder = GraphBuilder()
extract = builder.add_node(Agent(system_prompt="Extract key entities."), node_id="extract")
analyze = builder.add_node(Agent(system_prompt="Analyze relationships."), node_id="analyze")
summarize = builder.add_node(Agent(system_prompt="Generate final summary."), node_id="summarize")

def is_confident(state):  # GraphState를 받아 bool 반환
    node = state.results.get("analyze")
    return node is not None and "confident" in str(node.result)

builder.add_edge(extract, analyze)
builder.add_edge(analyze, summarize, condition=is_confident)
builder.add_edge(analyze, extract, condition=lambda s: not is_confident(s))
builder.set_entry_point("extract")
result = builder.build()("분기별 매출 데이터를 분석해줘")

Graph 3가지 토폴로지

DAG·순환·조건부 — 그래프 토폴로지별 특성과 적용 영역

병렬 실행과 합류

독립 노드의 동시 실행과 결과 합류(Fan-out/Fan-in) 메커니즘

1. 1
   Fan-out

   진입 노드가 독립된 복수 노드를 동시 트리거

2. 2
   병렬 처리

   각 노드가 독립적으로 실행 — 서로 대기하지 않음

3. 3
   Fan-in

   모든 병렬 노드 완료 후 합류 노드에서 결과 집계

4. 4
   후속 처리

   집계된 결과를 다음 노드로 전달하여 최종 출력 생성

Graph의 상태 — 엣지로 흐르는 것과 남는 것

노드 사이에는 출력만 흐르고, 실행 상태는 그래프가 관리하는 구조