

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 지식 기반을 사용하여 에이전트에 대한 응답 생성 강화
<a name="agents-kb-add"></a>

Amazon Bedrock Knowledge Bases는 데이터 저장소에서 정보를 가져와 대규모 언어 모델(LLM)에서 생성된 응답을 보강하는 것으로 널리 사용되는 기술인 검색 증강 생성(RAG)을 활용할 수 있도록 도와줍니다. 데이터 소스와 벡터 저장소로 지식 기반을 설정하면 애플리케이션에서 지식 기반을 쿼리하여 소스에서 직접 인용하거나 쿼리 결과에서 생성된 자연스러운 응답으로 쿼리에 답하는 정보를 반환할 수 있습니다.

Amazon Bedrock Knowledge Bases를 Amazon Bedrock 에이전트와 함께 사용하려면 먼저 지식 기반을 만든 다음 지식 기반을 에이전트와 연결해야 합니다. 아직 지식 기반을 만들지 않은 경우 [Amazon Bedrock Knowledge Bases를 사용하여 데이터 검색 및 AI 응답 생성](knowledge-base.md)에서 지식 기반에 대해 알아보고 지식 기반을 만듭니다. [에이전트를 만드는](agents-create.md) 동안 또는 에이전트가 만들어진 후에 지식 기반을 연결할 수 있습니다. 지식 기반을 기존 에이전트에 연결하려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다.

------
#### [ Console ]

**지식 기반을 추가하려면**

1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명으로 AWS Management Console에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다.

1. **에이전트 빌더에서 편집**을 선택합니다.

1. **지식 기반** 섹션에서 **추가**를 선택합니다.

1. 생성한 지식 기반을 선택하고, 에이전트가 지식 기반과 상호 작용해야 하는 방식에 대한 지침을 제공합니다.

1. **추가**를 선택합니다. 상단에 성공 배너가 나타납니다.

1. 에이전트를 테스트하기 전에 **준비**를 선택하여 변경한 내용을 에이전트에 적용합니다.

------
#### [ API ]

지식 기반을 에이전트와 연결하려면 [Agents for Amazon Bedrock 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [AssociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_AssociateAgentKnowledgeBase.html) 요청을 보냅니다.

다음 목록에는 요청의 필드에 대한 설명이 나와 있습니다.
+ 필수 필드는 다음과 같습니다.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/agents-kb-add.html)
+ 다음 필드는 선택 사항입니다.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/agents-kb-add.html)

------

에이전트를 간접적으로 호출할 때 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) 요청의 `sessionState` 필드를 사용하여 에이전트에 연결된 지식 기반의 [쿼리 구성](kb-test-config.md)을 수정할 수 있습니다. 자세한 내용은 [제어 에이전트 세션 컨텍스트](agents-session-state.md) 섹션을 참조하세요.

# 에이전트-지식 기반 연결에 관한 정보 확인
<a name="agents-kb-view"></a>

지식 기반에 대한 정보를 확인하는 방법을 알아보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다.

------
#### [ Console ]

**에이전트와 연결된 지식 기반 관련 정보를 확인하는 방법**

1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명으로 AWS Management Console에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다.

1. **에이전트 빌더에서 편집**을 선택합니다.

1. **지식 기반** 섹션에서 정보를 확인하려는 지식 기반을 선택합니다.

------
#### [ API ]

에이전트와 연결된 지식 기반에 대한 정보를 얻으려면 [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [GetAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentKnowledgeBase.html) 요청을 전송합니다. 다음 필드를 지정합니다.

에이전트와 연결된 지식 기반에 대한 정보를 나열하려면 [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [ListAgentKnowledgeBases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentKnowledgeBases.html) 요청을 전송합니다. 연결된 지식 기반을 확인하려는 `agentId` 및 `agentVersion`을 지정합니다.


****  

| 필드 | 간단한 설명 | 
| --- | --- | 
| maxResults | 응답으로 반환할 최대 결과 수입니다. | 
| nextToken | maxResults 필드에 지정한 수보다 많은 결과가 있는 경우 응답은 nextToken 값을 반환합니다. 다음 결과 배치를 보려면 다른 요청에서 nextToken 값을 보냅니다. | 

[코드 예시 보기](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-agent_example_bedrock-agent_ListAgentKnowledgeBases_section.html)

------

# 에이전트-지식 기반 연결 수정
<a name="agents-kb-edit"></a>

에이전트-지식 기반 연결을 수정하는 방법을 알아보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다.

------
#### [ Console ]

**에이전트-지식 기반 연결을 수정하는 방법**

1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명으로 AWS Management Console에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다.

1. **에이전트 빌더에서 편집**을 선택합니다.

1. **작업 그룹** 섹션에서 편집할 작업 그룹을 선택합니다. 그런 다음 **편집**을 선택합니다.

1. 필요에 따라 기타 필드를 편집합니다. 자세한 내용은 [지식 기반을 사용하여 에이전트에 대한 응답 생성 강화](agents-kb-add.md) 섹션을 참조하세요.

1. 에이전트가 지식 기반을 사용할 수 있는지 여부를 제어하려면 **활성화** 또는 **비활성화**를 선택합니다. 이 함수를 사용하면 에이전트의 동작 문제를 해결하는 데 도움이 됩니다.

1. 변경 사항을 테스트할 수 있도록 동일한 창에 유지하려면 **저장**을 선택합니다. **저장 후 종료**를 선택하여 **규격 초안** 페이지로 돌아갑니다.

1. 에이전트를 테스트하기 전에 에이전트에 변경 사항을 적용하려면 **테스트** 창 또는 **규격 초안** 페이지 상단에서 **준비**를 선택합니다.

------
#### [ API ]

에이전트와 연결된 지식 기반 구성을 수정하려면 [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [UpdateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentKnowledgeBase.html) 요청을 전송합니다. 모든 필드를 덮어쓰게 되므로 업데이트하려는 필드 및 동일하게 유지하려는 필드를 모두 포함합니다. `agentVersion`을 `DRAFT`로 지정해야 합니다. 필수 및 선택 필드에 대한 자세한 내용은 [지식 기반을 사용하여 에이전트에 대한 응답 생성 강화](agents-kb-add.md) 섹션을 참조하세요.

규격 초안에 변경 사항을 적용하려면 [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) 요청을 보냅니다. 요청에 `agentId`를 포함시킵니다. 변경 사항은 `TSTALIASID` 별칭이 가리키는 `DRAFT` 버전에 적용됩니다.

------

# 에이전트에서 지식 기반 연결 해제
<a name="agents-kb-delete"></a>

에이전트에서 지식 기반을 연결 해제하는 방법을 알아보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다.

------
#### [ Console ]

**에이전트에서 지식 기반 연결을 해제하는 방법**

1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명으로 AWS Management Console에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다.

1. **에이전트 빌더에서 편집**을 선택합니다.

1. **지식 기반** 섹션에서 삭제하려는 지식 기반 옆에 있는 옵션 버튼을 선택합니다. 그런 다음 **삭제**를 선택합니다.

1. 표시되는 메시지를 확인한 다음 **삭제**를 선택합니다.

1. 에이전트를 테스트하기 전에 에이전트에 변경 사항을 적용하려면 **테스트** 창 또는 **규격 초안** 페이지 상단에서 **준비**를 선택합니다.

------
#### [ API ]

에이전트에서 지식 기반을 연결 해제하려면 [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [DisassociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DisassociateAgentKnowledgeBase.html) 요청을 전송합니다. `knowledgeBaseId` 및 연결을 해제할 에이전트의 `agentVersion`와 `agentId`을 지정합니다.

규격 초안에 변경 사항을 적용하려면 [Amazon Bedrock Agents 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) 요청을 보냅니다. 요청에 `agentId`를 포함시킵니다. 변경 사항은 `TSTALIASID` 별칭이 가리키는 `DRAFT` 버전에 적용됩니다.

------