Rainbird (versão prévia)
O Rainbird é uma plataforma de automação inteligente sem código que permite automatizar decisões complexas. Esse conector permite que você interaja com mapas de conhecimento que você criou no Rainbird.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do 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: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do 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 do 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 | Rainbird Technologies Ltd |
| URL | https://rainbird.ai/contact-us/ |
| support@rainbird.zohodesk.eu |
| Metadados do conector | |
|---|---|
| Publicador | Rainbird Technologies ltd |
| Site | https://rainbird.ai/ |
| Política de privacidade | https://rainbird.ai/privacy-policy/ |
| Categorias | IA; Business Intelligence |
O Rainbird permite que sua organização automatize a tomada de decisões complexa em escala. Aproveite sua própria experiência em SMEs para codificar sua lógica de tomada de decisão em nosso Studio sem código e, em seguida, conecte-se ao seu fluxo de trabalho para fornecer decisões de alta qualidade, com desempenho e auditáveis que permitem que você crie soluções totalmente automatizadas de ponta a ponta.
Visite o site do Rainbird para obter mais detalhes.
Pré-requisitos
Para usar esse conector, você precisa de acesso a uma conta do Rainbird.
Você pode se inscrever agora para obter acesso a uma conta de comunidade gratuita: Inscrever-se. Para contas premium, entre em contato conosco: entre em contato conosco.
Como obter credenciais
Para usar esse conector, você precisará do seguinte: -API Key (ApiKey) -Knowledge Map ID (KmID)
O ApiKey e o KmID pode ser encontrado no Rainbird Studio.
- Faça logon em sua conta
- Abra seu mapa de conhecimento (ou crie um novo, se necessário)
- Vá para a página 'Publicar'
O ApiKey será necessário para se autenticar com Rainbird. Ao autenticar use seu ApiKey nome de usuário como um nome de usuário, você não precisará de uma senha (insira qualquer caractere se uma senha for necessária).
Visite a documentação do Rainbird para obter mais detalhes.
Introdução ao conector
Em qualquer cenário em que você queira automatizar uma decisão com o Rainbird, você precisará fazer o seguinte:
-Inicie uma sessão no mapa de conhecimento que você deseja usar -Provide dados para sua Sessão (opcional) -Query Rainbird em sua Sessão
Rainbird responderá com uma pergunta se mais informações forem necessárias, que você pode responder usando a Response operação ou se um resultado for fornecido.
Como iniciar uma sessão:
Qualquer decisão começará com uma Start operação para iniciar uma sessão e obter a SessionID.
Start Na operação, forneça a você KmID para gerar um SessionID. Em seguida, você deve usar essa ID com outras operações para interagir com seu Mapa de Conhecimento na mesma sessão.
Como fornecer dados em lote para sua sessão:
Use uma Inject operação antes da consulta para fornecer todos os dados necessários para tomar uma decisão.
Como fazer uma consulta:
Para fazer uma consulta, use a Query operação para fornecer o SessionID, o nome da relação e o assunto/objeto da relação.
Visite a documentação do Rainbird para exibir exemplos dessa solicitação.
Como responder a uma pergunta
Use a Response operação para responder a qualquer pergunta retornada pelo Rainbird. A operação e Response a Query operação retornarão uma pergunta solicitando mais informações ou um resultado. O loop de pergunta/resposta é recursivo até que Rainnbird tenha informações suficientes para fornecer um resultado.
Visite a documentação do Rainbird para obter mais informações sobre o fluxo de solicitação.
Problemas e limitações conhecidos
A configuração atual do conector não permite que os usuários usem a chave de segurança para a operação de evidência. Se um usuário quiser usar a operação de evidência, ele terá que verificar se a segurança da evidência está desativada no Rainbird Studio, na seção Publicar de cada mapa.
Erros e soluções comuns
Usando a variável de ambiente errada:
-Código de erro: esse erro pode gerar várias mensagens de erro, como Session ID not found ou 401: Unauthorized.
-Resolução: todas as operações precisam ser feitas em relação ao ambiente correto (aquele vinculado à sua conta). Verifique se cada etapa corresponde ao seu ambiente.
### Usando a estrutura de dados errada.
-Código de erro: 400: bad request -Resolução: isso pode ser causado por incompatibilidades de dados. Leia os detalhes do erro para obter mais contexto e verifique se os dados usados no fluxo correspondem aos dados do modelo rainbird.
perguntas frequentes
Como saber qual ambiente preciso usar?
Você pode encontrar o ambiente em sua conta do Rainbird. Faça logon em sua conta e vá para a Account página (na parte inferior do menu de navegação esquerdo).
About Na seção, você encontrará as informações relacionadas ao seu ambiente de conta (Enterprise ou Community).
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 | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de api associada à sua conta do Rainbird | Verdade |
| senha opcional | secureString | Nenhuma senha necessária, digite qualquer caractere | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Consulta – Consultar uma sessão em execução |
Faça uma pergunta a um mapa de conhecimento. Essa ação dispara o mecanismo de decisão do Rainbird. Ele executa a decisão automatizada e, em seguida, fornece uma resposta final. Se Rainbird precisar de mais informações para chegar a uma conclusão, ele fará uma pergunta. |
| Desfazer – Desfazer a interação anterior com o mecanismo |
Desfazer uma ação anterior. Essa ação remove a última ação executada. Ele remove a última parte dos dados dados dados ao Rainbird. |
| Evidência - Retorna a evidência para um determinado fato |
Gere uma evidência com base em uma ID de fato. O conhecimento inferido pelo Rainbird sempre vem com dados para explicar o processo de tomada de decisão. Esses dados são disponibilizados por meio dessa ação. Observação: certifique-se de que a chave de evidência está desativada no estúdio rainbird. |
| Iniciar – Iniciar uma nova sessão |
Crie uma nova ID de sessão em um mapa de conhecimento. Esta primeira etapa permitirá que você faça mais ações contra seu modelo rainbird, como injetar fatos ou fazer uma consulta. |
| Injeção – Injetar fatos em uma sessão |
Injete dados em um mapa de conhecimento em uma ID de sessão específica. Isso geralmente é executado antes de uma consulta. É uma maneira de carregar dados em um modelo do Rainbird. |
| Resposta – Responder a uma pergunta feita |
Dê uma resposta para Rainbird. Quando o Rainbird voltar com uma pergunta para uma consulta, ele espera que um usuário ou um sistema insira mais dados. Essa ação fornece uma resposta de volta. |
| Versão – Versão do mecanismo de relatórios |
Retorne a versão atual do mecanismo de inferência do Rainbird. |
Consulta – Consultar uma sessão em execução
Faça uma pergunta a um mapa de conhecimento. Essa ação dispara o mecanismo de decisão do Rainbird. Ele executa a decisão automatizada e, em seguida, fornece uma resposta final. Se Rainbird precisar de mais informações para chegar a uma conclusão, ele fará uma pergunta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A sessão em que consultar |
|
assunto
|
subject | string |
A instância de conceito do lado da entidade (objeto ou assunto necessário) |
|
|
relação
|
relationship | True | string |
A relação para a qual consultar |
|
objeto
|
object | string |
A instância de conceito do lado do objeto (objeto ou assunto necessário) |
Retornos
- response
- object
Desfazer – Desfazer a interação anterior com o mecanismo
Desfazer uma ação anterior. Essa ação remove a última ação executada. Ele remove a última parte dos dados dados dados ao Rainbird.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A ID da sessão a ser recuada com uma desfazer |
Retornos
- response
- object
Evidência - Retorna a evidência para um determinado fato
Gere uma evidência com base em uma ID de fato. O conhecimento inferido pelo Rainbird sempre vem com dados para explicar o processo de tomada de decisão. Esses dados são disponibilizados por meio dessa ação. Observação: certifique-se de que a chave de evidência está desativada no estúdio rainbird.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai).) |
|
ID do fato
|
factID | True | string |
A factID para a qual recuperar evidências |
|
ID da Sessão
|
sessionID | True | string |
A sessionID WITH EVIDENCE SECURITY OFF (consulte as configurações do modelo) em que o fato foi criado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
certeza
|
fact.certainty | Certainty |
Quão certo é esse fato ou resposta |
|
Datatype
|
fact.object.dataType | string | |
|
tipo
|
fact.object.type | string | |
|
value
|
fact.object.value | Object |
A instância ou o valor do conceito do lado do objeto |
|
tipo
|
fact.relationship.type | string | |
|
Datatype
|
fact.subject.dataType | string | |
|
tipo
|
fact.subject.type | string | |
|
value
|
fact.subject.value | string | |
|
factID
|
factID | string | |
|
Condições
|
rule.bindings.conditions | array of object | |
|
certeza
|
rule.bindings.conditions.certainty | Certainty |
Quão certo é esse fato ou resposta |
|
factID
|
rule.bindings.conditions.factID | factID |
ID usada para buscar as evidências que levam a essa decisão |
|
objeto
|
rule.bindings.conditions.object | Object |
A instância ou o valor do conceito do lado do objeto |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
relação
|
rule.bindings.conditions.relationship | Relationship |
A relação que vincula Entidade e Objeto |
|
Salience
|
rule.bindings.conditions.salience | number | |
|
assunto
|
rule.bindings.conditions.subject | Subject |
A instância ou o valor do conceito do lado da entidade |
|
fonte
|
source | string | |
|
time
|
time | number |
Iniciar – Iniciar uma nova sessão
Crie uma nova ID de sessão em um mapa de conhecimento. Esta primeira etapa permitirá que você faça mais ações contra seu modelo rainbird, como injetar fatos ou fazer uma consulta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente de conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai). |
|
ID do Mapa do Conhecimento (kmId)
|
kmID | True | string |
A ID do mapa de conhecimento para iniciar uma sessão em relação a |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
ID da sessão recém-criada |
|
id
|
kmVersion.id | string |
ID da versão que está sendo consultada, que será diferente da ID do mapa de conhecimento ao consultar versões dinâmicas de um mapa de conhecimento |
Injeção – Injetar fatos em uma sessão
Injete dados em um mapa de conhecimento em uma ID de sessão específica. Isso geralmente é executado antes de uma consulta. É uma maneira de carregar dados em um modelo do Rainbird.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A sessão na qual injetar fatos |
|
assunto
|
subject | True |
A instância ou o valor do conceito do lado da entidade |
|
|
relação
|
relationship | True |
A relação que vincula Entidade e Objeto |
|
|
objeto
|
object | True |
A instância ou o valor do conceito do lado do objeto |
|
|
certeza
|
certainty | True | number |
Quão certo é esse fato ou resposta |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | string |
Resposta – Responder a uma pergunta feita
Dê uma resposta para Rainbird. Quando o Rainbird voltar com uma pergunta para uma consulta, ele espera que um usuário ou um sistema insira mais dados. Essa ação fornece uma resposta de volta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai).) |
|
ID da Sessão
|
sessionID | True | string |
A sessão para a qual enviar respostas |
|
assunto
|
subject | True |
A instância ou o valor do conceito do lado da entidade |
|
|
relação
|
relationship | True |
A relação que vincula Entidade e Objeto |
|
|
objeto
|
object | True |
A instância ou o valor do conceito do lado do objeto |
|
|
certeza
|
certainty | True | number |
Quão certo é esse fato ou resposta |
Retornos
- response
- object
Versão – Versão do mecanismo de relatórios
Retorne a versão atual do mecanismo de inferência do Rainbird.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ambiente
|
environment | True | string |
Ambiente da conta: Comunidade (api.rainbird.ai) ou Enterprise (enterprise-api.rainbird.ai).) |
Retornos
- response
- string
Definições
Certeza
Assunto
A instância ou o valor do conceito do lado da entidade
A instância ou o valor do conceito do lado da entidade
Relationship
Object
A instância ou o valor do conceito do lado do objeto
A instância ou o valor do conceito do lado do objeto
factID
ID usada para buscar as evidências que levam a essa decisão
ID usada para buscar as evidências que levam a essa decisão
objeto
Esse é o tipo 'object'.
cadeia
Esse é o tipo de dados básico 'string'.