웹 검색

에이전트가 질문에 답하거나 작업을 완료하는 데 필요한 정보를 찾아야 할 때 웹 검색을 사용하세요.

예시: 화성이 붉게 보이는 이유 설명하기

다음 JSON 본문을 POST /v1/agents/sessions로 보내면 세션이 생성되고 답변을 스트리밍으로 받을 수 있습니다. 이 요청은 live 모드로 웹 검색을 활성화합니다.

12345678910{
  "agent": {
    "model": "gpt-6-astra",
    "reasoning": { "effort": "low" },
    "tools": [{ "type": "web_search", "mode": "live" }]
  },
  "environment": { "type": "none" },
  "input": "Search NASA's website for why Mars looks red. Explain it in two sentences and include a source link.",
  "stream": true
}

결과

2026년 9월 10일 테스트에서 에이전트는 NASA 웹사이트를 검색한 뒤 다음 답변을 스트리밍했습니다.

Mars looks red because iron minerals in its soil oxidize, or rust, giving the surface a reddish color. This rusty appearance is why it’s called the “Red Planet,” according to NASA’s Mars Facts.

위 답변은 테스트 당시의 기록입니다. 직접 실행하면 다른 답변을 받을 수 있습니다.

web_search를 agent.tools에서 생략하면 기본 제공 웹 검색이 비활성화됩니다. 프롬프트에서 검색을 요청해도 웹 검색은 활성화되지 않습니다.

검색 모드

• live (기본값): 검색 시 인터넷에 실시간으로 접속할 수 있습니다. web_search를 포함하고 mode를 생략하면 이 모드가 적용됩니다.
• cached: 인터넷에 접속하지 않고 저장된 웹 콘텐츠를 검색합니다.
• disabled: 검색 도구를 생략했을 때와 마찬가지로 기본 제공 웹 검색을 비활성화합니다.

선택 설정

같은 web_search 항목에 다음 필드를 추가할 수 있습니다.