II-Commons

Visão Geral

II-Commons oferece recuperação determinística para agentes de pesquisa em corpos de conhecimento do arXiv, PubMed/PMC e corpora de políticas dos EUA suportados. Use-o quando uma tarefa precisar de pesquisa reproduzível, consulta de metadados, recuperação de Markdown de documento completo ou uma verificação de atualidade antes de responder com evidências recentes.

O projeto upstream publica uma CLI Node.js como @intelligentinternet/ii-commons e uma habilidade de agente completa em skills/ii-commons/.

Quando Usar Esta Habilidade

• Use ao pesquisar no arXiv, PubMed/PMC ou corpora de políticas dos EUA suportados em busca de evidências.
• Use quando o usuário solicitar pesquisas recentes ou mais recentes e a atualidade do corpus for importante.
• Use quando você precisar de identificadores estáveis, metadados ou Markdown de documento completo para análise posterior.
• Use ao comparar evidências entre literatura científica e documentos de políticas.

Como Funciona

Etapa 1: Verificar a Atualidade do Corpus

Execute cutoff antes de pesquisas sensíveis à atualidade:

npx @intelligentinternet/ii-commons cutoff

Relate a data de corte relevante antes de interpretar resultados recentes.

Etapa 2: Pesquisar o Corpus Correto

Use este formato de argv. Exemplos literais podem ser digitados como mostrado, mas quando a consulta vem de um prompt do usuário, passe-a como um array de argumentos através da API do runner em vez de interpolá-la em uma string de shell. Aspas duplas não protegem contra substituição de comando em comandos de shell gerados.

npx @intelligentinternet/ii-commons search arxiv "large language model inference" --max-results 10
npx @intelligentinternet/ii-commons search pubmed "type 2 diabetes review" --start 20240000 --max-results 10
npx @intelligentinternet/ii-commons search policy "state overtime rule for agricultural workers" --jurisdictions US-CA --max-results 10

spawnSync("npx", [
  "@intelligentinternet/ii-commons",
  "search",
  "arxiv",
  userQuery,
  "--max-results",
  "10",
]);

Escolha arxiv para preprints e pesquisa técnica, pubmed para literatura biomédica e clínica, e policy para corpora de políticas dos EUA suportados.

Etapa 3: Recuperar Metadados ou Markdown

Use identificadores estáveis dos resultados da pesquisa:

npx @intelligentinternet/ii-commons meta "arXiv:2402.03578"
npx @intelligentinternet/ii-commons markdown "PMCID:PMC11152602"

Construa resumos a partir dos resultados da pesquisa primeiro, depois solicite Markdown quando a inspeção detalhada ou o aterramento de documento completo forem necessários.

Instalação

Execute a CLI com npx:

npx @intelligentinternet/ii-commons --help

Ou instale globalmente:

npm install -g @intelligentinternet/ii-commons
ii-commons cutoff

Para instalar a habilidade completa do agente upstream, instale a pasta skills/ii-commons/ de:

https://github.com/Intelligent-Internet/II-Commons-Skills

Melhores Práticas

• Prefira filtros de data do lado do servidor, como --start e --end, para pesquisas com limite de tempo no arXiv e PubMed.
• Preserve identificadores canônicos como arXiv:<id>, PMID:<id>, PMCID:PMC<id> e policy:<jurisdiction>:<id>.
• Use cutoff como o limite de atualidade autoritativo para cada corpus.
• Mantenha os filtros não temporais conservadores até que os resultados iniciais da pesquisa mostrem o escopo correto.

Limitações

• Requer Node.js 18 ou mais recente e acesso à rede de saída para commons.ii.inc.
• O uso básico funciona sem autenticação; limites de uso mais altos podem exigir um token de API de https://commons.ii.inc/.
• A cobertura de políticas suportada é limitada aos corpora de políticas expostos pelo II-Commons.

Notas de Segurança e Proteção

• Não imprima ou exponha valores de II_COMMONS_API_KEY.
• Trate os resultados como evidências de recuperação, não como revisão especializada. Para trabalhos médicos, legais ou sensíveis a políticas, cite as fontes e preserve a incerteza.
• Os comandos chamam um serviço de API externo; confirme se o acesso à rede é permitido no ambiente do usuário antes de executá-los.

Habilidades Relacionadas

• Use habilidades de pesquisa web mais amplas ou de pesquisa profunda quando as evidências estiverem fora do arXiv, PubMed/PMC ou corpora de políticas suportados.
• Use habilidades de gerenciamento de citações depois que o II-Commons identificar registros de origem estáveis.