Arbejdsgange og eksempler

Forbered et kundemøde

Sig: “Forbered mig på mødet med kunden på alex@example.com. Vis aktive og afsluttede deals, kontaktpersoner, noter og seneste dokumenterede udveksling.” frida_prepare_customer_briefing kan bruge den præcise mailadresse direkte; hvis flere kunder passer, skal du vælge.

Svaret samler kundetotaler per valuta og højst tre deals med begrænsede noter, historik og mailuddrag. Det opretter ikke et møde. Assistenten skal skelne mellem gemte oplysninger og sine egne forslag.

{
  "name": "frida_prepare_customer_briefing",
  "arguments": {
    "email": "alex@example.com",
    "deal_limit": 2
  }
}

{
  "selected_deals": 2,
  "more_contacts": false,
  "selection_is_complete": false
}

Se pipeline og historisk udvikling

Sig: “Vis udviklingen i min pipeline de seneste 12 uger. Adskil valutaer, og vis hvor historikken er ufuldstændig.” Brug frida_get_pipeline_overview til totaler og frida_get_pipeline_history til perioder. Læg ikke selv sider fra en deal-liste sammen.

recorded_pipeline beskriver observerede åbnings- og slutbalancer. complete_since fortæller, hvor dækningen begynder. Tidligere eller delvis dækning betyder ukendt, ikke nul. Dealværdi er ikke bogført omsætning.

{
  "name": "frida_get_pipeline_history",
  "arguments": {
    "interval": "week",
    "periods": 12,
    "time_zone": "Europe/Copenhagen"
  }
}

{
  "recorded_pipeline": null
}

Find de præcise Outlook-ID’er

Find først dealen med frida_search_deals og brug dens deal_id i frida_get_deal_mail_references. Følg next_cursor, hvis der er flere sider. Svaret indeholder referencer, ikke mailindhold.

Fridas interne ID, udbyderens besked-ID, tråd-ID og internet-ID er forskellige felter. Bevar dem præcist. Outlook-ID’er kan ændres, når en mail flyttes. Brug samme postkasse; direkte hentning gennem en anden Outlook-integration er ikke verificeret. Outlook-kontakt-ID’er er ikke gemt i Frida.

{
  "name": "frida_get_deal_mail_references",
  "arguments": {
    "deal_id": "00000000-0000-4000-8000-000000000001",
    "limit": 50
  }
}

{
  "has_more": true,
  "next_cursor": "illustrative-opaque-cursor",
  "coverage": "partial_stored_deal_mail"
}

Ret en deal efter en samtale

Sig præcist, hvad du vil ændre, og på hvilken deal. Assistenten skal beskrive rettelsen først og have en forbindelse godkendt med deals.write. Eksemplet sætter kun beløbet og forudsætter dit udtrykkelige ønske.

Ved frida_update_deal: læs dealen først, brug dens updated_at som expected_updated_at, og opret ét request_id per ønsket rettelse. Ved timeout skal samme request_id og samme input genbruges. Kontrollér kvitteringen med frida_get_change_status; påstå aldrig, at rettelsen lykkedes uden kvittering.

Kvitteringen indeholder før og efter. Note, beløb, stadie og forventet lukkedato kan fortrydes i 24 timer med change_id, hvis det samme felt ikke er ændret siden. Kontrollér undo_available og undo_until i kvitteringen; et tidligere tomt beløb kan ikke genskabes her. Reglen gælder ikke automatisk andre handlinger som opfølgning eller svar på spørgsmål.

{
  "name": "frida_update_deal",
  "arguments": {
    "change": {
      "deal_id": "00000000-0000-4000-8000-000000000001",
      "action": "set_value",
      "value": 25000,
      "expected_updated_at": "2026-10-05T10:00:00Z",
      "request_id": "00000000-0000-4000-8000-000000000002"
    }
  }
}

Følg ændringer siden sidst

Brug frida_get_changes med since, eller fortsæt med next_cursor. Følg alle sider; counts_by_kind tæller kun den enkelte side. Gem det returnerede as_of til næste gennemgang. En tilbagevendende gennemgang kræver en særskilt planlagt opgave i assistenten; MCP-forbindelsen starter den ikke selv.