Conector de mostra (versión preliminar)

Importante

  • Esta é unha funcionalidade en versión preliminar lista para produción.
  • As vistas previas listas para a produción están suxeitas a termos de uso adicionais.

[Este artigo é a documentación de prelanzamento e está suxeito a cambios.]

Podes usar a acción do conector certificado baseada en Contoso Hub - Connectors para comprobar os puntos de extensibilidade dispoñibles en Sales.

Para probar a acción do conector certificado, segue as instrucións en Xestionar extensións para o axente de vendas e activa a acción do conector Contoso Hub para o axente de vendas.

Podes editar o conector de mostra e a acción para comezar rapidamente. Consulte as seguintes pautas cando edite a creación do conector ou as súas accións:

  • O conector de mostra contén marcadores de posición para as rutas da API. Podes substituír estes marcadores de posición polas rutas da API reais.

  • Os métodos HTTP deben coincidir cos que se especifican na definición de mostra OpenAPI .

  • A OpenAPI definición que devolve o conector utilízase para mapear os parámetros de entrada e saída en función das descricións. Todos os parámetros necesarios na definición de mostra OpenAPI deben estar presentes na definición do conector real e deben ter descricións correctas.

  • Os tipos de parámetros de entrada deben coincidir cos que se especifican na OpenAPI definición.

  • As API descritas na OpenAPI definición non deben conter ningún parámetro obrigatorio que non estea presente na OpenAPI definición de mostra. Se non, o axente de vendas non invoca as APIs e falla cun erro interno.

  • Non use connectorId como parámetro de entrada na OpenAPI definición, porque é un parámetro reservado.

  • As propiedades dos obxectos de saída que se marcan como requiridos na OpenAPI definición deben estar presentes na API resposta.

  • Cada API do conector debe completar a súa execución en cinco segundos, especialmente as accións do conector que melloran as capacidades existentes.

  • Espérase que a autenticación sexa xestionada polas construcións do conector Microsoft Power Platform e está fóra do ámbito de cada API.

  • O idioma do usuario actual pásase na cabeceira da solicitude como Accept-Language. Utilízao para calquera operación específica do idioma.

  • Le as seguintes cabeceiras da solicitude ao teu conector e envíaos ao teu back-end para obter mellores diagnósticos:

    • x-ms-client-request-id: un identificador único para a solicitude entrante.
    • x-ms-user-agent: úsase "sales-copilot" como valor.

Extensión do axente de vendas con aplicacións de socios
Compilar extensións para axente de vendas

  • Last updated on