Citações e Fontes Automáticas
Nesta página
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
citationsna 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