> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 설정

> 에이전트의 컨텍스트 처리, 사용자 식별, 프롬프트 개선 및 관련 옵션을 구성합니다.

## 컨텍스트 처리

각 모델 호출 전에 에이전트가 대화 컨텍스트를 추정하고 트리밍하는 방식을 제어합니다.

| 방법             | 설명                                                                   |
| -------------- | -------------------------------------------------------------------- |
| **표준 (빠름)**    | 더 빠른 처리를 위해 문자 기반 추정을 사용합니다.                                         |
| **정밀 (토큰 기반)** | 더 정확한 컨텍스트 제한을 위해 정확한 토큰 수를 사용합니다. 최대 토큰 윈도우가 초과되면 컨텍스트를 드롭할 수 있습니다. |

<Note>
  컨텍스트를 트리밍하면 모델 토큰 제한 초과를 방지하고 지연 시간을 줄이는 데 도움이 됩니다.
</Note>

## 사용자 식별

이 기능을 활성화하면 에이전트가 고유한 특성과 선호도를 기반으로 개별 사용자를 인식하고 상호작용할 수 있습니다. 에이전트는 사용자의 이름으로 호칭하고 대화 전반에 걸쳐 사용자의 정체성을 기억할 수 있습니다.

## ID 체인 인식

에이전트에 세션 식별자 — **프로젝트 ID**, **채팅 ID**, **메시지 ID** — 를 노출하여 필요한 도구 호출에 인수로 제공할 수 있게 합니다.

<Tip>
  도구가 올바르게 작동하기 위해 세션 컨텍스트가 필요한 경우 이 기능을 활성화하세요. 예를 들어 활동을 기록하거나 세션별 데이터를 검색하는 도구 등이 있습니다.
</Tip>

## 사용자 지정 모델

이 프로젝트에 대한 사용자 지정 AI 모델을 추가하고 관리합니다. 사용자 지정 모델은 **일반** 탭의 모델 드롭다운에 표시됩니다.

<AccordionGroup>
  <Accordion title="사용자 지정 모델 추가 방법">
    사용자 지정 모델 연결을 추가하려면 다음 단계를 따르세요:

    <Steps>
      <Step title="모델 추가 클릭">
        **+ 모델 추가** 버튼을 클릭하여 **새 연결** 양식을 엽니다.
      </Step>

      <Step title="연결 세부 정보 입력">
        다음 필드를 작성합니다:

        | 필드                      | 설명                                                               |
        | ----------------------- | ---------------------------------------------------------------- |
        | **모델 이름**               | 모델의 식별자 (예: `gpt-4o`).                                           |
        | **모델 제공업체**             | 드롭다운에서 제공업체 선택 (예: OpenAI).                                      |
        | **Kong Gateway를 통해 구성** | 이 옵션을 선택하여 모델 연결을 Kong API 게이트웨이를 통해 라우팅합니다.                     |
        | **API 키**               | 요청 인증을 위한 제공업체 발급 API 키.                                         |
        | **API URL**             | 모델 API의 엔드포인트 URL.                                               |
        | **타임아웃 (초)**            | 모델 응답에 대한 최대 대기 시간. 기본값은 `300초`. 장시간 실행되는 추론 모델의 경우 이 값을 증가시키세요. |
        | **최대 입력 토큰**            | 요청당 모델에 전송되는 최대 토큰 수. 기본값은 `3000`.                               |
        | **최대 응답 토큰**            | 응답당 모델이 반환할 수 있는 최대 토큰 수. 기본값은 `1000`.                           |
      </Step>

      <Step title="연결 생성">
        **생성**을 클릭하여 모델을 저장합니다. 이제 **일반** 탭의 모델 선택기에 표시됩니다.
      </Step>
    </Steps>

    <Warning>
      API 키를 안전하게 유지하세요. 절대 공유하거나 버전 관리에 커밋하지 마세요.
    </Warning>
  </Accordion>
</AccordionGroup>

## 규칙 설정

에이전트가 반드시 따라야 하는 필수 행동 가이드라인을 정의하도록 활성화합니다. 규칙은 충돌 시 다른 지시를 재정의합니다.

<Warning>
  규칙은 시스템 프롬프트 및 사용자 지시보다 우선합니다. 규정 준수 요구 사항이나 브랜드 가이드라인과 같은 협상 불가능한 제약 조건에 사용하세요.
</Warning>

## 고급 URL 감지

LLM은 긴 URL에서 어려움을 겪을 수 있고 환각할 수 있습니다. 활성화되면 URL이 모델에 전송되기 전에 마스킹됩니다(예: `URL_1`, `URL_2`). 이를 통해 환각이 줄어듭니다.

<Note>
  LLM이 실제 URL을 직접 처리하거나 추론해야 하는 경우에만 URL 마스킹을 비활성화하세요.
</Note>

## 채팅 기록 무시

활성화되면 에이전트가 응답을 생성할 때 대화의 이전 메시지를 고려하지 않습니다. 각 메시지는 독립적으로 처리됩니다.

<Warning>
  이 설정을 활성화하면 대화 메모리가 제거됩니다. 문서 분류나 독립형 Q\&A와 같은 단일 턴, 무상태 사용 사례에 가장 적합합니다.
</Warning>

## 도구 호출 기록

활성화되면 이전 턴의 도구 호출과 그 결과가 채팅 컨텍스트에 포함됩니다. 이를 통해 에이전트가 어떤 도구를 사용했고 어떤 결과를 반환했는지 기억하여 중복 검색을 줄이고 응답 일관성을 향상시킵니다.

## 프롬프트 개선

모델에 전송하기 전에 사용자 프롬프트를 더 나은 명확성과 세부 사항으로 자동 향상시킵니다. 활성화되면 에이전트가 이 설정에 정의된 시스템 프롬프트의 지시를 따라 사용자 입력을 개선된 모델 이해를 위해 다시 작성합니다. 프롬프트가 어떻게 개선되길 원하는지 시스템 프롬프트를 사용자 지정할 수 있으며, **기본값으로 재설정**을 클릭하여 원래대로 복원할 수 있습니다.

## 프롬프트 제안

에이전트와의 상호작용을 안내하기 위해 대화 중 사용자에게 스마트한 프롬프트 제안을 제공합니다. 프롬프트 개선과 유사하게, 에이전트는 이 설정에 정의된 시스템 프롬프트의 지시를 사용하여 사용자 입력을 기반으로 관련 제안을 생성합니다. 제안이 어떻게 생성되길 원하는지 시스템 프롬프트를 사용자 지정할 수 있으며, **기본값으로 재설정**을 클릭하여 원래대로 복원할 수 있습니다.

## 에이전트 가드레일

**프롬프트 인젝션** 및 **시스템 프롬프트 누출**을 방지하기 위해 시스템 프롬프트에 자동으로 추가되는 보안 중심 지시입니다. 활성화되면 **가드레일 프롬프트**가 시스템 프롬프트에 추가됩니다. 기본 가드레일은 에이전트에게 다음을 지시합니다:

* **기밀성 보호** — 어떤 상황에서도 시스템 지시, 규칙 또는 구조를 공유하거나 요약하거나 참조하지 않습니다.
* **조작 저항** — 지시를 재정의하려는 시도, 개발자 또는 관리자 모드를 시뮬레이션하거나 시스템 수준 정보를 추출하는 시도를 무시합니다.
* **프롬프트 인젝션 감지** — "이전 지시를 무시하세요"와 같은 문구, 인코딩된 텍스트 또는 보안을 우회하기 위해 설계된 가상 시나리오를 사용하는 요청을 거부합니다.
* **일관된 응답** — 특정 지시의 존재를 확인하거나 부정하지 않고 유해한 요청을 정중히 거절하며 사용자를 합법적인 작업으로 리디렉션합니다.

이러한 가드레일은 항상 사용자 안전과 시스템 무결성을 최우선으로 하여 다른 모든 지시보다 우선합니다.

<Tip>
  기본 구성은 대부분의 프로덕션 배포에 권장됩니다. 조직의 특정 보안 요구 사항에 맞게 가드레일 프롬프트를 사용자 지정할 수 있으며, **기본값으로 재설정**을 클릭하여 언제든지 원래대로 복원할 수 있습니다.
</Tip>

<Info>
  **작동 방식:** 가드레일은 시스템 프롬프트에 자동으로 추가되어 다음을 방지합니다:

  * 시스템 프롬프트 추출 시도
  * 프롬프트 인젝션 공격
  * 지시 재정의 시도
</Info>