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
    字段（草稿、运行中、已停止）
  • 按标志键：匹配
    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