Microsoft Foundry 에이전트 서비스의 웹 접지 도구는 에이전트를 실시간 공용 웹 데이터에 연결하여 에이전트의 Foundry 모델의 지식 차단을 극복합니다. 예를 들어 "오늘날 최고의 AI 뉴스"와 같은 질문을 하고 현재 인용된 답변을 받을 수 있습니다.
웹 접지의 작동 원리
접지 프로세스에는 다음과 같은 몇 가지 주요 단계가 포함됩니다.
- 쿼리 공식화: 에이전트는 정보 간격을 식별하고 사용자의 입력에 따라 검색 쿼리를 생성합니다.
- 검색 실행: 그라운딩 도구는 Bing에 쿼리를 제출하고 결과를 가져옵니다.
- 정보 합성: 에이전트는 검색 결과를 처리하고 결과를 응답에 통합합니다.
- 원본 특성: 에이전트는 URL이 있는 검색 원본을 인용하여 투명성을 제공합니다.
필수 구성 요소
웹 기반 접지 도구를 사용하기 전에 다음이 있는지 확인합니다.
- 기본 또는 표준 에이전트 환경입니다.
- 언어에 대한 최신 SDK 패키지(Python:
azure-ai-projects, C#:Azure.AI.Projects및Azure.AI.Extensions.OpenAI, JavaScript:@azure/ai-projects). 설치 단계는 빠른 시작을 참조하세요. - Foundry 프로젝트의 Azure OpenAI 모델 배포입니다.
참고
Web Search에는 Foundry 프로젝트 액세스 외에 추가 역할이 필요하지 않습니다. Bing Search 및 Bing Custom Search의 그라운딩을 설정하려면 Bing 리소스를 생성할 때는 Contributor 또는 Owner 역할이 필요하며, 프로젝트 연결을 만들 때는 Azure AI Project Manager 역할이 필요합니다. 자세한 내용은 에이전트 환경 설정을 참조하세요.
중요
웹 검색, Bing 검색을 통한 참조, Bing 커스텀 검색을 통한 참조는 퍼스트 파티 소비 서비스이며 온라인 서비스 약관을 따릅니다. 그것들은 Bing 사용 약관 및 Microsoft 개인정보처리방침의 적용을 받습니다.
Microsoft 데이터 보호 부록은 Bing 검색 또는 Bing 맞춤 검색을 사용하여 Grounding에 전송된 데이터에는 적용되지 않습니다. 이러한 서비스를 사용하는 경우 데이터는 Azure 규정 준수 및 지리적 경계 외부로 흐릅니다. 이는 또한 이러한 서비스를 사용하는 경우, 관련된 모든 높은 수준의 정부 커뮤니티 클라우드 보안 및 규정 준수 약정, 데이터 주권 및 자격심사/시민권 기반 지원을 포함한 모든 의무가 면제됨을 의미합니다.
참고
Bing Search 및 Grounding과 함께 Bing Custom Search에서 접지를 사용하면 비용이 발생합니다. 가격 책정 세부 정보를 참조하세요. Azure 관리자는 이러한 도구에 대한 액세스를 제한할 수 있습니다. 자세한 내용은 웹 검색 도구에 대한 관리자 컨트롤을 참조하세요.
사용 사례에 가장 적합한 도구 결정
이제 막 시작하는 경우 웹 검색을 사용합니다. 추가 Azure 리소스가 필요하지 않으며 에이전트에 웹 접지를 추가하는 가장 간단한 방법입니다.
기존 클래식 에이전트 플랫폼에서 Bing Search 기반 그라운딩 기능을 사용 중이었다면, 새롭게 출시된 에이전트 API의 정식 버전(GA)에서 제공하는 Web Search 및 Bing Search 그라운딩 옵션으로 전환할 수 있습니다. 웹 검색에는 별도의 Bing 리소스가 필요하지 않습니다. Bing 검색을 사용한 접지는 더 많은 매개 변수를 제공하며 Azure에 직접 배포된 비-OpenAI 모델을 지원합니다.
다음 사용 사례는 사용 가능한 도구를 비교하는 데 도움이 됩니다. 사용 사례 1은 일반 웹 검색을 다룹니다. Bing Search와의 연결로 웹 검색은 공용 웹에서 결과를 검색할 수 있습니다. 사용 사례 2는 도메인 제한 검색을 다루며, 이는 Bing Custom Search를 사용한 Grounding만 지원합니다.
사용 사례 1: Bing에서 인덱싱된 일반 웹을 기반으로 한 기초 형성
| 웹 검색 (권장) | Bing Search를 이용한 연결 | |
|---|---|---|
| 단계 | 조지아 | 조지아 |
| Bing 리소스를 활용한 기반 다지기 | Microsoft 관리 | 관리 대상: Bing 검색 리소스를 사용한 그라운딩을 먼저 생성해야 합니다 |
| 지원되는 매개 변수 |
-
user_location: 지역 관련 결과 제공- search_context_size: 낮음/보통/높음(기본값: 보통)Web Search 매개 변수에 대해 자세히 알아보기 |
-
count: Bing에서 반환된 결과의 최대값 - freshness: 검색 결과의 기간을 지정합니다.- market: 검색 결과의 영역을 지정합니다. - set_lang: 검색 결과에 대한 언어를 지정합니다. Bing Search 매개 변수에 대해 자세히 알아보기 |
| 데이터 경계 | Azure 규정 준수 경계 외부의 데이터 흐름 | Azure 규정 준수 경계 외부의 데이터 흐름 |
| 지원되는 모델 | Azure OpenAI 모델 | Azure OpenAI 모델 및 Azure 직접 모델(비 OpenAI 모델이 Azure에 직접 배포됨) |
사용 사례 2: 정의한 특정 도메인에서 기반 적용
| 웹 검색 (권장) | Bing Custom Search를 사용하여 기반 다지기 | |
|---|---|---|
| 단계 | GA(Bing Custom Search 인스턴스 필요) | 미리 보기 |
| 사용자 지정 도메인으로 제한 | 지원됨 - 허용되거나 차단된 도메인을 미리 정의하는 데 사용합니다 custom_search_configuration (Bing Custom Search 리소스 + 인스턴스를 만들어야 함) |
지원됨 - 허용되거나 차단된 도메인을 미리 정의하는 데 사용합니다 custom_search_configuration (Bing Custom Search 리소스 + 인스턴스를 만들어야 함) |
| 기타 매개 변수 |
-
user_location: 지역 관련 결과 제공- search_context_size: 낮음/보통/높음(기본값: 보통)Web Search 매개 변수에 대해 자세히 알아보기 |
-
count: Bing에서 반환하는 최대 결과 수 - freshness: 검색 결과의 기간을 지정합니다.- market: 검색 결과의 영역을 지정합니다. - set_lang: 검색 결과에 대한 언어를 지정합니다. Bing Custom Search 매개 변수에 대해 자세히 알아보기 |
| 지원되는 모델 | Azure OpenAI 모델 | Azure OpenAI 모델 및 Azure 직접 모델 |
일반적인 질문
방금 시작하는 경우 어떤 도구를 사용해야 하나요?
웹 검색을 사용합니다. 추가 Azure 리소스가 필요하지 않으며 Bing 리소스 관리를 자동으로 처리하며 user_location 매개 변수와 함께 지역 관련 결과를 제공합니다.
네트워크로 보호된 Foundry 프로젝트에서 웹 관련 도구를 사용할 수 있나요?
웹 접지 도구는 VPN 또는 프라이빗 엔드포인트를 존중하지 않습니다. 퍼블릭 엔드포인트 역할을 합니다. 네트워크로 보호된 Foundry를 이러한 도구와 함께 사용할 때 이 보안적 함의를 고려하십시오.
검색 결과를 특정 웹 사이트로 제한하려면 어떻게 해야 하나요?
웹 검색을 사용합니다. 이 도구를 사용하면 도메인의 허용 목록 또는 차단 목록을 정의할 수 있으므로 검색 결과는 승인한 원본에서만 제공됩니다.
웹 기반에 추가 비용이 발생하나요?
예. Web Search, Bing Search를 통해 기반 지식을 연결하거나 Bing Custom Search(미리 보기)를 사용할 경우, 표준 Azure OpenAI 사용량을 초과하는 추가 비용이 발생합니다. 가격 책정 세부 정보를 참조하세요.
문제 해결
| 문제 | 원인일 수 있습니다. | 해상도 |
|---|---|---|
| 에이전트는 웹 접지를 사용하지 않습니다. | 도구가 구성되지 않았거나 모델이 도구를 지원하지 않습니다. | 도구가 에이전트 정의에 추가되었는지 확인합니다.
tool_choice="required"를 사용하여 도구 사용을 강제합니다. 모델 배포에서 도구를 지원하는지 확인합니다. |
| 응답에 인용 없음 | 모델은 검색 결과를 사용하지 않고 응답을 생성했습니다. | 항상 소스를 인용하는 명시적 지침을 추가합니다.
tool_choice="required"를 사용하여 도구 호출을 보장합니다. |
| 검색 결과는 관련이 없습니다. | 쿼리 공식이 사용자 의도를 캡처하지 않았습니다. | 에이전트 지침을 개선하여 쿼리 생성을 안내합니다. Bing 도구의 경우 market 및 set_lang 매개 변수를 조정합니다. |
| 관리자가 차단한 도구 | 조직에서 웹 접지 도구를 사용하지 않도록 설정했습니다. | 액세스를 사용하도록 설정하려면 Azure 관리자에게 문의하세요. 관리자 제어를 참조하세요. |
| 예기치 않은 비용 | 웹 접지 도구에는 사용량 기반 가격 책정이 있습니다. | 가격 책정 세부 정보를 검토하고 필요한 경우 속도 제한을 구현합니다. |