Koog 문서 번역 04: Glossary

·3분 읽기

원문: Koog Documentation — Glossary 이 글은 Koog 공식 문서의 Glossary 페이지를 한국어로 옮긴 번역본입니다. 문서 구조와 링크 의미를 유지하되, MkDocs 전용 UI 문법은 블로그에서 읽기 좋도록 정리했습니다.

용어집

에이전트

  • Agent: 도구와 상호작용하고, 복잡한 워크플로를 처리하며, 사용자와 소통할 수 있는 AI 개체입니다.

  • LLM (Large Language Model): 에이전트 기능을 구동하는 기반 AI 모델입니다.

  • Message: 에이전트 시스템에서 사용자, 어시스턴트, 시스템으로부터 전달되는 데이터를 나타내는 통신 단위입니다.

  • Prompt: 사용자, 어시스턴트, 시스템의 메시지로 구성되어 LLM에 제공되는 대화 기록입니다.

  • System prompt: 에이전트의 동작을 안내하고, 역할을 정의하며, 작업에 필요한 핵심 정보를 제공하기 위해 에이전트에 주어지는 지침입니다.

  • Context: LLM 상호작용이 일어나는 환경으로, 대화 기록과 도구에 접근할 수 있습니다.

  • LLM session: 대화 기록, 사용 가능한 도구, 요청을 보내는 메서드를 포함하여 LLM과 상호작용하는 구조화된 방식입니다.

에이전트 워크플로

  • Strategy: 순차적인 하위 그래프로 구성되는, 에이전트를 위한 정의된 워크플로입니다. 전략은 에이전트가 입력을 처리하고, 도구와 상호작용하며, 출력을 생성하는 방식을 정의합니다. 전략 그래프는 노드 사이의 전환을 나타내는 엣지로 연결된 노드들로 구성됩니다.

전략 그래프

  • Graph: 에이전트 전략 워크플로를 정의하는, 엣지로 연결된 노드 구조입니다.

  • Node: 특정 작업이나 변환을 나타내는 에이전트 전략 워크플로의 기본 구성 요소입니다.

  • Edge: 에이전트 그래프에서 작업 흐름을 정의하는 노드 사이의 연결입니다. 각 엣지를 언제 따라갈지 지정하는 조건을 동반하는 경우가 많습니다.

  • Conditions: 특정 엣지를 언제 따라갈지 결정하는 규칙입니다.

  • Subgraph: 에이전트 전략 안에서 자체 도구 집합, 컨텍스트, 책임을 가진 독립적인 처리 단위입니다. 하위 그래프 작업에 대한 정보는 하위 그래프 내부에 캡슐화될 수도 있고, AgentMemory 기능을 사용해 하위 그래프 사이에서 전달될 수도 있습니다.

도구

  • Tool: 에이전트가 특정 작업을 수행하거나 외부 시스템에 접근하기 위해 사용할 수 있는 함수입니다. 에이전트는 사용 가능한 도구와 그 인수를 알고 있지만, 구현 세부 사항은 알지 못합니다.

  • Tool call: 제공된 인수를 사용해 특정 도구를 실행하라는 LLM의 요청입니다. 함수 호출과 비슷하게 동작합니다.

  • Tool descriptor: 이름, 설명, 매개변수를 포함하는 도구 메타데이터입니다.

  • Tool registry: 에이전트가 사용할 수 있는 도구 목록입니다. 레지스트리는 에이전트에게 사용 가능한 도구를 알려줍니다.

  • Tool result: 도구를 실행해 생성된 출력입니다. 예를 들어 도구가 메서드라면 결과는 해당 메서드의 반환값입니다.

기록 압축

  • History compression: 다양한 압축 전략을 적용해 토큰 사용량을 관리하기 위해 대화 기록의 크기를 줄이는 과정입니다. 자세한 내용은 History compression을 참고하세요.

기능

  • Feature: AI 에이전트의 기능을 확장하고 강화하는 구성 요소입니다.

EventHandler 기능

  • EventHandler: 다양한 에이전트 이벤트를 모니터링하고 응답할 수 있게 해주는 기능입니다. 워크플로 전반에서 에이전트 생명주기 추적, 오류 처리, 도구 호출 처리를 위한 훅을 제공합니다.

AgentMemory 기능

  • AgentMemory: AI 에이전트가 여러 대화에 걸쳐 정보를 저장하고, 검색하고, 사용할 수 있게 해주는 기능입니다. 자세한 내용은 AgentMemory를 참고하세요.

  • Concept: AgentMemory 기능에서 키워드, 설명, 사실 유형 등 관련 메타데이터를 가진 정보 범주입니다. 개념은 에이전트가 기억하고 다시 떠올릴 수 있는 AgentMemory 시스템의 기본 구성 요소입니다. 자세한 내용은 AgentMemory를 참고하세요.

  • Fact: AgentMemory 시스템에 저장되는 개별 정보 조각입니다. 사실은 개념과 연결되며, 단일 값을 가질 수도 있고 여러 값을 가질 수도 있습니다. 자세한 내용은 AgentMemory를 참고하세요.

  • Memory scope: 사실이 관련되는 컨텍스트입니다. 자세한 내용은 AgentMemory를 참고하세요.