IA do Mavim (versão prévia)
O Conector da API de IA do Mavim permite que agentes de IA e copilots no Power Platform acessem, raciocinam e interajam com sua Plataforma de Transformação de Inteligência do Mavim usando insights de transformação e conhecimento corporativo para fornecer respostas, recomendações e ações com reconhecimento de contexto.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Servicedesk do Mavim |
| URL | https://my.mavim.com |
| servicedesk@mavim.com |
| Metadados do conector | |
|---|---|
| Publisher | Mavim B.V |
| Site | https://www.mavim.com/ |
| Política de privacidade | https://trustcenter.mavim.com/ |
| Categorias | Gestão de empresas; Colaboração |
Conector do Mavim AI Power Platform
Visão geral
O Conector da API de IA do Mavim permite que agentes de IA e copilots no Power Platform acessem, raciocinam e interajam com sua Plataforma de Transformação de Inteligência do Mavim usando insights de transformação e conhecimento corporativo para fornecer respostas, recomendações e ações com reconhecimento de contexto.
Pré-requisitos
Antes de usar esse conector, verifique se os seguintes pré-requisitos são atendidos:
-
Licenciamento:
- Você deve ter comprado uma licença para o produto Mavim Manager com pelo menos uma licença Profissional.
- Você deve ter comprado uma licença para o produto Mavim iMprove com pelo menos uma licença Profissional.
-
Acesso ao banco de dados:
- Você deve ter acesso e as permissões necessárias para um Banco de Dados Mavim.
-
Aplicativos Empresariais:
O conector usa a autenticação OAuth. Você deve instalar pelo menos dois Aplicativos Empresariais por meio da Galeria de Microsoft:
- Mavim Cloud Enterprise Platform
- Conector do Mavim Power Platform
Autenticação
Esse conector usa o OAuth 2.0 para autenticação. Verifique se os Aplicativos Empresariais necessários estão instalados e configurados em seu Azure Entra.
Funcionalidades do conector
- O Conector da API de IA do Mavim permite que agentes de IA e copilots no Power Platform acessem, raciocinam e interajam com sua Plataforma de Transformação de Inteligência do Mavim usando insights de transformação e conhecimento corporativo para fornecer respostas, recomendações e ações com reconhecimento de contexto. Obtenha uma resposta de IA gerativa com base em uma consulta de prompt sobre a Plataforma de Transformação Inteligente do Mavim. Faça perguntas sobre processos, funções, arquitetura de TI, aplicativos, entregas, estratégia e conformidade. Dá suporte a consultas baseadas em campo sobre proprietários de processos, datas de validade e escopo. Formate a resposta com a resposta como prosa, citações como links clicáveis, perguntas de acompanhamento como sugestões e IDs de referência como código.
Operações de chave
- Chat/Conclusões: Gera respostas de IA com reconhecimento de contexto usando dados do repositório Mavim Xformation
Tratamento de erros
O conector retorna códigos de status HTTP padrão para indicar o êxito ou a falha de uma operação. Códigos de erro comuns incluem:
-
400 Bad Request: entrada ou parâmetros inválidos -
401 Unauthorized: falha na autenticação ou ausente -
403 Forbidden: permissões insuficientes -
404 Not Found: recurso não encontrado -
500 Internal Server Error: erro inesperado do servidor
Suporte
Para obter suporte, entre em contato com o Service Desk do Mavim:
- Email: servicedesk@mavim.com
- Site:https://my.mavim.com
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| Chave de licença do Mavim Power Connector | secureString | Chave de licença do Mavim Power Connector | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Gerar respostas de IA com reconhecimento de contexto usando dados do repositório Mavim Xformation |
Sempre formatar respostas como um layout legível avançado: MAIN ANSWER usa prosa estruturada com marcadores de termos de chave negrito e títulos CITATIONS CARD mostram links de markdown clicáveis Fontes de citações e referências FOLLOW UPS CARD mostram sugestões acionáveis REFERENCES CARD mostrar código embutido IDs de referência REGRAS usam links markdown não texto sem formatação omitir seções vazias nunca mostram JSON bruto manter tom profissional conciso acionável |
Gerar respostas de IA com reconhecimento de contexto usando dados do repositório Mavim Xformation
Sempre formatar respostas como um layout legível avançado: MAIN ANSWER usa prosa estruturada com marcadores de termos de chave negrito e títulos CITATIONS CARD mostram links de markdown clicáveis Fontes de citações e referências FOLLOW UPS CARD mostram sugestões acionáveis REFERENCES CARD mostrar código embutido IDs de referência REGRAS usam links markdown não texto sem formatação omitir seções vazias nunca mostram JSON bruto manter tom profissional conciso acionável
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Modelo
|
model | True | string |
Modelo (modelo LLM a ser usado para geração de resposta) |
|
Linguagem de Dados
|
data-language | True | string |
Linguagem de dados (idioma dos dados (padrão: En)) |
|
Stream
|
stream | True | boolean |
Stream (Habilitar resposta de streaming (padrão: false)) |
|
Incluir links markdown
|
includeMarkdownLinks | True | boolean |
Incluir links markdown (incluir links markdown (padrão: false)) |
|
Resposta combinada
|
combinedResponse | True | boolean |
Resposta combinada (incluir citações e acompanhamentos como a propriedade de saída da resposta (padrão: false)) |
|
ID do repositório
|
repositoryId | True | string |
ID do repositório (A ID do banco de dados à qual o tópico pertence) |
|
Mensagem
|
message | True | string |
Mensagem (a mensagem do usuário da Conversa) |
|
ID da Conversa
|
conversationId | string |
ID da conversa (A ID que identifica exclusivamente uma conversa) |
Retornos
- Corpo
- ChatResponse
Definições
ChatResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da Conversa
|
conversationId | string | |
|
Saída
|
output | string | |
|
Acompanhamentos
|
followUps | array of string | |
|
Citações
|
citations | array of Citation | |
|
IDs de referência
|
referenceIds | array of string | |
|
State
|
state | string |
Citação
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tópico
|
topicId | string | |
|
Título
|
title | string | |
|
URL
|
url | string |