에이전트 계측하기

에이전트는 이미 기록할 가치가 있는 모든 것을 생성합니다 — 모델 호출, 툴 호출, 노드 경계, 사람의 대기, 실패. 프레임워크는 이를 버립니다. SDK는 이를 보존합니다.

커스텀 에이전트

직접 작성했거나 여기에 나열되지 않은 에이전트.

LangChain과 LangGraph

그래프, 노드, 툴, 리트리버, 모델.

CrewAI

크루, 플로우, 역할별 에이전트, 툴.

LlamaIndex

워크플로우, 스텝, 함수 에이전트, 리트리버.

Pydantic AI

타입 지정 에이전트, 기능, 툴, 재시도.

세 줄이면 충분합니다, 어떤 프레임워크든

pip install 'failproofai-sdk[langgraph]'

pip install 'failproofai-sdk[crewai]'

pip install 'failproofai-sdk[llamaindex]'

pip install 'failproofai-sdk[pydantic-ai]'

pip install failproofai-sdk

import failproofai_sdk

failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument()          # 임포트된 프레임워크를 자동으로 감지

with failproofai_sdk.session():
    ...                               # 기존 에이전트 호출 코드 그대로 사용

함수에 데코레이터를 추가할 필요도, 호출에 콜백을 전달할 필요도, 코드 전반에 id를 넘길 필요도 없습니다. 달라지는 것은 세션 안의 호출뿐입니다:

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

graph.invoke({"messages": [HumanMessage("...")]})

Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()

await agent.run("...")        # `async with failproofai_sdk.session():` 아래에서 사용

agent.run_sync("...")

with failproofai_sdk.agent("planner"):
    with failproofai_sdk.tool_call("search", input={"q": q}) as t:
        t.output = search(q)

추가 설치는 프레임워크를 위한 것입니다. 모든 어댑터는 기본 휠에 포함되어 있으므로, 이미 프레임워크를 설치한 프로젝트는 추가 설치가 전혀 필요 없습니다.

데이터가 도착했는지 확인하기

계측된 세션을 한 번 실행한 뒤, Observe → Sessions를 열고 환경을 선택하세요. 실행 결과가 재구성된 트레이스로 표시됩니다. 아무것도 도착하지 않는다면, failproofai config --status로 머신이 연결되어 있는지 확인하세요. 캡처 설정을 참고하세요.

스풀 디렉토리를 확인하여 전달 여부를 판단하지 마세요. Failproof 데몬은 각 배치를 수 밀리초 안에 수집하고 삭제하므로, 디렉토리를 읽으면 수집기와 경쟁 상태가 발생해 실제 방출된 이벤트보다 훨씬 적은 수만 보이게 됩니다.

다음 단계

위의 각 퀵스타트는 전체 가이드로 연결됩니다 — 기록되는 내용, 옵션, 스트리밍, 스팬 이름 지정, 그리고 실제로 발생하는 문제들. Trace Agents → Plug in your agent 아래에 있습니다.

동작 원리

데이터 모델, id, 이벤트 타입, 그리고 이벤트가 Cloud에 전달되는 방식.

트레이스 읽기

분리된 로그 대신 세션 전반의 인과관계를 따라가세요.

첫 번째 실패 찾기

방금 캡처한 세션을 감사하세요.

커스텀 에이전트

LangChain과 LangGraph

CrewAI

LlamaIndex

Pydantic AI

​세 줄이면 충분합니다, 어떤 프레임워크든

​데이터가 도착했는지 확인하기

​다음 단계

동작 원리

트레이스 읽기

첫 번째 실패 찾기

세 줄이면 충분합니다, 어떤 프레임워크든

데이터가 도착했는지 확인하기

다음 단계