Exemplu de conector (versiune preliminară)

Important

[Acest articol este documentație de prelansare și poate suferi modificări.]

Poți folosi acțiunea conectorului certificat bazată pe Contoso Hub - Conectori pentru a verifica punctele de extensibilitate disponibile în Vânzări.

Pentru a încerca acțiunea conectorului certificat, urmează instrucțiunile din Gestionarea extensiilor pentru agentul de vânzări și activează acțiunea conectorului Contoso Hub pentru agentul de vânzări.

Puteți edita conectorul eșantionului și acțiunea pentru a începe rapid. Consultați următoarele instrucțiuni atunci când editați crearea conectorului sau acțiunile acestuia:

  • Conectorul eșantion conține substituenți pentru căile API. Puteți înlocui acești substituenți cu căile API reale.

  • Metodele HTTP ar trebui să se potrivească cu cele specificate în definiția eșantion OpenAPI .

  • OpenAPI Definiția pe care o returnează conectorul este utilizată pentru a mapa parametrii de intrare și de ieșire pe baza descrierilor. Toți parametrii necesari din definiția eșantion OpenAPI trebuie să fie prezenți în definiția actuală a conectorului și trebuie să aibă descrieri corecte.

  • Tipurile de parametri de intrare ar trebui să se potrivească cu cele specificate în OpenAPI definiția.

  • API-urile care sunt descrise de OpenAPI definiția nu ar trebui să conțină niciun parametru necesar care nu este prezent în eșantionul de OpenAPI definiție. Altfel, agentul de vânzări nu invocă API-urile și eșuează din cauza unei erori interne.

  • Nu utilizați connectorId ca parametru de intrare în definiția OpenAPI , deoarece este un parametru rezervat.

  • Proprietățile obiectelor de ieșire care sunt marcate ca fiind necesare în OpenAPI definiția trebuie să fie prezente în API-ul răspuns.

  • Fiecare API conector ar trebui să-și finalizeze execuția în cinci secunde, în special acțiunile conectorului care îmbunătățesc capacitățile existente.

  • Se așteaptă ca autentificarea să fie gestionată de constructele din conectorul Microsoft Power Platform și se află în afara domeniului de aplicare al fiecărui API.

  • Limba utilizatorului curent este transmisă în antetul solicitării ca Accept-Language. Utilizați-l pentru orice operațiuni specifice limbii.

  • Citiți următoarele antete din solicitare către conector și trimiteți-le la back-end pentru o diagnosticare mai bună:

    • x-ms-client-request-id: un identificator unic pentru cererea primită.
    • x-ms-user-agent: „copilot-vânzări” este folosit ca valoare.

Extend Sales Agent cu aplicații partenere
Construiește extensii pentru agentul de vânzări

  • Last updated on