Busca na web que funciona

Trabalhando com a OpenAI Responses API

James Chapman

AI Curriculum Manager, DataCamp

A necessidade de informação atualizada

LLMs → têm um knowledge cut-off
- Pode ter >1 ano:
  - ex.: GPT 4.1 é de junho de 2024
- Problemático para código, pesquisa e mais...

Knowledge cutoffs na prática

response = client.responses.create(
    model="gpt-5-mini",
    input="What is the current temperature in Tokyo, Japan?"
)

print(response.output_text)

Não consigo acessar dados em tempo real, então não posso dizer a temperatura
atual de Tóquio agora.

Começando com busca na web

response = client.responses.create(
    model="gpt-5-mini",

    tools=[{"type": "web_search"}],

    input="What is the current temperature in Tokyo, Japan?"
)

print(response.output_text)

Temperatura atual em Tóquio (Japão): 46°F (8°C), neblina. (Em 25 nov 2025,
horário de Tóquio.)

Como a busca funciona por baixo do capô

for item in response.output:
    print(item)

ResponseReasoningItem(id='...', summary=[], type='reasoning', content=None,
                      encrypted_content=None, status=None)

ResponseFunctionWebSearch(id='...', action=ActionSearch(query='weather: Tokyo, Japan',
                          type='search', sources=None), status='completed',
                          type='web_search_call')

ResponseReasoningItem(id='...', summary=[], type='reasoning', content=None,
                      encrypted_content=None, status=None)

ResponseOutputMessage(id='...', content=[ResponseOutputText(annotations=[],
                      text='Current temperature in Tokyo (Japan)...', type='output_text',
                      logprobs=[])], role='assistant', status='completed', type='message')

Incluindo todas as fontes

response = client.responses.create(
    model="gpt-5-mini",
    tools=[{"type": "web_search"}],
    input="What is the current temperature in Tokyo, Japan?",

    include=["web_search_call.action.sources"]

)

for item in response.output:
    if item.type == "web_search_call":
        print(item)

ResponseFunctionWebSearch(id='...', action=ActionSearch(query='weather: Tokyo, Japan',
                          type='search', sources=[ActionSearchSource(type='api', url=None,
                          name='oai-weather')]), status='completed', type='web_search_call')

Outros tipos de fonte

response = client.responses.create(
    model="gpt-5-mini",
    tools=[{"type": "web_search"}],
    input="What is the latest Python version released?",
    include=["web_search_call.action.sources"]
)

for item in response.output:
    if item.type == "web_search_call":
        print(item.action.sources)

Outros tipos de fonte

[{'type': 'url', 'url': 'https://www.python.org/doc/versions/'},
 {'type': 'url', 'url': 'https://test.python.org/doc/versions/'},
 {'type': 'url', 'url': 'https://www.techradar.com/pro/...'}]

[{'type': 'url', 'url': 'https://www.python.org/downloads/latest/python3.14/'},
 {'type': 'url', 'url': 'https://www.python.org/downloads/release/python-3140rc1/'},
 {'type': 'url', 'url': 'https://blog.python.org/2025/10/python-3140-final-is-here.html'},
 {'type': 'url', 'url': 'https://www.python.org/downloads/release/python-3140rc2/'},
 {'type': 'url', 'url': 'https://peps.python.org/pep-0745/'},
 {'type': 'url', 'url': 'https://blog.python.org/2025/05/python-3140-beta-1-is-here.html'},
 {'type': 'url', 'url': 'https://www.python.org/downloads/release/python-3140rc3/'},
 {'type': 'url', 'url': 'https://blog.python.org/2025/10/'},
 {'type': 'url', 'url': 'https://blog.python.org/2025/07/python-314-release-candidate-1-is-go.html'},
 {'type': 'url', 'url': 'https://blog.python.org/2025/01/python-3140-alpha-4-is-out.html'},
 {'type': 'url', 'url': 'https://mail.python.org/archives/list/python-announce-list...'}]

Vamos praticar!

Trabalhando com a OpenAI Responses API