Eksempel på kobling (forhåndsversjon)

Viktig!

[Denne artikkelen er forhåndsutgitt dokumentasjon og kan endres.]

Du kan bruke den sertifiserte koblingshandlingen basert på Contoso Hub – Koblinger for å sjekke ut utvidelsespunktene som er tilgjengelige i Salg.

Hvis du vil prøve den sertifiserte koblingshandlingen, følger du instruksjonene i Administrer utvidelser for salgsagenten og aktiverer Contoso Hub-koblingshandlingen for salgsagenten.

Du kan redigere eksempelkoblingen og handlingen for å komme raskt i gang. Se retningslinjene nedenfor når du redigerer eller oppretter koblingen eller handlingene for den:

  • Eksempelkoblingen inneholder plassholdere for API-banene. Du kan erstatte disse plassholderne med de faktiske API-banene.

  • HTTP-metoder må samsvare med de som er angitt i OpenAPI-eksempeldefinisjonen.

  • OpenAPI-definisjonen som koblingen returnerer, brukes til å tilordne inndata- og utdataparametere basert på beskrivelsene. Alle obligatoriske parametere i OpenAPI-eksempeldefinisjonen må finnes i den faktiske koblingsdefinisjonen, og de må ha riktige beskrivelser.

  • Typene inndataparameter må samsvare med de som er angitt i OpenAPI-definisjonen.

  • API-er som beskrives av OpenAPI-definisjonen, skal ikke inneholde obligatoriske parametere som ikke finnes i OpenAPI-eksempeldefinisjonen. Ellers aktiverer ikke salgsagenten API-ene og mislykkes med en intern feil.

  • Ikke bruk connectorId som inndataparameter i OpenAPI-definisjonen, fordi den er en reservert parameter.

  • Egenskaper for utdataobjekter som er merket som nødvendige i OpenAPI-definisjonen, må finnes i API-svaret.

  • Hver koblings-API skal fullføre kjøringen innen fem sekunder, særlig koblingshandlingene som forbedrer eksisterende funksjoner.

  • Det forventes at godkjenning blir håndtert av konstruktørene i Microsoft Power Platform-koblingen, og dette er utenfor omfanget til hver API.

  • Språket til den gjeldende brukeren sendes i forespørselshodet som Accept-Language. Bruk det til alle språkspesifikke operasjoner.

  • Les følgende hoder fra forespørselen til koblingen, og send dem til serverdelen for å oppnå bedre diagnostisering:

    • x-ms-client-request-id: En unik identifikator for den innkommende forespørselen.
    • x-ms-user-agent: «sales-copilot» brukes som verdi.

Utvid salgsagent med partnerprogrammer
Bygg utvidelser for salgsagent

  • Last updated on