tooluniverse-clinical-guidelines

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Clinical Guidelines Search & Retrieval

临床指南搜索与检索

Search and retrieve evidence-based clinical practice guidelines from 12+ authoritative sources spanning 41 tools. Covers disease management guidelines, society recommendations, pharmacogenomics guidance, and patient resources.

KEY PRINCIPLES:

Multi-source search — Search ≥3 databases in parallel for comprehensive coverage
Source-appropriate queries — Match query style to each database's strengths
Condition + society specific — When user names a disease or society, use targeted tools
English queries first — Use English medical terms in all tool calls; respond in user's language
Cite sources — Every guideline result must include source organization and URL

通过41个工具，在12+权威来源中搜索和检索循证临床实践指南。覆盖疾病管理指南、学会建议、药物基因组学指导及患者资源。

核心原则:

多源搜索 — 并行搜索≥3个数据库，确保全面覆盖
适配源的查询 — 根据每个数据库的优势调整查询风格
特定病症+学会 — 当用户提及疾病或学会时，使用针对性工具
优先英文查询 — 所有工具调用使用英文医学术语；以用户的语言回复
标注来源 — 所有指南结果必须包含来源机构和URL

When to Use

使用场景

Apply when user asks:

"What are the guidelines for [condition]?"
"What does [ADA/AHA/NCCN/NICE/WHO] say about [topic]?"
"Standard of care for [disease]?"
"Drug-gene interactions for [drug/gene]?" (pharmacogenomics)
"Screening recommendations for [condition]?"
"Is there a guideline for [clinical question]?"
"What do guidelines say about [treatment/drug]?"
"Clinical recommendations for [oncology topic]?"

当用户询问以下内容时适用:

"[病症]的指南是什么？"
"[ADA/AHA/NCCN/NICE/WHO]对[主题]有什么建议？"
"[疾病]的护理标准是什么？"
"[药物/基因]的药物-基因相互作用？"（药物基因组学）
"[病症]的筛查建议是什么？"
"有没有针对[临床问题]的指南？"
"指南对[治疗/药物]有什么建议？"
"[肿瘤学主题]的临床建议是什么？"

Phase 0: Tool Verification (MANDATORY FIRST STEP)

阶段0：工具验证（必须首先执行）

Before searching, verify tools load:

python

from tooluniverse import ToolUniverse
tu = ToolUniverse()
tu.load_tools()
assert hasattr(tu.tools, 'NICE_Clinical_Guidelines_Search')

Correct call pattern (use either approach):

python

undefined

搜索前，验证工具是否加载成功:

python

from tooluniverse import ToolUniverse
tu = ToolUniverse()
tu.load_tools()
assert hasattr(tu.tools, 'NICE_Clinical_Guidelines_Search')

正确调用模式（两种方式均可）:

python

undefined

Option A: direct attribute access

方式A：直接属性访问

result = tu.tools.NICE_Clinical_Guidelines_Search(query='diabetes', limit=5)

Option B: run_one_function

方式B：调用run_one_function

result = tu.run_one_function({'name': 'NICE_Clinical_Guidelines_Search', 'arguments': {'query': 'diabetes', 'limit': 5}})

---

result = tu.run_one_function({'name': 'NICE_Clinical_Guidelines_Search', 'arguments': {'query': 'diabetes', 'limit': 5}})

---

Phase 1: Identify Query Strategy

阶段1：确定查询策略

Determine which tools to use based on the user's question:

Query type	Primary tools	Secondary tools
General disease guideline	NICE, TRIP, GIN	PubMed, EuropePMC, CMA
Cardiology	AHA_ACC_search_guidelines, AHA_list_guidelines	NICE, TRIP
Oncology	NCCN_search_guidelines, NCCN_list_patient_guidelines	NICE, GIN
Diabetes / endocrinology	ADA_search_standards, ADA_list_standards_sections	NICE, SIGN
Pharmacogenomics	CPIC_get_gene_drug_pairs, CPIC_list_guidelines	CPIC_get_gene_info
Canadian guidelines	CMA_Guidelines_Search, CTFPHC_search_guidelines	—
Scottish/UK guidelines	SIGN_search_guidelines, NICE	CMA
International guidelines	GIN_Guidelines_Search	OpenAlex, EuropePMC
Living guidelines	MAGICapp_list_guidelines	GIN
Full-text retrieval	NICE_Guideline_Full_Text, WHO_Guideline_Full_Text, AHA_ACC_get_guideline	—

根据用户的问题选择要使用的工具:

查询类型	主要工具	次要工具
通用疾病指南	NICE, TRIP, GIN	PubMed, EuropePMC, CMA
心脏病学	AHA_ACC_search_guidelines, AHA_list_guidelines	NICE, TRIP
肿瘤学	NCCN_search_guidelines, NCCN_list_patient_guidelines	NICE, GIN
糖尿病/内分泌学	ADA_search_standards, ADA_list_standards_sections	NICE, SIGN
药物基因组学	CPIC_get_gene_drug_pairs, CPIC_list_guidelines	CPIC_get_gene_info
加拿大指南	CMA_Guidelines_Search, CTFPHC_search_guidelines	—
苏格兰/英国指南	SIGN_search_guidelines, NICE	CMA
国际指南	GIN_Guidelines_Search	OpenAlex, EuropePMC
动态指南	MAGICapp_list_guidelines	GIN
全文检索	NICE_Guideline_Full_Text, WHO_Guideline_Full_Text, AHA_ACC_get_guideline	—

Phase 2: Multi-Source Search

阶段2：多源搜索

2.1 General Search (Use ≥3 databases)

2.1 通用搜索（使用≥3个数据库）

NICE_Clinical_Guidelines_Search ⭐ (Best general source)

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required)
Returns: list directly (NOT wrapped in dict) —
```
[{title, url, summary, content, date}, ...]
```

Handle:

result = tu.tools.NICE_Clinical_Guidelines_Search(...); isinstance(result, list)

Example:

NICE_Clinical_Guidelines_Search(query='type 2 diabetes management', limit=5)

GIN_Guidelines_Search ⭐ (Best multi-society aggregator)

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required)

Returns: list directly —

[{title, url, description, source, organization}, ...]

Example:

GIN_Guidelines_Search(query='colorectal cancer screening', limit=5)

TRIP_Database_Guidelines_Search

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required),
```
search_type
```
(string, required — must be
'guidelines'
)

Returns: list directly —

[{title, url, description, content, publication}, ...]

Example:

TRIP_Database_Guidelines_Search(query='diabetes', limit=5, search_type='guidelines')

WHO_Guidelines_Search ⚠️ (Limited relevance)

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required)

Returns: list directly —

[{title, url, description, content, source}, ...]

LIMITATION: Does not reliably filter by topic. May return unrelated recent WHO publications.
Use for broad international queries; do not rely on for specific disease searches.

Example:

WHO_Guidelines_Search(query='diabetes', limit=5)

CMA_Guidelines_Search (Canadian)

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required)

Returns: list directly —

[{title, url, description, content, date}, ...]

Example:

CMA_Guidelines_Search(query='diabetes', limit=5)

SIGN_search_guidelines (Scottish/UK)

Parameters:
```
query
```
(string, required — NOT
```
q
```
),
```
limit
```
(integer, optional)

Returns: list directly —

[{number, title, topic, published, url}, ...]

Example:

SIGN_search_guidelines(query='diabetes', limit=5)

CTFPHC_search_guidelines (Canadian prevention)

Parameters:
```
query
```
(string, required — NOT
```
q
```
),
```
limit
```
(integer, optional)
Returns: list directly —
```
[{title, url, year}, ...]
```

Example:

CTFPHC_search_guidelines(query='colorectal cancer', limit=5)

OpenAlex_Guidelines_Search

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required),
```
year_from
```
(integer, optional),
```
year_to
```
(integer, optional)

Returns: list directly —

[{title, authors, institutions, year, doi}, ...]

Example:

OpenAlex_Guidelines_Search(query='diabetes management', limit=5)

(year params optional)

With years:

OpenAlex_Guidelines_Search(query='diabetes management', limit=5, year_from=2020, year_to=2024)

EuropePMC_Guidelines_Search

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required)

Returns: list directly —

[{title, pmid, pmcid, doi, authors}, ...]

Note: May return loosely relevant results; use for literature discovery not definitive guidelines

Example:

EuropePMC_Guidelines_Search(query='diabetes guideline', limit=5)

PubMed_Guidelines_Search

Parameters:
```
query
```
(string, required),
```
limit
```
(integer, required),
```
api_key
```
(string, optional — use
```
''
```
for anonymous)
Returns: list directly —
```
[{title, pmid, pmcid, doi}, ...]
```

Example:

PubMed_Guidelines_Search(query='diabetes guideline', limit=5)

(api_key optional)

NICE_Clinical_Guidelines_Search ⭐（最佳通用来源）

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）
返回值: 直接返回列表（不包裹在字典中） —
```
[{title, url, summary, content, date}, ...]
```

处理方式:

result = tu.tools.NICE_Clinical_Guidelines_Search(...); isinstance(result, list)

示例:

NICE_Clinical_Guidelines_Search(query='type 2 diabetes management', limit=5)

GIN_Guidelines_Search ⭐（最佳多学会聚合器）

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）

返回值: 直接返回列表 —

[{title, url, description, source, organization}, ...]

示例:

GIN_Guidelines_Search(query='colorectal cancer screening', limit=5)

TRIP_Database_Guidelines_Search

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）,
```
search_type
```
（字符串，必填 — 必须为
'guidelines'
）

返回值: 直接返回列表 —

[{title, url, description, content, publication}, ...]

示例:

TRIP_Database_Guidelines_Search(query='diabetes', limit=5, search_type='guidelines')

WHO_Guidelines_Search ⚠️（相关性有限）

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）

返回值: 直接返回列表 —

[{title, url, description, content, source}, ...]

局限性: 无法可靠地按主题筛选。可能返回不相关的近期WHO出版物。
适用场景: 广泛的国际查询；不依赖其进行特定疾病搜索。

示例:

WHO_Guidelines_Search(query='diabetes', limit=5)

CMA_Guidelines_Search（加拿大）

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）

返回值: 直接返回列表 —

[{title, url, description, content, date}, ...]

示例:

CMA_Guidelines_Search(query='diabetes', limit=5)

SIGN_search_guidelines（苏格兰/英国）

参数:
```
query
```
（字符串，必填 — 不是
```
q
```
）,
```
limit
```
（整数，可选）

返回值: 直接返回列表 —

[{number, title, topic, published, url}, ...]

示例:

SIGN_search_guidelines(query='diabetes', limit=5)

CTFPHC_search_guidelines（加拿大预防）

参数:
```
query
```
（字符串，必填 — 不是
```
q
```
）,
```
limit
```
（整数，可选）
返回值: 直接返回列表 —
```
[{title, url, year}, ...]
```

示例:

CTFPHC_search_guidelines(query='colorectal cancer', limit=5)

OpenAlex_Guidelines_Search

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）,
```
year_from
```
（整数，可选）,
```
year_to
```
（整数，可选）

返回值: 直接返回列表 —

[{title, authors, institutions, year, doi}, ...]

示例:

OpenAlex_Guidelines_Search(query='diabetes management', limit=5)

（年份参数可选）

带年份的示例:

OpenAlex_Guidelines_Search(query='diabetes management', limit=5, year_from=2020, year_to=2024)

EuropePMC_Guidelines_Search

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）

返回值: 直接返回列表 —

[{title, pmid, pmcid, doi, authors}, ...]

注意: 可能返回相关性较弱的结果；用于文献发现而非确定指南

示例:

EuropePMC_Guidelines_Search(query='diabetes guideline', limit=5)

PubMed_Guidelines_Search

参数:
```
query
```
（字符串，必填）,
```
limit
```
（整数，必填）,
```
api_key
```
（字符串，可选 — 匿名访问使用
```
''
```
）
返回值: 直接返回列表 —
```
[{title, pmid, pmcid, doi}, ...]
```

示例:

PubMed_Guidelines_Search(query='diabetes guideline', limit=5)

（api_key可选）

2.2 Society-Specific Search

2.2 特定学会搜索

ADA Standards of Care (Diabetes)

ADA_list_standards_sections()

— No parameters. Lists all 19 sections of ADA Standards of Care (2026).

Returns list of section titles with PMIDs

ADA_search_standards(query, limit)

— Search within ADA Standards.

Returns: list —
```
[{title, ...}]
```
Note: Uses PubMed corporate author filter. Use broad medical terms, not specific phrases.

✅ Works:

'glycemic targets'

'pharmacologic approaches'

'cardiovascular risk'

❌ May fail: very specific phrases like
```
'first-line medication metformin'
```

ADA_get_standards_section(section_number)

— Get metadata for a specific section.

Returns dict with section abstract (not full PMC text)

AHA/ACC Cardiology

AHA_ACC_search_guidelines(query, limit)

— Search AHA/ACC guidelines.

Returns: list directly —
```
[{title, ...}]
```

Example:

AHA_ACC_search_guidelines(query='heart failure management', limit=5)

AHA_list_guidelines(limit)

ACC_list_guidelines(limit)

— List recent guidelines.

AHA_ACC_get_guideline(pmid)

— Get full text of AHA/ACC guideline by PMID (via PMC).

Returns dict with full text
Example:
```
AHA_ACC_get_guideline(pmid='37952199')
```

NCCN Oncology

NCCN_list_patient_guidelines(limit)

— List all NCCN patient guideline resources (up to 74).

Returns: list directly —
```
[{cancer_type, url, category}, ...]
```
⚠️ Field is
```
cancer_type
```
, NOT
```
title
```
Use
```
r[i]['cancer_type']
```
to get the cancer name,
```
r[i]['url']
```
for URL

NCCN_search_guidelines(query, limit)

— Search NCCN publications.

Returns: list directly —
```
[{title, ...}]
```
Note: Returns PubMed abstracts of NCCN articles (JNCCN), not proprietary guideline text

NCCN_get_patient_guideline(url)

— Get full text of a patient guideline.

Parameter:
```
url
```
(string) — the full URL from NCCN_list_patient_guidelines

Example:

NCCN_get_patient_guideline(url='https://www.nccn.org/patientresources/patient-resources/guidelines-for-patients/guidelines-for-patients-details?patientGuidelineId=61')

⚠️ Do NOT pass an integer ID — pass the full URL string

MAGICapp Living Guidelines

MAGICapp_list_guidelines(limit)

— List living guidelines.

Returns: dict wrapped —
```
r.get('data', [])
```
gives the list
⚠️ Field is
```
name
```
, NOT
```
title
```
; use
```
item['name']
```
for guideline title
Use
```
item['guidelineId']
```
for follow-up calls

MAGICapp_get_guideline(guideline_id)

— Get full guideline details.

MAGICapp_get_recommendations(guideline_id)

— Get recommendations for a guideline.

MAGICapp_get_sections(guideline_id)

— Get sections.

NCI Resources ⚠️ (Research tools catalog, NOT clinical guidelines)

NCI_search_cancer_resources(q, size)

— Search NCI Research Resources for Researchers (R4R).

⚠️ This is a catalog of bioinformatics tools, datasets, and lab instruments — NOT a clinical guidelines database
Parameters:
```
q
```
(NOT
```
query
```
),
```
size
```
(NOT
```
limit
```
— use
```
size
```
for result count)
Returns: dict —
```
r.get('data', {}).get('results', [])
```
gives the list
Useful for: finding analysis tools, datasets, bioinformatics resources related to a cancer type

Example:

NCI_search_cancer_resources(q='colorectal cancer screening', size=5)

ADA糖尿病护理标准

ADA_list_standards_sections()

— 无参数。列出ADA 2026年护理标准的全部19个章节。

返回包含章节标题和PMID的列表

ADA_search_standards(query, limit)

— 在ADA护理标准内搜索。

返回值: 列表 —
```
[{title, ...}]
```
注意: 使用PubMed机构作者筛选器。使用宽泛的医学术语，而非特定短语。

✅ 有效示例:

'glycemic targets'

'pharmacologic approaches'

'cardiovascular risk'

❌ 可能失败: 非常具体的短语，如
```
'first-line medication metformin'
```

ADA_get_standards_section(section_number)

— 获取特定章节的元数据。

返回包含章节摘要的字典（不是完整PMC文本）

AHA/ACC心脏病学

AHA_ACC_search_guidelines(query, limit)

— 搜索AHA/ACC指南。

返回值: 直接返回列表 —
```
[{title, ...}]
```

示例:

AHA_ACC_search_guidelines(query='heart failure management', limit=5)

AHA_list_guidelines(limit)

ACC_list_guidelines(limit)

— 列出近期指南。

AHA_ACC_get_guideline(pmid)

— 通过PMID获取AHA/ACC指南的全文（通过PMC）。

返回包含全文的字典
示例:
```
AHA_ACC_get_guideline(pmid='37952199')
```

NCCN肿瘤学

NCCN_list_patient_guidelines(limit)

— 列出所有NCCN患者指南资源（最多74个）。

返回值: 直接返回列表 —
```
[{cancer_type, url, category}, ...]
```
⚠️ 字段为
```
cancer_type
```
，而非
```
title
```
使用
```
r[i]['cancer_type']
```
获取癌症名称，
```
r[i]['url']
```
获取URL

NCCN_search_guidelines(query, limit)

— 搜索NCCN出版物。

返回值: 直接返回列表 —
```
[{title, ...}]
```
注意: 返回NCCN文章（JNCCN）的PubMed摘要，而非专有指南文本

NCCN_get_patient_guideline(url)

— 获取患者指南的全文。

参数:
```
url
```
（字符串） — 来自NCCN_list_patient_guidelines的完整URL

示例:

NCCN_get_patient_guideline(url='https://www.nccn.org/patientresources/patient-resources/guidelines-for-patients/guidelines-for-patients-details?patientGuidelineId=61')

⚠️ 请勿传入整数ID — 传入完整的URL字符串

MAGICapp动态指南

MAGICapp_list_guidelines(limit)

— 列出动态指南。

返回值: 包裹在字典中 —
```
r.get('data', [])
```
获取列表
⚠️ 字段为
```
name
```
，而非
```
title
```
；使用
```
item['name']
```
获取指南标题
使用
```
item['guidelineId']
```
进行后续调用

MAGICapp_get_guideline(guideline_id)

— 获取指南的详细信息。

MAGICapp_get_recommendations(guideline_id)

— 获取指南的建议内容。

MAGICapp_get_sections(guideline_id)

— 获取指南的章节。

NCI资源 ⚠️（研究工具目录，非临床指南）

NCI_search_cancer_resources(q, size)

— 搜索NCI研究者资源目录（R4R）。

⚠️ 这是生物信息学工具、数据集和实验室仪器的目录 — 不是临床实践指南数据库
参数:
```
q
```
（不是
```
query
```
）,
```
size
```
（不是
```
limit
```
— 使用
```
size
```
指定结果数量）
返回值: 字典 —
```
r.get('data', {}).get('results', [])
```
获取列表
适用场景: 查找与癌症类型相关的分析工具、数据集、生物信息学资源

示例:

NCI_search_cancer_resources(q='colorectal cancer screening', size=5)

2.3 Pharmacogenomics Search (CPIC)

2.3 药物基因组学搜索（CPIC）

Recommended workflow for gene-drug queries:

Step 1: CPIC_get_gene_info(genesymbol='GENE')          → gene overview
Step 2: CPIC_get_gene_drug_pairs(genesymbol='GENE')    → all drug pairs + CPIC levels
Step 3: CPIC_list_guidelines(limit=50)                 → find guideline_id for gene+drug
Step 4: CPIC_get_recommendations(guideline_id=N)       → specific dosing recommendations
Step 5: CPIC_get_alleles(genesymbol='GENE')            → allele definitions

All CPIC tools return dict-wrapped: use

r.get('data', [])

to access results.

CPIC_get_gene_info(genesymbol)

— Gene overview.

Example:
```
CPIC_get_gene_info(genesymbol='CYP2D6')
```

CPIC_get_gene_drug_pairs(genesymbol, limit)

— All gene-drug interactions with CPIC levels.

Returns:

data

= list of

{genesymbol, drugid, cpiclevel, pgkbcalevel, usedforrecommendation, ...}

```
cpiclevel
```
A/B/C/D: A = strongest evidence

CPIC_list_guidelines(limit)

— All CPIC guidelines.

Returns:

data

= list of

{name: 'GENE and Drug', guidelineId, url, ...}

Use to find the
```
guidelineId
```
for a specific gene+drug pair

CPIC_get_recommendations(guideline_id, limit)

— Get dosing recommendations.

⚠️ Parameter is
guideline_id
(integer), NOT
genesymbol
Workflow: first find guideline_id from
```
CPIC_list_guidelines
```
, then call this

Example:

CPIC_get_recommendations(guideline_id=100416, limit=20)

Returns duplicate records per allele combination — deduplicate by phenotype before presenting

CPIC_get_alleles(genesymbol, limit)

— Allele definitions.

Use

clinicalfunctionalstatus

field (NOT

functionalstatus

which is always null)

Example:

CPIC_get_alleles(genesymbol='CYP2D6', limit=10)

CPIC_get_drug_info(drugname)

— Drug details.

Example:
```
CPIC_get_drug_info(drugname='codeine')
```

CPIC_search_gene_drug_pairs(genesymbol, limit)

— Search gene-drug pairs.

⚠️ Requires PostgREST filter syntax:
```
genesymbol='eq.CYP2D6'
```
(not just
```
'CYP2D6'
```
)

Example:

CPIC_search_gene_drug_pairs(genesymbol='eq.CYP2D6', limit=5)

基因-药物查询推荐流程:

步骤1: CPIC_get_gene_info(genesymbol='GENE')          → 基因概述
步骤2: CPIC_get_gene_drug_pairs(genesymbol='GENE')    → 所有药物对及CPIC等级
步骤3: CPIC_list_guidelines(limit=50)                 → 查找基因+药物对应的guideline_id
步骤4: CPIC_get_recommendations(guideline_id=N)       → 特定给药建议
步骤5: CPIC_get_alleles(genesymbol='GENE')            → 等位基因定义

所有CPIC工具返回字典包裹的结果: 使用

r.get('data', [])

访问结果。

CPIC_get_gene_info(genesymbol)

— 基因概述。

示例:
```
CPIC_get_gene_info(genesymbol='CYP2D6')
```

CPIC_get_gene_drug_pairs(genesymbol, limit)

— 所有带有CPIC等级的基因-药物相互作用。

返回值:

data

= 包含

{genesymbol, drugid, cpiclevel, pgkbcalevel, usedforrecommendation, ...}

的列表

```
cpiclevel
```
A/B/C/D: A = 最强证据

CPIC_list_guidelines(limit)

— 所有CPIC指南。

返回值:

data

= 包含

{name: 'GENE and Drug', guidelineId, url, ...}

的列表

用于查找特定基因+药物对对应的
```
guidelineId
```

CPIC_get_recommendations(guideline_id, limit)

— 获取给药建议。

⚠️ 参数为
guideline_id
（整数），而非
genesymbol
流程: 首先从
```
CPIC_list_guidelines
```
找到guideline_id，然后调用此工具

示例:

CPIC_get_recommendations(guideline_id=100416, limit=20)

返回值: 每个等位基因组合对应多条重复记录 — 展示前按表型去重

CPIC_get_alleles(genesymbol, limit)

— 等位基因定义。

使用
```
clinicalfunctionalstatus
```
字段（
```
functionalstatus
```
字段始终为空，请勿使用）

示例:

CPIC_get_alleles(genesymbol='CYP2D6', limit=10)

CPIC_get_drug_info(drugname)

— 药物详情。

示例:
```
CPIC_get_drug_info(drugname='codeine')
```

CPIC_search_gene_drug_pairs(genesymbol, limit)

— 搜索基因-药物对。

⚠️ 需要使用PostgREST筛选语法:
```
genesymbol='eq.CYP2D6'
```
（不能仅使用
```
'CYP2D6'
```
）

示例:

CPIC_search_gene_drug_pairs(genesymbol='eq.CYP2D6', limit=5)

2.4 Full-Text Retrieval

2.4 全文检索

NICE_Guideline_Full_Text(url)

— Get NICE guideline text.

Use URL from NICE_Clinical_Guidelines_Search results
Returns dict (may have empty data for some guidelines; try chapter URLs like
```
.../chapter/Recommendations
```
)

WHO_Guideline_Full_Text(url)

— Get WHO guideline text.

Note: Most WHO T2D content is in PDFs; tool may return PDF link not full text

AHA_ACC_get_guideline(pmid)

— Get AHA/ACC guideline text via PMC.

NICE_Guideline_Full_Text(url)

— 获取NICE指南文本。

使用NICE_Clinical_Guidelines_Search结果中的URL
返回字典（部分指南可能返回空数据；尝试使用章节URL，如
```
.../chapter/Recommendations
```
）

WHO_Guideline_Full_Text(url)

— 获取WHO指南文本。

注意: 大多数WHO 2型糖尿病内容为PDF格式；工具可能返回PDF链接而非全文

AHA_ACC_get_guideline(pmid)

— 通过PMC获取AHA/ACC指南文本。

Phase 3: Synthesize Results

阶段3：结果合成

3.1 Report Structure

3.1 报告结构

undefined

undefined

Clinical Guidelines: [Topic]

临床指南: [主题]

Summary

摘要

[2-3 sentence overview of what guidelines say]

[2-3句话概述指南内容]

Key Recommendations

核心建议

[Source 1: NICE/ADA/NCCN/etc.]

[来源1: NICE/ADA/NCCN等]

[Key recommendations with evidence grade, URL]

[带有证据等级、URL的核心建议]

[Source 2]

[来源2]

[Key recommendations]

[核心建议]

Pharmacogenomics (if applicable)

药物基因组学（如适用）

[CPIC phenotype-to-recommendation table]

[CPIC表型-建议对应表]

References

参考文献

[All URLs cited]

undefined

[所有引用的URL]

undefined

3.2 Evidence Grading

3.2 证据等级

Grade A (ADA) / Class I (AHA) / Strong (SIGN) = high confidence
Grade B/C = moderate confidence; Grade D / Consensus = expert opinion
CPIC Level A = strongest PGx evidence; B = moderate; C/D = limited
Note recommendation year — guidelines vary in currency (SIGN 2025, ADA 2026, NICE Feb 2026)

A级（ADA）/ I类（AHA）/ 强推荐（SIGN） = 高置信度
B/C级 = 中等置信度；D级 / 共识推荐 = 专家意见
CPIC A级 = 最强药物基因组学证据；B级 = 中等；C/D级 = 有限
注意建议发布年份 — 指南时效性不同（SIGN 2025, ADA 2026, NICE 2026年2月）

3.3 CPIC Recommendation Deduplication

3.3 CPIC建议去重

CPIC returns multiple records for the same phenotype (one per allele combination). Before presenting:

python

seen_phenotypes = set()
unique_recs = []
for rec in recs:
    phenotype = rec.get('phenotype') or rec.get('lookupkey', '')
    if phenotype not in seen_phenotypes:
        seen_phenotypes.add(phenotype)
        unique_recs.append(rec)

CPIC会为同一表型返回多条记录（每个等位基因组合对应一条）。展示前执行以下去重操作:

python

seen_phenotypes = set()
unique_recs = []
for rec in recs:
    phenotype = rec.get('phenotype') or rec.get('lookupkey', '')
    if phenotype not in seen_phenotypes:
        seen_phenotypes.add(phenotype)
        unique_recs.append(rec)

Phase 4: Decision Logic

阶段4：决策逻辑

General disease guideline:

通用疾病指南:

NICE (
```
query
```
,
```
limit
```
) — UK, high quality
GIN (
```
query
```
,
```
limit
```
) — multi-society aggregator ⭐ best for breadth
TRIP (
```
query
```
,
```
limit
```
,
```
search_type='guidelines'
```
)
If cardiac → add AHA_ACC_search_guidelines
If cancer → add NCCN_search_guidelines + NCCN_list_patient_guidelines
If diabetes → add ADA_list_standards_sections + ADA_search_standards

NICE (
```
query
```
,
```
limit
```
) — 英国，高质量
GIN (
```
query
```
,
```
limit
```
) — 多学会聚合器 ⭐ 覆盖范围最广
TRIP (
```
query
```
,
```
limit
```
,
```
search_type='guidelines'
```
)
如果是心脏病 → 添加AHA_ACC_search_guidelines
如果是癌症 → 添加NCCN_search_guidelines + NCCN_list_patient_guidelines
如果是糖尿病 → 添加ADA_list_standards_sections + ADA_search_standards

Pharmacogenomics:

药物基因组学:

```
CPIC_get_gene_info(genesymbol)
```
→ overview
```
CPIC_get_gene_drug_pairs(genesymbol)
```
→ all drugs with CPIC levels
```
CPIC_list_guidelines(limit=50)
```
→ find guideline_id for target gene+drug
```
CPIC_get_recommendations(guideline_id=N)
```
→ specific recs (deduplicate by phenotype)

```
CPIC_get_gene_info(genesymbol)
```
→ 概述
```
CPIC_get_gene_drug_pairs(genesymbol)
```
→ 所有带有CPIC等级的药物
```
CPIC_list_guidelines(limit=50)
```
→ 查找目标基因+药物对应的guideline_id

CPIC_get_recommendations(guideline_id=N)

→ 特定建议（按表型去重）

Full text retrieval:

全文检索:

Find guideline URL/PMID from search results
NICE URL → NICE_Guideline_Full_Text
AHA/ACC PMID → AHA_ACC_get_guideline
WHO URL → WHO_Guideline_Full_Text
NCCN patient guideline URL → NCCN_get_patient_guideline

从搜索结果中找到指南URL/PMID
NICE URL → NICE_Guideline_Full_Text
AHA/ACC PMID → AHA_ACC_get_guideline
WHO URL → WHO_Guideline_Full_Text
NCCN患者指南URL → NCCN_get_patient_guideline

Fallback strategy:

fallback策略:

If NICE returns empty → try TRIP or GIN
If ADA returns 0 results → broaden query terms (e.g.,
```
'pharmacologic approaches'
```
instead of
```
'metformin first-line'
```
)
If WHO returns irrelevant results → skip WHO, use GIN or EuropePMC instead
If CPIC returns no recommendations → list gene-drug pairs with CPIC levels as a proxy

如果NICE返回空结果 → 尝试TRIP或GIN
如果ADA返回0结果 → 扩大查询术语范围（例如，使用
```
'pharmacologic approaches'
```
替代
```
'metformin first-line'
```
）
如果WHO返回不相关结果 → 跳过WHO，使用GIN或EuropePMC替代
如果CPIC返回无建议 → 列出带有CPIC等级的基因-药物对作为替代

Critical Parameter Notes (Verified by Testing)

关键参数说明（经测试验证）

Tool	CORRECT	WRONG
NICE_Clinical_Guidelines_Search	`query='...'` , `limit=N` (both required)	❌ `q='...'`
TRIP_Database_Guidelines_Search	`search_type='guidelines'` required	❌ omitting search_type
OpenAlex_Guidelines_Search	`year_from` / `year_to` are optional	❌ treating as required
PubMed_Guidelines_Search	`api_key` is optional (omit or use `''` )	❌ treating api_key as required
GIN_Guidelines_Search	`limit=N` required	❌ omitting limit
CMA_Guidelines_Search	`limit=N` required	❌ omitting limit
SIGN_search_guidelines	`query='...'` (NOT `q` )	❌ `q='...'`
CTFPHC_search_guidelines	`query='...'` (NOT `q` )	❌ `q='...'`
NCI_search_cancer_resources	`q='...'` , `size=N` (NOT `limit` )	❌ `query=...` or `limit=N`
NCCN_list_patient_guidelines	field `cancer_type` (not `title` )	❌ `.get('title')`
NCCN_get_patient_guideline	`url='https://...'` (full URL string)	❌ integer patientGuidelineId
MAGICapp_list_guidelines	`r.get('data', [])` for list	❌ accessing `r` directly as list
MAGICapp_* items	field `name` (not `title` )	❌ `.get('title')`
CPIC_* tools	`r.get('data', [])` for list	❌ accessing `r` directly
CPIC_get_recommendations	`guideline_id=N` (integer)	❌ `genesymbol='CYP2D6'`
CPIC_search_gene_drug_pairs	`genesymbol='eq.CYP2D6'` (PostgREST)	❌ `genesymbol='CYP2D6'`
CPIC_get_alleles	use `clinicalfunctionalstatus` field	❌ `functionalstatus` (always null)
NCI_search_cancer_resources	`r.get('data',{}).get('results',[])`	❌ `r.get('data', [])`

工具	正确用法	错误用法
NICE_Clinical_Guidelines_Search	`query='...'` , `limit=N` （均必填）	❌ `q='...'`
TRIP_Database_Guidelines_Search	必须指定 `search_type='guidelines'`	❌ 省略search_type
OpenAlex_Guidelines_Search	`year_from` / `year_to` 为可选	❌ 视为必填参数
PubMed_Guidelines_Search	`api_key` 为可选（省略或使用 `''` ）	❌ 视为必填参数
GIN_Guidelines_Search	`limit=N` 必填	❌ 省略limit
CMA_Guidelines_Search	`limit=N` 必填	❌ 省略limit
SIGN_search_guidelines	使用 `query='...'` （不是 `q` ）	❌ `q='...'`
CTFPHC_search_guidelines	使用 `query='...'` （不是 `q` ）	❌ `q='...'`
NCI_search_cancer_resources	使用 `q='...'` , `size=N` （不是 `limit` ）	❌ `query=...` 或 `limit=N`
NCCN_list_patient_guidelines	使用字段 `cancer_type` （不是 `title` ）	❌ `.get('title')`
NCCN_get_patient_guideline	使用 `url='https://...'` （完整URL字符串）	❌ 传入整数patientGuidelineId
MAGICapp_list_guidelines	使用 `r.get('data', [])` 获取列表	❌ 直接将 `r` 视为列表访问
MAGICapp_* 工具	使用字段 `name` （不是 `title` ）	❌ `.get('title')`
CPIC_* 工具	使用 `r.get('data', [])` 获取列表	❌ 直接访问 `r`
CPIC_get_recommendations	使用 `guideline_id=N` （整数）	❌ `genesymbol='CYP2D6'`
CPIC_search_gene_drug_pairs	使用 `genesymbol='eq.CYP2D6'` （PostgREST语法）	❌ `genesymbol='CYP2D6'`
CPIC_get_alleles	使用 `clinicalfunctionalstatus` 字段	❌ `functionalstatus` （始终为空）
NCI_search_cancer_resources	使用 `r.get('data',{}).get('results',[])`	❌ `r.get('data', [])`

Response Format Reference

返回格式参考

Tool	Return type	Access pattern
NICE_Clinical_Guidelines_Search	list (raw)	`result[0]['title']`
GIN_Guidelines_Search	list (raw)	`result[0]['title']`
TRIP_Database_Guidelines_Search	list (raw)	`result[0]['title']`
WHO_Guidelines_Search	list (raw)	`result[0]['title']`
EuropePMC_Guidelines_Search	list (raw)	`result[0]['title']`
PubMed_Guidelines_Search	list (raw)	`result[0]['title']`
CMA_Guidelines_Search	list (raw)	`result[0]['title']`
SIGN_search_guidelines	list (raw)	`result[0]['title']`
CTFPHC_search_guidelines	list (raw)	`result[0]['title']`
ADA_search_standards	list (raw)	`result[0]['title']`
AHA_ACC_search_guidelines	list (raw)	`result[0]['title']`
NCCN_search_guidelines	list (raw)	`result[0]['title']`
NCCN_list_patient_guidelines	list (raw)	`result[0]['cancer_type']`
OpenAlex_Guidelines_Search	list (raw)	`result[0]['title']`
CPIC_list_guidelines	dict → `data`	`r.get('data', [])[0]['name']`
CPIC_get_gene_drug_pairs	dict → `data`	`r.get('data', [])[0]['genesymbol']`
CPIC_get_recommendations	dict → `data`	`r.get('data', [])[0]`
CPIC_get_gene_info	dict → `data`	`r.get('data', {})`
MAGICapp_list_guidelines	dict → `data`	`r.get('data', [])[0]['name']`
NCI_search_cancer_resources	dict nested	`r.get('data',{}).get('results',[])[0]['title']`

工具	返回类型	访问方式
NICE_Clinical_Guidelines_Search	列表（原始）	`result[0]['title']`
GIN_Guidelines_Search	列表（原始）	`result[0]['title']`
TRIP_Database_Guidelines_Search	列表（原始）	`result[0]['title']`
WHO_Guidelines_Search	列表（原始）	`result[0]['title']`
EuropePMC_Guidelines_Search	列表（原始）	`result[0]['title']`
PubMed_Guidelines_Search	列表（原始）	`result[0]['title']`
CMA_Guidelines_Search	列表（原始）	`result[0]['title']`
SIGN_search_guidelines	列表（原始）	`result[0]['title']`
CTFPHC_search_guidelines	列表（原始）	`result[0]['title']`
ADA_search_standards	列表（原始）	`result[0]['title']`
AHA_ACC_search_guidelines	列表（原始）	`result[0]['title']`
NCCN_search_guidelines	列表（原始）	`result[0]['title']`
NCCN_list_patient_guidelines	列表（原始）	`result[0]['cancer_type']`
OpenAlex_Guidelines_Search	列表（原始）	`result[0]['title']`
CPIC_list_guidelines	字典 → `data`	`r.get('data', [])[0]['name']`
CPIC_get_gene_drug_pairs	字典 → `data`	`r.get('data', [])[0]['genesymbol']`
CPIC_get_recommendations	字典 → `data`	`r.get('data', [])[0]`
CPIC_get_gene_info	字典 → `data`	`r.get('data', {})`
MAGICapp_list_guidelines	字典 → `data`	`r.get('data', [])[0]['name']`
NCI_search_cancer_resources	嵌套字典	`r.get('data',{}).get('results',[])[0]['title']`

Known Limitations

已知局限性

WHO_Guidelines_Search: Returns recently-published WHO docs regardless of query topic — results may be irrelevant for specific diseases. Supplement with GIN for international guidelines.
NCI_search_cancer_resources: Catalogs research tools/datasets, NOT clinical practice guidelines.
NICE_Guideline_Full_Text: Retrieves overview page only; recommendation sub-pages (
```
.../chapter/Recommendations
```
) may need direct URL
SIGN: No full-text tool; guideline text only available as PDFs
ADA_get_standards_section: Returns abstract only, not full PMC text
CPIC_get_recommendations: Returns many duplicate records per allele combination; deduplicate by phenotype
NCCN_search_guidelines: Returns PubMed/JNCCN abstracts, not proprietary NCCN guideline text
TRIP content: Some TRIP results link to PDF-gated URLs; content extraction may fail with 403

WHO_Guidelines_Search: 返回近期发布的WHO文档，与查询主题无关 — 针对特定疾病的结果可能不相关。补充使用GIN获取国际指南。
NCI_search_cancer_resources: 收录研究工具/数据集，而非临床实践指南。
NICE_Guideline_Full_Text: 仅检索概述页面；可能需要直接使用建议子页面URL（
```
.../chapter/Recommendations
```
）
SIGN: 无全文工具；指南文本仅以PDF形式提供
ADA_get_standards_section: 返回摘要，而非完整PMC文本
CPIC_get_recommendations: 每个等位基因组合返回多条重复记录；需按表型去重
NCCN_search_guidelines: 返回PubMed/JNCCN摘要，而非NCCN专有指南文本
TRIP内容: 部分TRIP结果链接至PDF gated URL；内容提取可能因403错误失败

Missing Sources (Potential Future Tools)

缺失来源（未来可拓展工具）

USPSTF (US Preventive Services Task Force) — primary US screening recommendations
ACG (American College of Gastroenterology) — gastroenterology guidelines
AGA (American Gastroenterological Association)
Cochrane Reviews — systematic reviews on clinical interventions
AHRQ — Agency for Healthcare Research and Quality

USPSTF（美国预防服务工作组） — 美国主要筛查建议来源
ACG（美国胃肠病学院） — 胃肠病学指南
AGA（美国胃肠病协会）
Cochrane Reviews — 临床干预系统评价
AHRQ — 医疗保健研究与质量局