Back to Details

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
    字段（draft、running、stopped）
  • 按标志键匹配：匹配
    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.
  • 唯一匹配项：直接使用该实验ID。执行破坏性操作（删除、发布、结束）前，需通过名称与用户确认。
  • 多个匹配项：列出所有匹配实验的名称、状态和创建日期，请求用户选择。
  • 无匹配项：告知用户，并建议其检查已归档实验或尝试其他关键词。

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