OpenAI Agents SDK (1) | 핵심 구성 요소 (Agent, Handoff, Guardrails)

'OpenAI Agents SDK'를 알아봅시다.


OpenAI Agents SDK

OpenAI Agents SDK는 OpenAI LLM을 기반으로 에이전트를 구성하고,
도구를 활용해 작업을 수행할 수 있도록 도와주는 프레임워크입니다.

이번 글에서는 OpenAI Agents SDK의 핵심 구성 요소인
Agents, Handoff, Guardrails를 정리해보겠습니다.

저는 지난 한 주간 이 SDK를 학습하며 restaurant-bot을 만들어봤지만,
아직 완전히 익숙해지지 않아서,
몇 편의 글을 작성하며 개념과 사용법을 정리해보고자 합니다.


Agents 란?

에이전트는 특정 지침(Instructions)과 도구(Tools)를 기반으로
작업을 수행하는 LLM 기반 구성 요소입니다.

이렇게 구성된 에이전트는 설정된 지침에 따라 사고하고,
등록된 Tools를 사용하며, 다른 에이전트와 협력하여 작업을 수행합니다.

에이전트는 사용자의 입력 또는 요청을 받고, 등록된 Tools 중 가장 적합한 도구를 호출합니다.
그리고 도구 호출의 결과를 LLM에 다시 보냅니다. 작업이 완료될 때 까지 이 동작을 계속 반복합니다.

프로그램을 개발할 때 처럼
하나의 클래스에 모든 기능을 다 붙이기 보다는,
에이전트 당 하나의 책임을 갖도록 역할을 분리하는 것이 좋은 것 같습니다.


Handoff

핸드오프는 에이전트가 대화의 제어권을 다른 전문 에이전트에게 위임하거나 전송할 수 있게 하는 매커니즘입니다.

멀티 에이전트 구조에서 중요한 역할을 하며,
특정 작업을 더 잘 수행할 수 있는 에이전트에게 요청을 위임할 수 있습니다.

저는 실습 중 이 부분에서 난해함을 느꼈는데, A라는 에이전트가
"이건 B 에이전트가 전문이니, 곧 B 에이전트가 응답을 드릴 예정입니다."
라고 말한 뒤에 응답이 멈추는 경우가 있었습니다.

instructions 를 지금보다 더 잘 정리하면 이것 또한 해결될 것이라 생각합니다.
얼마나 자세하게 적느냐가 관건인 부분인 것 같습니다.


Guardrails

가드레일은 에이전트의 입력 및 출력을 검증하는 안전장치 입니다.

잘못된 요청이나 허용되지 않은 응답을 차단하는 역할을 하며,
시스템의 안정성을 높이는 데 중요한 요소입니다.

제가 실습하면서 만들었던 restaurant-bot 에게 '근의 공식'을 질문했을 때,
- 가드레일을 설정하지 않은 경우, 근의 공식에 대해서 자세히 설명합니다.
- 가드레일을 설정하면, 대답하기 적합하지 않다며 대화를 끝냅니다.

출력을 하는 경우에도, 응답이 허용되지 않는다고 판단되면 거기에서 대화를 끝냅니다.


다음 글에서는

오늘은 OpenAI agents SDK 의 핵심 구성 요소
- Agents
- Handoff
- Guardrails
를 정리해 봤습니다.

다음 글에서는 OpenAI Agents SDK를 활용한 코드 예시와 함께
간단한 구현 방법을 정리해 보겠습니다. 감사합니다.

인센티브

예술하는 프로그래머, 코딩하는 예술가

댓글 쓰기

다음 이전