finding-experiments

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Finding experiments

查找实验

Users refer to experiments by name, description, or relative references — not by ID. This skill resolves natural language references to concrete experiment IDs.

用户通过名称、描述或相对引用指代实验，而非ID。本技能可将自然语言引用解析为具体的实验ID。

How to find an experiment

如何查找实验

Use the experiment-list tool from the Posthog-local MCP server.

IMPORTANT: Do NOT use

feature-flag-get-all

or any feature flag tool to find experiments. Use the dedicated experiment list tool:

experiment-list

This tool returns experiments with their id, name, status, feature_flag_key, start_date, end_date, and created_at. Browse the returned list to find the experiment matching the user's reference:

By name: scan the
```
name
```
field for matches
By recency: results are ordered newest first by default
By status: match the
```
status
```
field (draft, running, stopped)
By flag key: match the
```
feature_flag_key
```
field

使用Posthog-local MCP服务器中的experiment-list工具。

重要提示：请勿使用

feature-flag-get-all

或任何功能标志工具查找实验。请使用专用的实验列表工具：

experiment-list

。

该工具返回的实验信息包含id、name、status、feature_flag_key、start_date、end_date和created_at。浏览返回列表以找到与用户引用匹配的实验：

按名称：扫描
```
name
```
字段查找匹配项
按时间远近：结果默认按最新创建排序
按状态：匹配
```
status
```
字段（草稿、运行中、已停止）
按标志键：匹配
```
feature_flag_key
```
字段

After finding matches

找到匹配项后

Exactly one match: Use it. Confirm with the user by name before destructive actions (delete, ship, end).
Multiple matches: List them with name, status, and creation date. Ask the user to pick.
No matches: Tell the user. Suggest checking archived experiments or different terms.

恰好一个匹配项：直接使用。在执行破坏性操作（删除、发布、结束）前，需通过名称与用户确认。
多个匹配项：列出所有匹配项的名称、状态和创建日期，请求用户选择。
无匹配项：告知用户。建议检查已归档实验或尝试其他术语。

Get full details if needed

如需获取完整详情

After resolving to an ID, call

experiment-get

for the full object (metrics, flag details, parameters).

解析到ID后，调用

experiment-get

获取完整对象（指标、标志详情、参数）。

Examples

示例

text

User: "pause my signup experiment"

Agent:
1. Calls experiment-list
2. Scans results, finds "New signup process" (ID: 1371, status: running)
3. Proceeds to pause experiment 1371

text

User: "pause my signup experiment"

Agent:
1. Calls experiment-list
2. Scans results, finds "New signup process" (ID: 1371, status: running)
3. Proceeds to pause experiment 1371

When NOT to search

无需搜索的场景

You already have the experiment ID from earlier in the conversation
The user just created the experiment — you have the ID from the create response
The user provided the ID directly

对话前期已获取实验ID
用户刚创建实验——可从创建响应中获取ID
用户直接提供了ID