Garasu
DocsMarkdown

query_learnings

Search a project's learnings by semantic similarity. Each learning includes related_experiments plus last_synced_at and sync_status. Wait and search again while sync_status is syncing.

Operation ID: query_learnings

Search a project's learnings by semantic similarity. Each learning includes related_experiments plus last_synced_at and sync_status. Wait and search again while sync_status is syncing.

When to use: You need existing learnings related to a question, hypothesis, or idea in this project.

Returns: { learnings: [{ id, project_id, title, category, summary, strength_of_evidence, similarity, related_experiments, last_synced_at, sync_status, created_at, updated_at, source_url }] }

FieldTypeRequiredDescription
project_iduuidYesProject id from list_projects.
querystringYesNatural-language search text. 1–2000 characters.
limitintegerNoMax learnings to return. Default 10, max 50.

Function schema:

{
  "name": "query_learnings",
  "description": "Search a project's learnings by semantic similarity. Each learning includes related_experiments plus last_synced_at and sync_status. Wait and search again while sync_status is syncing. You need existing learnings related to a question, hypothesis, or idea in this project.",
  "parameters": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "project_id": {
        "type": "string",
        "format": "uuid",
        "description": "Project id from list_projects."
      },
      "query": {
        "type": "string",
        "description": "Natural-language search text. 1–2000 characters."
      },
      "limit": {
        "type": "integer",
        "description": "Max learnings to return. Default 10, max 50."
      }
    },
    "required": [
      "project_id",
      "query"
    ]
  }
}

Request:

{
  "project_id": "11111111-1111-4111-8111-111111111111",
  "query": "shipping cost transparency at checkout",
  "limit": 10
}

Response:

{
  "learnings": [
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "project_id": "11111111-1111-4111-8111-111111111111",
      "title": "Shipping estimates lift checkout completion",
      "category": "Checkout",
      "summary": "Showing an estimated shipping range on cart raised checkout completion. People dropped off when cost appeared for the first time at payment.",
      "strength_of_evidence": 0.72,
      "related_experiments": [
        "22222222-2222-4222-8222-222222222222"
      ],
      "last_synced_at": "2026-03-29T15:04:00.000Z",
      "sync_status": "idle",
      "source_url": "https://garasu.co/app/77777777-7777-4777-8777-777777777777/projects/11111111-1111-4111-8111-111111111111/learnings/44444444-4444-4444-8444-444444444444",
      "created_at": "2026-03-29T14:12:00.000Z",
      "updated_at": "2026-03-29T14:12:00.000Z",
      "similarity": 0.86
    }
  ]
}