Clinicaltrials Gov 工具¶
Configuration File: clinicaltrials_gov_tools.json
Tool Type: Local
Tools Count: 16
此页面包含在 clinicaltrials_gov_tools.json 配置文件中定义的所有工具。
可用工具¶
ClinicalTrials_get_database_stats (Type: ClinicalTrialsTool)¶
Get aggregate statistics about the ClinicalTrials.gov database, including total number of registe…
ClinicalTrials_get_database_stats tool specification
工具信息：
Name:
ClinicalTrials_get_database_statsType:
ClinicalTrialsToolDescription: Get aggregate statistics about the ClinicalTrials.gov database, including total number of registered studies and size distribution. Returns database-wide counts and file size metrics.
参数：
No parameters required.
示例用法：
query = {
"name": "ClinicalTrials_get_database_stats",
"arguments": {
}
}
result = tu.run(query)
ClinicalTrials_get_field_values (Type: ClinicalTrialsTool)¶
Get value distribution for a specific field across ClinicalTrials.gov studies. Returns all unique…
ClinicalTrials_get_field_values tool specification
工具信息：
Name:
ClinicalTrials_get_field_valuesType:
ClinicalTrialsToolDescription: Get value distribution for a specific field across ClinicalTrials.gov studies. Returns all unique values with study counts. Use to see what status, phase, or study type options exist. Example: ‘Phase’ field returns counts for PHASE1, PHASE2, PHASE3, etc.
参数：
field(string) (required) Field name to get value counts for. Common fields: ‘OverallStatus’ (trial status), ‘Phase’ (trial phase), ‘StudyType’ (Interventional/Observational), ‘LeadSponsorClass’ (industry/NIH/other), ‘InterventionType’ (drug/device/biological).query_cond([‘string’, ‘null’]) (optional) Optional condition filter to restrict value counts to a specific disease area.page_size(integer) (optional) Number of field values to return (default 50).
示例用法：
query = {
"name": "ClinicalTrials_get_field_values",
"arguments": {
"field": "example_value"
}
}
result = tu.run(query)
ClinicalTrials_get_study (Type: ClinicalTrialsTool)¶
Get full details for a specific clinical trial by NCT ID from ClinicalTrials.gov. Returns compreh…
ClinicalTrials_get_study tool specification
工具信息：
Name:
ClinicalTrials_get_studyType:
ClinicalTrialsToolDescription: Get full details for a specific clinical trial by NCT ID from ClinicalTrials.gov. Returns comprehensive protocol including title, objectives, eligibility criteria, interventions, outcome measures, contacts, and results summary. Example: NCT04280705 returns the ACTT remdesivir COVID-19 trial with all details.
参数：
nct_id(string) (required) NCT (National Clinical Trial) identifier (e.g., ‘NCT04280705’, ‘NCT02142712’). Obtain from ClinicalTrials_search_studies.
示例用法：
query = {
"name": "ClinicalTrials_get_study",
"arguments": {
"nct_id": "example_value"
}
}
result = tu.run(query)
ClinicalTrials_search_by_intervention (Type: ClinicalTrialsTool)¶
Search ClinicalTrials.gov for all clinical trials testing a specific drug, biologic, device, or o…
ClinicalTrials_search_by_intervention tool specification
工具信息：
Name:
ClinicalTrials_search_by_interventionType:
ClinicalTrialsToolDescription: Search ClinicalTrials.gov for all clinical trials testing a specific drug, biologic, device, or other intervention. Returns trial IDs, titles, phases, status, and conditions being studied. Ideal for finding all trials for a given drug (e.g., ‘nivolumab’) across all disease indications.
参数：
intervention(string) (required) Drug, biologic, device, or intervention name (e.g., ‘nivolumab’, ‘CRISPR’, ‘CAR-T cells’, ‘metformin’, ‘osimertinib’).condition([‘string’, ‘null’]) (optional) Disease or condition to filter trials (e.g., ‘HER2 breast cancer’, ‘NSCLC KRAS G12C’). Alias for query_cond.status([‘string’, ‘null’]) (optional) Recruitment status filter: ‘RECRUITING’, ‘COMPLETED’, ‘ACTIVE_NOT_RECRUITING’, ‘TERMINATED’. Alias for filter_status.filter_status([‘string’, ‘null’]) (optional) Filter by recruitment status: ‘RECRUITING’, ‘COMPLETED’, ‘ACTIVE_NOT_RECRUITING’, ‘TERMINATED’. Comma-separate multiple.filter_phase([‘string’, ‘null’]) (optional) Filter by trial phase: ‘PHASE1’, ‘PHASE2’, ‘PHASE3’, ‘PHASE4’. Comma-separate multiple.page_size(integer) (optional) Number of results per page (default 10, max 1000).
示例用法：
query = {
"name": "ClinicalTrials_search_by_intervention",
"arguments": {
"intervention": "example_value"
}
}
result = tu.run(query)
ClinicalTrials_search_by_sponsor (Type: ClinicalTrialsTool)¶
Search ClinicalTrials.gov for clinical trials by sponsor or lead organization. Returns trials fun…
ClinicalTrials_search_by_sponsor tool specification
工具信息：
Name:
ClinicalTrials_search_by_sponsorType:
ClinicalTrialsToolDescription: Search ClinicalTrials.gov for clinical trials by sponsor or lead organization. Returns trials funded by pharmaceutical companies, academic institutions, or government agencies. Example: find all Phase 3 trials sponsored by ‘National Cancer Institute’ for cancer conditions.
参数：
sponsor(string) (required) Sponsor or lead organization name (e.g., ‘Pfizer’, ‘National Cancer Institute’, ‘Novartis’, ‘Johns Hopkins University’, ‘Merck’).query_cond([‘string’, ‘null’]) (optional) Optional disease/condition filter (e.g., ‘cancer’, ‘cardiovascular disease’, ‘alzheimer’).filter_status([‘string’, ‘null’]) (optional) Filter by status: ‘RECRUITING’, ‘COMPLETED’, ‘ACTIVE_NOT_RECRUITING’. Comma-separate multiple.filter_phase([‘string’, ‘null’]) (optional) Filter by phase: ‘PHASE1’, ‘PHASE2’, ‘PHASE3’, ‘PHASE4’. Comma-separate multiple.page_size(integer) (optional) Number of results per page (default 10, max 1000).
示例用法：
query = {
"name": "ClinicalTrials_search_by_sponsor",
"arguments": {
"sponsor": "example_value"
}
}
result = tu.run(query)
ClinicalTrials_search_studies (Type: ClinicalTrialsTool)¶
Search ClinicalTrials.gov for clinical trial studies by condition, intervention, sponsor, or othe…
ClinicalTrials_search_studies tool specification
工具信息：
Name:
ClinicalTrials_search_studiesType:
ClinicalTrialsToolDescription: Search ClinicalTrials.gov for clinical trial studies by condition, intervention, sponsor, or other criteria. Returns NCT IDs, titles, status, phase, enrollment, and key trial metadata. Example: search for ‘breast cancer’ trials with ‘pembrolizumab’ that are RECRUITING in Phase 3.
参数：
query_cond([‘string’, ‘null’]) (optional) Disease or condition to search for (e.g., ‘breast cancer’, ‘type 2 diabetes’, ‘COVID-19’). Supports Boolean operators (AND, OR, NOT).query_intr([‘string’, ‘null’]) (optional) Intervention or drug to search for (e.g., ‘pembrolizumab’, ‘metformin’, ‘chemotherapy’).query_term([‘string’, ‘null’]) (optional) Free-text search across all study fields. Use for general keyword search.filter_status([‘string’, ‘null’]) (optional) Filter by recruitment status. Options: ‘RECRUITING’, ‘NOT_YET_RECRUITING’, ‘ACTIVE_NOT_RECRUITING’, ‘COMPLETED’, ‘WITHDRAWN’, ‘SUSPENDED’, ‘TERMINATED’, ‘ENROLLING_BY_INVITATION’. Comma-separate multiple values.filter_phase([‘string’, ‘null’]) (optional) Filter by trial phase. Options: ‘EARLY_PHASE1’, ‘PHASE1’, ‘PHASE2’, ‘PHASE3’, ‘PHASE4’, ‘NA’. Comma-separate multiple (e.g., ‘PHASE2,PHASE3’).filter_study_type([‘string’, ‘null’]) (optional) Filter by study type: ‘INTERVENTIONAL’, ‘OBSERVATIONAL’, ‘EXPANDED_ACCESS’.page_size(integer) (optional) Number of results per page (default 10, max 1000).next_page_token([‘string’, ‘null’]) (optional) Token for retrieving the next page of results (obtained from previous response).query([‘string’, ‘null’]) (optional) General keyword search across all fields. Alias for query_term. E.g., “FLT3 AML”, “KRAS NSCLC”.condition([‘string’, ‘null’]) (optional) Disease or condition to search for. Alias for query_cond. E.g., “acute myeloid leukemia”.status([‘string’, ‘null’]) (optional) Recruitment status filter. Alias for filter_status. E.g., “RECRUITING”, “COMPLETED”.max_results([‘integer’, ‘null’]) (optional) Maximum number of results to return. Alias for page_size.
示例用法：
query = {
"name": "ClinicalTrials_search_studies",
"arguments": {
}
}
result = tu.run(query)
**extract_clinical_trial_adverse_events**（类型：ClinicalTrialsDetailsTool）¶
从clinicaltrials.gov提取详细的不良事件结果，使用其NCT编号。
extract_clinical_trial_adverse_events 工具规格说明
工具信息：
名称：
extract_clinical_trial_adverse_events类型：
ClinicalTrialsDetailsTool描述：根据临床试验注册号（NCT ID）从 clinicaltrials.gov 提取详细的不良事件结果。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).``organ_systems``（数组）（可选）用于筛选不良事件的器官或器官系统列表（具体文本请参见枚举）。仅当输入与术语完全匹配（不区分大小写）时，不良事件才会被匹配。如果未指定，将返回所有不良事件。默认情况下，将返回所有不良事件。
``adverse_event_type``（字符串）（可选）要提取的不良事件类型。选项包括“serious”（仅提取严重不良事件）、“other”（仅提取非严重不良事件）、“all”（提取所有不良事件），或特定事件名称，例如“nausea”（恶心）、“neutropenia”（中性粒细胞减少症）、“epilepsy”（癫痫）（基于MedDRA）。对于特定事件名称，只要输入与其术语部分匹配（不区分大小写），就会匹配相关的不良事件。建议查询特定的不良事件名称，因为通常记录了大量不良事件。如果查询特定事件名称未返回任何结果，应将此参数设置为“serious”以进行合理性检查。默认情况下，该值设置为“serious”，即工具将提取所有严重不良事件。
示例用法：
query = {
"name": "extract_clinical_trial_adverse_events",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**extract_clinical_trial_outcomes**（类型：ClinicalTrialsDetailsTool）¶
从临床试验中提取详细的结果数据（例如，总生存期（月）、p值等）。
extract_clinical_trial_outcomes 工具规范
工具信息：
名称:
extract_clinical_trial_outcomes类型：
ClinicalTrialsDetailsTool描述：根据临床试验注册号（NCT ID）从 clinicaltrials.gov 提取详细的试验结果数据（例如，总生存期（月）、p 值等）。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).``outcome_measure``（字符串）（可选）要提取的结果指标。示例值包括“primary”（仅主要结果）、“secondary”（仅次要结果）、“all”（所有结果），或特定指标名称，例如“survival”（生存）、“overall survival”（总体生存）。对于特定指标名称，只要输入部分匹配其标题或描述（不区分大小写），结果指标就会被匹配。建议在获取结果指标概览（“primary”）后查询特定指标名称。如果查询特定指标名称未返回任何结果，应将此参数设置为“primary”以进行检查。默认情况下，该值设置为“primary”，即工具将提取所有主要结果指标。
示例用法：
query = {
"name": "extract_clinical_trial_outcomes",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**get_clinical_trial_conditions_and_interventions**（类型：ClinicalTrialsDetailsTool）¶
检索诊所的条件或疾病列表，以及干预措施和研究组信息…
get_clinical_trial_conditions_and_interventions 工具规范
工具信息：
名称:
get_clinical_trial_conditions_and_interventions类型：
ClinicalTrialsDetailsTool描述：根据临床试验的NCT编号，检索试验所关注的疾病或病症列表，以及相关的干预措施和试验组信息。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).condition_and_intervention(string) (optional) Unused filter parameter, kept for backward compatibility. Can be omitted or set to any string.
示例用法：
query = {
"name": "get_clinical_trial_conditions_and_interventions",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**get_clinical_trial_descriptions**（类型：ClinicalTrialsDetailsTool）¶
检索试验的详细识别信息，包括标题、阶段和描述。
get_clinical_trial_descriptions 工具规范
工具信息：
名称:
get_clinical_trial_descriptions类型：
ClinicalTrialsDetailsTool描述：根据试验的 NCT ID 获取详细的识别信息，包括标题、阶段和描述。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).description_type(string) (required) Type of information to retrieve. Options are ‘brief’ for brief descriptions or ‘full’ for full descriptions.
示例用法：
query = {
"name": "get_clinical_trial_descriptions",
"arguments": {
"nct_ids": ["item1", "item2"],
"description_type": "example_value"
}
}
result = tu.run(query)
**get_clinical_trial_eligibility_criteria**（类型：ClinicalTrialsDetailsTool）¶
使用其 NCT ID 检索临床试验的资格标准。
get_clinical_trial_eligibility_criteria 工具规范
工具信息：
名称:
get_clinical_trial_eligibility_criteria类型：
ClinicalTrialsDetailsTool描述：根据临床试验的 NCT ID 获取其资格标准。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).eligibility_criteria(string) (optional) Unused filter parameter, kept for backward compatibility. Can be omitted or set to any string.
示例用法：
query = {
"name": "get_clinical_trial_eligibility_criteria",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**get_clinical_trial_locations**（类型：ClinicalTrialsDetailsTool）¶
使用其NCT编号检索临床试验正在进行的地点。
get_clinical_trial_locations 工具规范
工具信息：
名称:
get_clinical_trial_locations类型：
ClinicalTrialsDetailsTool描述：根据NCT编号获取临床试验的开展地点。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).location(string) (optional) Unused filter parameter, kept for backward compatibility. Can be omitted or set to any string.
示例用法：
query = {
"name": "get_clinical_trial_locations",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**get_clinical_trial_outcome_measures**（类型：ClinicalTrialsDetailsTool）¶
使用其 NCT ID 获取临床试验的结果指标。
get_clinical_trial_outcome_measures 工具规范
工具信息：
名称:
get_clinical_trial_outcome_measures类型：
ClinicalTrialsDetailsTool描述：使用临床试验的NCT编号检索其结果指标。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).``outcome_measures``（字符串）（可选）决定是否检索主要、次要或所有结局指标。选项包括 ‘primary’、’secondary’ 或 ‘all’。默认值为 ‘primary’。
示例用法：
query = {
"name": "get_clinical_trial_outcome_measures",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**get_clinical_trial_references**（类型：ClinicalTrialsDetailsTool）¶
使用临床试验的NCT编号检索其参考文献（如有）。
get_clinical_trial_references 工具规格说明
工具信息：
名称：
get_clinical_trial_references类型：
ClinicalTrialsDetailsTool描述：使用临床试验的 NCT ID 检索其参考文献（如有）。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).references(string) (optional) Unused filter parameter, kept for backward compatibility. Can be omitted or set to any string.
示例用法：
query = {
"name": "get_clinical_trial_references",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**get_clinical_trial_status_and_dates**（类型：ClinicalTrialsDetailsTool）¶
使用NCT编号检索试验状态及开始和完成日期。
get_clinical_trial_status_and_dates 工具规格说明
工具信息：
名称：
get_clinical_trial_status_and_dates类型：
ClinicalTrialsDetailsTool描述：使用其 NCT ID 检索试验状态及开始和完成日期。
参数：
nct_ids(array) (required) List of NCT IDs of the clinical trials (e.g., [‘NCT04852770’, ‘NCT01728545’]).status_and_date(string) (optional) Unused filter parameter, kept for backward compatibility. Can be omitted or set to any string.
示例用法：
query = {
"name": "get_clinical_trial_status_and_dates",
"arguments": {
"nct_ids": ["item1", "item2"]
}
}
result = tu.run(query)
**search_clinical_trials**（类型：ClinicalTrialsSearchTool）¶
Search ClinicalTrials.gov for clinical trials by disease/condition, drug/intervention, or keyword…
search_clinical_trials 工具规格说明
工具信息：
名称：
search_clinical_trials类型：
ClinicalTrialsSearchToolDescription: Search ClinicalTrials.gov for clinical trials by disease/condition, drug/intervention, or keywords. This is the PRIMARY tool for finding clinical trials — use it when you need to discover trials for a drug (e.g., ‘olaparib’, ‘pembrolizumab’), a disease (e.g., ‘lung cancer’, ‘diabetes’), or any study criteria. Accepts condition names, intervention/treatment names, and free-text queries. Returns NCT IDs and brief descriptions with pagination. Use the returned NCT IDs with ‘get_clinical_trial_*’ tools for detailed protocol info, or ‘extract_clinical_trial_*’ tools for efficacy/safety results. Limited to trials beyond phase 1.
参数：
``condition``（字符串）（可选） 使用 Essie 表达式语法查询病症或疾病（例如，’lung cancer’，’(head OR neck) AND pain AND NOT “back pain”’）。
``intervention``（字符串）（可选） 使用 Essie 表达式语法查询干预/治疗（例如，‘化疗’、‘免疫治疗’、‘奥拉帕利’、‘联合治疗’）。
query_term(string) (optional) Query for ‘other terms’ with Essie expression syntax (e.g., ‘combination’, ‘AREA[LastUpdatePostDate]RANGE[2023-01-15,MAX]’, ‘Phase II’). Can be used to search for all other protocol fields, including but not limited to title, outcome measures, status, phase, location, etc.``pageSize``（整数）（可选）每页返回的最大研究数量（默认值为10，最大值为1000）。
``pageToken``（字符串）（可选）用于获取下一页结果的令牌，取自前一次响应中的 nextPageToken 字段。首次请求时无需指定该参数。当您首次调用支持分页的 API 时，响应中会包含一个 nextPageToken。该令牌可作为后续 API 请求的参数，用于获取下一批数据。
overall_status(array) (optional) Filter by overall study status (e.g., [‘RECRUITING’], [‘COMPLETED’], [‘RECRUITING’, ‘NOT_YET_RECRUITING’]). Valid values: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, ENROLLING_BY_INVITATION, SUSPENDED, TERMINATED, WITHDRAWN.max_results(integer) (optional) Maximum number of studies to return (alias for pageSize, default 10, max 1000).limit(integer) (optional) Alias for max_results: maximum number of studies to return (default 10, max 1000).status(unknown) (optional) Alias for overall_status. Filter by trial status, e.g. “RECRUITING”, “COMPLETED”.keyword(string) (optional) Alias for query_term. Free-text keyword search across all trial fields (e.g., drug name, condition, investigator).
示例用法：
query = {
"name": "search_clinical_trials",
"arguments": {
}
}
result = tu.run(query)