Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Citações e Fontes Automáticas

Aula 6 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Rastreabilidade da Informação
  2. Como Funcionam as Citações
  3. Utilizar Citações na Sua Aplicação
  4. Casos de Utilização para Citações
  5. Combinar Citações e Filtragem por Domínio
  6. Limitações a Conhecer
  7. Pontos-chave

Rastreabilidade da Informação

Uma das principais vantagens da Pesquisa Web sobre a simples geração de texto é a rastreabilidade. Quando o modelo utiliza informações de uma pesquisa web, a API devolve automaticamente citações com os URLs das fontes que consultou. Isto permite-lhe verificar a informação e apresentá-la com referências na sua aplicação.

Como Funcionam as Citações

A API gera citações automaticamente, sem necessidade de qualquer configuração da sua parte. Assim que a Pesquisa Web estiver ativada e o modelo utilizar resultados de pesquisa na sua resposta, as fontes serão incluídas no objeto de resposta.

Aceda às citações através do campo citations na resposta. Cada citação contém o URL da fonte e o contexto em que foi utilizada.

Utilizar Citações na Sua Aplicação

Apresentar Fontes

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest advancements in quantum computing?",
    tools=[{"type": "web_search"}]
)

# Display the response
print(response.output_text)

# Display the citations
if hasattr(response, 'citations') and response.citations:
    print("\nSources:")
    for citation in response.citations:
        print(f"  - {citation.url}")

Integrar Fontes numa Interface de Utilizador

Numa aplicação web, pode transformar as citações em links clicáveis. Isto reforça a credibilidade da sua aplicação e permite ao utilizador final verificar a informação.

def format_response_with_sources(response):
    output = response.output_text

    if hasattr(response, 'citations') and response.citations:
        output += "\n\n---\n**Sources:**\n"
        for i, citation in enumerate(response.citations, 1):
            output += f"{i}. [{citation.url}]({citation.url})\n"

    return output

Casos de Utilização para Citações

Chatbots Empresariais

Para um assistente de IA criado para os seus clientes, as citações adicionam transparência. O utilizador pode verificar se a informação provém de uma fonte fiável, o que gera confiança nas respostas.

Aplicações de Monitorização

Numa ferramenta de monitorização automatizada, as citações são essenciais para rastrear a origem da informação. Permitem-lhe ligar cada insight à sua fonte e facilitam análises aprofundadas.

Geração de Relatórios

Se utilizar a API para gerar relatórios automatizados, as citações funcionam como uma bibliografia. Documentam as fontes utilizadas e conferem rigor ao relatório.

Combinar Citações e Filtragem por Domínio

Ao combinar allowed_domains com citações, obtém um sistema de pesquisa controlado e rastreável:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Current state of AI regulation in Europe",
    tools=[{
        "type": "web_search",
        "allowed_domains": [
            "ec.europa.eu",
            "eur-lex.europa.eu",
            "legifrance.gouv.fr"
        ]
    }]
)

As citações confirmarão que a informação provém exclusivamente de fontes autorizadas.

Limitações a Conhecer

  • As citações nem sempre estão presentes: se o modelo responder sem utilizar resultados de pesquisa, não são geradas citações
  • O formato exato das citações pode variar consoante o SDK utilizado
  • As citações referenciam as páginas consultadas, não necessariamente as passagens exatas utilizadas
  • O número de citações depende do número de fontes que o modelo efetivamente utilizou

Pontos-chave

  • As citações são automáticas: não requerem configuração
  • São acessíveis através do campo citations na resposta
  • As citações conferem rastreabilidade e credibilidade à sua aplicação
  • Combinam-se com a filtragem por domínio para um controlo total
  • Integre-as na sua interface para permitir a verificação das fontes