digitalinnovationone/dio-agent/web-search

Skill: Pesquisa na Web (respostas fundamentadas)

Fundamenta a resposta em informação atual da web, usando a busca do You.com, e sempre cita as fontes. Serve para quando a base de conhecimento da DIO e o seu conhecimento interno não bastam, porque o assunto muda com o tempo.

Quando usar

Use esta skill quando a boa resposta depende de algo atual ou que precisa ser conferido, por exemplo:

• versões atuais de uma linguagem, framework ou ferramenta (ex.: "qual a versão estável do Node hoje?");
• lançamentos, notícias ou mudanças recentes de tecnologia;
• panorama de mercado, tendências ou o que está sendo pedido em vagas;
• qualquer pergunta com "agora", "atual", "hoje" ou um ano recente;
• fatos que você não tem certeza e que seria irresponsável responder de memória.

Se a dúvida for sobre um conceito estável (o que é uma variável, como funciona um for), não precisa de busca: use a skill explain-concept.

Antes de usar: a busca precisa estar conectada

Esta skill usa a ferramenta de busca do You.com, conectada ao seu harness como um servidor MCP (uma capacidade nativa do harness, não um script). Se a ferramenta you-search não estiver disponível, siga o guia docs/youcom-mcp.md para conectá-la uma única vez. Existe uma opção gratuita, sem cadastro, ótima para estudantes.

IMPORTANTE: Nunca escreva nem rode scripts ou código para buscar na web ou raspar páginas. Buscar é uma ação nativa do harness (a ferramenta you-search), não uma tarefa de programação. Se você se pegar criando um arquivo, instalando bibliotecas ou vasculhando HTML, pare: isso queima tokens à toa. Se a busca não estiver disponível, avise o estudante e siga com o que você já sabe, deixando claro o que não pôde confirmar.

Processo

1. Decida se a busca é mesmo necessária

Pergunte a si mesmo: a resposta muda com o tempo, ou é um conceito estável? Só busque quando a atualidade importa. Uma busca desnecessária é mais lenta e não ajuda o estudante.

2. Monte uma consulta boa

Escreva a consulta como uma pessoa pesquisaria, em português, curta e específica. Inclua o ano quando a atualidade for o ponto (ex.: melhores práticas React 2026). Uma consulta focada traz fontes melhores que uma frase longa.

3. Faça a busca com a ferramenta you-search

Chame a ferramenta you-search com a sua consulta no parâmetro query. Parâmetros úteis, todos opcionais:

• count: quantos resultados trazer (comece com 5);
• freshness: recorte de tempo (day, week, month, year) quando só interessa o recente;
• language e country: para priorizar conteúdo em português (language=pt, country=BR).

Não invente resultado. Se a ferramenta não responder, diga isso ao estudante.

4. Leia os resultados com olhar crítico

Cada resultado traz título, link e um trecho. Prefira fontes confiáveis (documentação oficial, sites reconhecidos) e observe a data quando ela aparecer. Descarte o que for propaganda ou claramente desatualizado.

5. Responda fundamentando na fonte, não copiando

Explique com as suas palavras, no tom de mentor da DIO, apoiando-se no que as fontes dizem. Não cole textão nem repita a página inteira.

6. Cite as fontes

Termine com uma lista curta das fontes que embasaram a resposta, cada uma com título e link. Citar é o que torna a resposta fundamentada: o estudante pode conferir e se aprofundar. Uma resposta sem fonte, para um assunto que muda com o tempo, não serve.

7. Conecte com a DIO

Quando fizer sentido, aponte onde o estudante pode se aprofundar dentro da DIO (um Curso, uma Formação ou um Desafio relacionado ao tema pesquisado).

Lembre-se

• Só busque quando a atualidade importa. Para conceitos estáveis, explique direto.
• Sempre cite as fontes. Resposta atual sem link não é uma resposta fundamentada.
• Nunca escreva scripts para buscar ou raspar a web. Use a ferramenta nativa you-search.
• Fonte não confiável é pior que nenhuma. Prefira documentação oficial e sites reconhecidos.
• Se a busca não estiver disponível, seja honesto sobre o que você não pôde confirmar.