---
title: "Kehittäjille ja agenteille | OperationsLens"
description: "Liitä tekoälyagentit ja omat järjestelmäsi OperationsLensiin: etä-MCP-liitin OAuth-kirjautumisella sekä REST-rajapinta tiketteihin, asiakkaisiin ja ratkaisutilastoihin."
url: https://operationslens.ai/fi/rajapinnat/
lang: fi
---

Kehittäjille ja agenteille

# Liitä agenttisi ja järjestelmäsi OperationsLensiin.

MCP-liittimen kautta tekoälyagentti käsittelee tikettejä tiimisi jäsenenä. REST-rajapinnan kautta omat järjestelmäsi lukevat tikettejä ja asiakkaita ja luovat uusia tikettejä.

01 · MCP-liitin

## Tekoälyagenteille: MCP-liitin

Etä-MCP-palvelin, johon voi liittyä mikä tahansa MCP-asiakasohjelma, joka tukee etäpalvelimia ja OAuth-kirjautumista. Agentti kirjautuu tiimisi jäsenenä ja toimii täsmälleen tämän jäsenen roolilla ja käyttöoikeuksilla, samoin säännöin kuin OperationsLens-sovelluksessa.

### Palvelimen osoite

```
https://app.operationslens.ai/mcp
```

### Käyttöönotto

1.  Lisää palvelimen osoite MCP-asiakasohjelmaasi etäpalvelimeksi (mukautettu liitin).
2.  Kirjaudu OperationsLens-tunnuksillasi ja valitse organisaatio, jonka liität.
3.  Hyväksy lukuoikeus tai luku- ja kirjoitusoikeus.

### Hyvä tietää

-   Kirjoittavilla työkaluilla on todellisia vaikutuksia: vastaus lähtee asiakkaalle sähköpostina samoin kuin tiimisi lähettäessä sen sovelluksesta.
-   Asiakkaiden kirjoittama teksti merkitään työkalujen tuloksissa asiakasdataksi, jotta agentti erottaa sen ohjeista.
-   Enintään 120 pyyntöä minuutissa yhteyttä kohden.

### Työkalut

-   `whoami` Luku
    
    Organisaatiosi, roolisi ja yritykset, joissa voit työskennellä
    
-   `list_members` Luku
    
    Tiimiläisesi tikettien osoittamista varten
    
-   `search_tickets` Luku
    
    Hae tikettejä tekstillä, tilalla, prioriteetilla, vastuuhenkilöllä tai yrityksellä
    
-   `get_ticket` Luku
    
    Yksi tiketti ja sen uusimmat viestit
    
-   `create_ticket` Kirjoitus
    
    Avaa tiketti ja lähetä se halutessasi asiakkaalle sähköpostina
    
-   `reply_to_customer` Kirjoitus
    
    Vastaa asiakkaalle sähköpostilla tai portaalissa
    
-   `add_internal_note` Kirjoitus
    
    Lisää muistiinpano, jonka vain tiimisi näkee
    
-   `update_ticket` Kirjoitus
    
    Muuta tilaa, prioriteettia tai vastuuhenkilöä. Kun tiketti merkitään ratkaistuksi, asiakas saa tyytyväisyyskyselyn
    

02 · REST-rajapinta

## Omille järjestelmillesi: REST-rajapinta

Palvelinten välinen yhteys omille järjestelmillesi: lue tikettejä ja asiakkaita, luo tikettejä, lisää viestejä ja hae ratkaisutilastoja. Pyynnöt tunnistetaan organisaation API-avaimella.

Tiimimme myöntää API-avaimet pyynnöstä. Avaimella on lukuoikeus, kirjoitusoikeus tai molemmat, sille voi asettaa vanhenemispäivän, ja sen voi rajata yhteen yritykseen.

[Pyydä API-avain](https://operationslens.ai/fi/yhteystiedot/)

### Päätepisteet

-   `GET /api/v1/tickets` Luku
    
    Listaa tiketit uusimmasta alkaen, halutessasi tilan mukaan suodatettuna
    
-   `GET /api/v1/tickets/:id` Luku
    
    Yksi tiketti viesteineen ja tunnisteineen
    
-   `POST /api/v1/tickets` Kirjoitus
    
    Luo tiketti. Asiakas haetaan, tai luodaan, sähköpostiosoitteen perusteella
    
-   `POST /api/v1/tickets/:id/messages` Kirjoitus
    
    Lisää tikettiin viesti tai sisäinen muistiinpano
    
-   `GET /api/v1/customers` Luku
    
    Listaa asiakkaat viimeksi aktiivisesta alkaen
    
-   `GET /api/v1/customers/:id` Luku
    
    Yksi asiakas ja hänen uusimmat tikettinsä
    
-   `GET /api/v1/analytics/resolutions` Luku
    
    Ratkaisutilastot valitulta aikaväliltä
    

### Tunnistautuminen

```
Authorization: Bearer sl_live_…
```

### Esimerkki: tiketin luonti

```
curl -X POST https://app.operationslens.ai/api/v1/tickets \
  -H "Authorization: Bearer $OPERATIONSLENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Order 4411 arrived damaged","customerEmail":"ana@example.com","content":"Two of six boxes crushed."}'
```

### Hyvä tietää

-   Enintään 100 pyyntöä minuutissa avainta kohden. Jokainen vastaus kertoo jäljellä olevan kiintiön X-RateLimit-\*-otsakkeissa.
-   Onnistunut vastaus palauttaa tuloksen data-kentässä, ja listoissa sivutustiedot ovat meta-kentässä. Virhe palauttaa kentät error ja message.
-   Idempotenssiavainta ei ole: tiketin luovan pyynnön uusiminen luo toisen tiketin.

## Mitä nyt on saatavilla

Tällä hetkellä MCP-liitin ja REST-rajapinta käsittelevät tikettejä ja asiakkaita eli OperationsLensin Customer Desk -puolta.

Kehitämme niitä jatkuvasti. Jos haluaisit liittää jotain, mitä täältä ei vielä löydy, esimerkiksi Order Intake- tai Invoice Check -tietoja, kerro meille: palautteesi vaikuttaa siihen, mitä rakennamme seuraavaksi.

## Rakennatko integraatiota, tarvitsetko API-avaimen tai puuttuuko jotain?

[Ota yhteyttä](https://operationslens.ai/fi/yhteystiedot/)