Bing 검색과의 연계를 통해 Azure AI 에이전트는 응답을 생성할 때 실시간 공용 웹 데이터를 통합할 수 있습니다. Bing Search 리소스를 사용하여 Grounding을 만든 다음, 이 리소스를 Azure AI 에이전트에 연결해야 합니다. 사용자가 쿼리를 보내면 Azure AI 에이전트는 Bing Search를 사용한 접지 기능을 활용해야 하는지 여부를 결정합니다. 그렇다면 Bing을 활용하여 공용 웹 데이터를 검색하고 관련 청크를 반환합니다. 마지막으로 Azure AI 에이전트는 반환된 청크를 사용하여 응답을 생성합니다.
실시간 공개 데이터가 필요한 "오늘 주요 뉴스란 무엇인가요" 또는 "미국 소매업의 최근 업데이트란?"과 같은 질문을 할 수 있습니다.
개발자와 최종 사용자는 Bing Search를 사용하여 Grounding에서 반환된 원시 콘텐츠에 액세스할 수 없습니다. 그러나 모델 응답에는 응답을 생성하는 데 사용되는 웹 사이트에 대한 링크와 검색에 사용되는 Bing 쿼리에 대한 링크가 포함된 인용이 포함됩니다. 생성된 스레드의 데이터에 액세스하여 모델 응답을 검색할 수 있습니다. 이 두 참조는 Bing Search 기반 과정의 사용 및 표시 요구 사항에 따라 Microsoft에서 제공한 정확한 형식으로 보존하고 표시해야 합니다. 자세한 내용은 Bing Search 결과에서 Grounding 표시 방법 섹션을 참조하세요.
중요합니다
- Bing Search 기반 과정을 사용하면 비용이 발생할 수 있습니다. 자세한 내용은 가격 책정 페이지를 참조하세요.
- Azure CLI와 같은 코드 우선 환경을 통해 Bing Search 리소스에서 Grounding을 만들고 사용하거나 배포 템플릿을 통해 배포하면 때때로 업데이트될 수 있는 사용 가능한 https://www.microsoft.com/en-us/bing/apis/grounding-legal약관에 바인딩되어 준수해야 합니다.
- Bing Search에서 Grounding을 사용할 때, 고객 데이터는 Azure 규정 준수 경계를 넘어 Grounding with Bing Search 서비스로 전송됩니다. Bing Search를 사용한 접지는 동일한 데이터 처리 조건(처리 위치 포함)이 적용되지 않으며, Bing Search 사용 약관에 설명된 대로 Azure AI Foundry 에이전트 서비스와 같은 규정 준수 표준 및 인증을 가지고 있지 않습니다. 에이전트에서 Bing Search와 함께 Grounding을 사용하는 것이 귀하의 요구와 필요를 충족하는지 평가하는 것은 귀하의 책임입니다.
Bing Search 기반 과정 작동 방식
사용자 쿼리는 최종 사용자가 에이전트에 보내는 메시지입니다( 예: "오늘 우산을 가져와야 하나요? 시애틀에 있어요." 지침은 개발자가 컨텍스트를 공유하고 다양한 도구를 사용하거나 동작하는 방법에 대한 지침을 AI 모델에 제공하기 위해 제공할 수 있는 시스템 메시지입니다.
사용자가 쿼리를 보낼 때 고객의 AI 모델 배포는 먼저 제공된 지침을 사용하여 쿼리를 처리하여 나중에 Bing 검색 쿼리( 개발자가 볼 수 있음)를 수행합니다. Bing을 사용한 연동은 관련 검색 결과를 고객의 모델 배포에 반환하고, 이를 바탕으로 최종 출력을 생성합니다.
비고
Bing Search에서 Grounding을 사용하는 경우 Bing 검색 쿼리, 도구 매개 변수 및 리소스 키만 Bing으로 전송되며 최종 사용자별 정보는 포함되지 않습니다. 리소스 키는 청구 및 요금 제한 목적으로만 Bing으로 전송됩니다.
권한 부여는 Bing Search 서비스와 Azure AI Foundry 에이전트 서비스를 사용하여 Grounding 간에 발생합니다. 접지 목적으로 생성되어 Bing으로 전송되는 모든 Bing 검색 쿼리는 Azure 규정 준수 경계 외부의 리소스 키와 함께 Bing Search 서비스를 사용하여 Grounding으로 전송됩니다. Bing 검색에서의 접지는 Bing의 사용 약관에 따르며, Bing Search 사용 약관에 설명된 것처럼 Azure AI Foundry 에이전트 서비스와 동일한 규정 준수 표준 및 인증을 보장하지 않습니다. 사용자의 에이전트에서 Bing Search 기반 과정을 사용하는 것이 사용자의 필요와 요구 사항을 충족하는지 평가하는 것은 사용자의 책임입니다.
지원되는 기능 및 알려진 문제
- Grounding with Bing Search 도구는 특정 웹 도메인이 아닌 웹에서 실시간 정보를 검색하도록 설계되었습니다.
- 전체 웹 페이지를 요약 하는 것은 권장되지 않습니다.
- 한 번의 실행에서 AI 모델은 도구 출력을 평가하고 추가 정보 및 컨텍스트를 위해 도구를 다시 호출하도록 결정할 수 있습니다. AI 모델은 응답을 생성하는 데 사용되는 도구 출력을 결정할 수도 있습니다.
- Azure AI 에이전트 서비스는 LLM의 사전/사후 처리로 인해 엔드 투 엔드 대기 시간에 영향을 미칠 AI 모델 생성 응답을 출력으로 반환합니다.
- Bing Search 도구를 사용하여 접지하면 도구 출력이 개발자 및 최종 사용자에게 반환되지 않습니다.
사용량 지원
| Azure AI 파운드리 지원 | Python SDK | C# SDK | JavaScript SDK | REST API (REST 애플리케이션 프로그래밍 인터페이스) | 기본 에이전트 설정 | 표준 에이전트 설정 |
|---|---|---|---|---|---|---|
| ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
설치 프로그램
비고
- Bing Search를 사용한 접지 기능은 Azure AI Foundry 에이전트 서비스에서 지원하는 모든 Azure OpenAI 모델에서 작동하지만
gpt-4o-mini, 2024-07-18제외합니다.
빠른 시작의 단계에 따라 Azure AI 에이전트를 만듭니다.
Bing Search 기반 과정 리소스를 만듭니다. 구독 또는 리소스 그룹 내에서
owner또는contributor역할이 있어야 이를 만들 수 있습니다.- Azure Portal에서 만들 수 있으며 생성 양식에서 다른 필드를 선택할 수 있습니다. Azure AI 에이전트, AI 프로젝트 및 기타 리소스와 동일한 리소스 그룹에 Bing Search 리소스를 사용하여 이 그라운딩 리소스를 생성해야 합니다.
- 코드 우선 방식을 통해 만들 수도 있습니다. 그렇다면 Bing Search를 Azure 리소스 공급자로 수동으로 등록 해야 합니다. 리소스 공급자에 대한
/register/action작업을 수행할 수 있는 권한이 있어야 합니다. 사용 권한은 기여자 및 소유자 역할에 포함됩니다.
az provider register --namespace 'Microsoft.Bing'Bing Search 리소스를 사용하여 Grounding을 만든 후에는 Azure Portal에서 찾을 수 있습니다. 리소스를 만든 리소스 그룹으로 이동하여 만든 Bing Search 기반 과정 리소스를 검색합니다.
선택적 매개 변수
에이전트에 Grounding with Bing Search 도구를 추가하면 다음 매개 변수를 전달할 수 있습니다. 이러한 매개 변수는 Bing Search 도구 출력을 사용하여 접지에 영향을 미치며 AI 모델은 모든 출력을 완전히 사용하지 않을 수 있습니다. API 버전 지원에 대한 정보와 이러한 매개 변수를 전달하는 방법은 코드 예제 를 참조하세요.
| 이름 | 가치 | 유형 | 필수 |
|---|---|---|---|
count |
응답에서 반환할 검색 결과 수입니다. 기본값은 5이고 최대값은 50입니다. 제공되는 실제 수는 요청된 수보다 작을 수 있습니다. 여러 페이지의 결과에 중복이 포함될 수 있습니다. 이 매개 변수는 웹 페이지 결과에만 영향을 줍니다. AI 모델이 Bing에서 반환하는 모든 검색 결과를 사용하지 않을 수 있습니다. | UnsignedShort |
아니오 |
freshness |
대/소문자를 구분하지 않는 연령 값을 사용하여 검색 결과를 필터링합니다. 일: Bing이 지난 24시간 이내에 검색한 웹 페이지를 반환합니다. 주: Bing이 지난 7일 이내에 검색한 웹 페이지를 반환합니다. 월: Bing이 지난 30일 이내에 검색한 웹 페이지를 반환합니다. 특정 기간 동안 Bing에서 검색한 아티클을 얻으려면 형식 YYYY-MM-DD..YYYY-MM-DD으로 날짜 범위를 지정합니다. 예: freshness=2019-02-01..2019-05-30. 결과를 단일 날짜로 제한하려면 이 매개 변수를 특정 날짜로 설정합니다. 예: freshness=2019-02-04. |
String | 아니오 |
market |
결과가 나오는 시장입니다. 일반적으로 mkt 사용자가 요청을 하는 국가입니다. 하지만 사용자가 Bing에서 검색 결과를 제공하는 국가에 위치하지 않는 경우에는 다른 국가가 될 수 있습니다. 시장은 다음과 같은 형식 <language>-<country/region>이어야 합니다. 예: en-US. 문자열은 대/소문자를 구분하지 않습니다. 가능한 시장 가치 목록은 시장 코드를 참조하세요. 알려진 경우 지역/국가를 항상 지정하는 것이 좋습니다. 시장을 지정하면 Bing이 요청을 라우팅하고 적절하고 최적의 응답을 반환하는 데 도움이 됩니다. 시장 코드에 나열되지 않은 시장을 지정하는 경우 Bing은 변경될 수 있는 내부 매핑에 따라 가장 적합한 시장 코드를 사용합니다. |
String | 아니오 |
set_lang |
사용자 인터페이스 문자열에 사용할 언어입니다. 2자 또는 4자 코드를 사용하여 언어를 지정할 수 있습니다. 4자 코드를 사용하는 것이 좋습니다. 지원되는 언어 코드 목록은 Bing 지원 언어를 참조하세요. Bing은 유효한 2자 중립 문화권 코드() 또는 유효한 4자 특정 문화권 코드( setlangfr)가 포함된 경우 fr-ca 지역화된 문자열을 로드합니다. 예를 들어, fr-ca의 경우 Bing은 fr 중립적 문화권 코드 문자열을 로드합니다.setlang가 유효하지 않거나(예: zh) Bing이 해당 언어를 지원하지 않는 경우(예: af, af-na), Bing은 기본적으로 en (영어)를 사용합니다.2자 코드를 지정하려면 이 매개 변수를 ISO 639-1 언어 코드로 설정합니다. 4자 코드를 지정하려면 ISO 639-1 언어 코드(중립 문화권)이고 <language>-<country/region> ISO 3166 국가/지역(특정 문화권) 코드인 양식을 <language><country/region> 사용합니다. 예를 들어 미국 영어에 사용합니다 en-US .선택 사항이지만 항상 언어를 지정해야 합니다. 일반적으로 setLang는 mkt에 지정된 것과 동일한 언어로 설정합니다. 단, 사용자가 사용자 인터페이스 문자열을 다른 언어로 표시되기를 원하는 경우는 예외입니다. |
String | 아니오 |
Bing Search 기반 과정 결과를 표시하는 방법
Bing의 사용 약관 및 표시 요구 사항에 따라 웹사이트 URL과 Bing 검색 쿼리 URL을 사용자 지정 인터페이스에 모두 표시해야 합니다. API 응답에서 매개 변수를 통해 annotations 웹 사이트 URL을 찾고 세부 정보를 통해 runstep Bing 검색 쿼리 URL을 찾을 수 있습니다. 웹 페이지를 렌더링하려면 Bing 검색 쿼리 URL www.bing.com 의 엔드포인트를 대체하고 Bing 검색 쿼리 URL은 "https://www.bing.com/search?q={search query}"와 같이 표시되는 것이 좋습니다.
run_steps = project_client.agents.runs_steps.list(run_id=run.id, thread_id=thread.id)
run_steps_data = run_steps['data']
print(f"Last run step detail: {run_steps_data}")
다음 단계
Bing 도구를 프로그래밍 방식으로 사용하여 Grounding을 사용하는 코드 샘플을 참조하세요.