Partilhar via


Lógica AtBot

O AtBot é um serviço de criação de bots sem código que permite criar interfaces de usuário conversacionais rapidamente sem qualquer experiência de programação.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte AtBot
URL https://admin.atbot.io/Docs
Email support@atbot.io
Metadados do conector
Editora H3 Soluções Inc.
Sítio Web https://www.atbot.io
Política de privacidade https://admin.atbot.io/privacy
Categorias IA; Produtividade

O conector AtBot Logic é usado para criar habilidades de bot para bots criados no serviço AtBot. Usando as ações no conector, você pode criar habilidades de conversação complexas para seus bots e conectá-los a outros serviços usando conectores adicionais. O AtBot é gratuito para experimentar no Microsoft Teams, com uma versão premium disponível para criar bots personalizados em plataformas adicionais. Visite o site do AtBot para obter mais informações.

Pré-requisitos

Para usar a versão gratuita do AtBot, você deve ter uma conta do Microsoft Teams e ter baixado o bot do AtBot da loja de aplicativos.

Para usar a versão premium onde você pode construir seus próprios bots personalizados, você deve se inscrever no AtBot Premium. Quando você se inscrever no Premium, você receberá um crédito de US $ 25 para experimentar o serviço.

Como obter credenciais

Você sempre fará login no conector AtBot usando uma conta corporativa ou escolar do Microsoft Entra ID.

Problemas conhecidos e limitações

Nós depricamos o suporte LUIS no gatilho de palavra-chave. Por favor, use LUIS Intent Vectors para criar habilidades que reconheçam a linguagem natural.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Atualizar um cartão adaptável enviado para um separador

Esta operação é usada para atualizar um cartão enviado para uma guia.

Enviar evento

Essa operação é usada para enviar um evento para o cliente de bot.

Enviar resposta

Esta operação é usada para enviar uma resposta para a atividade que disparou o fluxo.

Enviar resposta do Adaptive Card

Esta operação é usada para enviar uma resposta de cartão adaptável para a atividade que disparou o fluxo.

Enviar resposta do Conjunto de Cartões Adaptável

Esta operação é usada para enviar uma resposta de conjunto de cartões adaptável para a atividade que disparou o fluxo. O conjunto pode ser na forma de Lista ou Carrossel.

Excluir da memória do bot

Essa operação é usada para remover uma informação da memória no bot.

Gerar cartão adaptável

Esta operação é usada para gerar um cartão adaptável para ser usado posteriormente para exibir uma lista ou carrossel de cartões.

Iniciar uma nova conversa em grupo

Esta operação é usada para iniciar uma nova conversa em grupo em um canal.

Iniciar uma nova conversa privada

Esta operação é usada para iniciar uma nova conversa privada com um usuário.

Obter itens de memória de bot por tipo

Obtenha todos os itens de memória do Bot por tipo.

Obter resposta da lista de opções do usuário

Esta operação é usada para pedir ao usuário a entrada da lista de opções.

Obter resposta datetime do usuário

Esta operação é usada para pedir ao usuário a entrada datetime.

Obter resposta de cartão adaptável do usuário

Esta operação é usada para pedir ao usuário a entrada via cartão adaptável.

Obter resposta de escolha do usuário

Esta operação é usada para pedir ao usuário a entrada de escolha.

Obter resposta de memória do usuário

Esta operação é usada para pedir ao usuário a entrada de memória do bot.

Obter resposta de User

Esta operação é usada para pedir a entrada do usuário.

Obter resposta do usuário

Esta operação é usada para pedir ao usuário a entrada do seletor de pessoas.

Obter resposta vetorial de intenção do usuário

Esta operação é usada para solicitar ao usuário a entrada de PNL.

Registrar ponte de bate-papo entre duas ou mais conversas

Esta operação é usada para iniciar uma ponte de bate-papo entre dois ou mais usuários.

Salvar na memória do bot

Essa operação é usada para salvar uma informação na memória no bot.

Atualizar um cartão adaptável enviado para um separador

Esta operação é usada para atualizar um cartão enviado para uma guia.

Parâmetros

Name Chave Necessário Tipo Description
Cartão adaptável
card True object

Forneça o cartão para usar como atualização.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Devoluções

Enviar evento

Essa operação é usada para enviar um evento para o cliente de bot.

Parâmetros

Name Chave Necessário Tipo Description
Atividade de resposta
activityJson True string

Atividade de resposta do bot

JSON de evento
eventObject True object

O objeto JSON a ser enviado no evento de chat.

Enviar resposta

Esta operação é usada para enviar uma resposta para a atividade que disparou o fluxo.

Parâmetros

Name Chave Necessário Tipo Description
Texto de resposta
message True string

A mensagem para responder ao usuário com.

Atividade de resposta
activityJson True string

Atividade de resposta do bot

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Dados de canal personalizados
customChannelDataJson string

Json de dados de canal personalizado para a mensagem (suportado apenas em Linha Direta)

JSON de resposta de sinal
signalResponse string

String JSON de resposta de sinal

ID da mensagem
messageId string

(Opcional) ID de uma mensagem anterior na mesma conversa para substituir. Se fornecido, o bot substituirá uma mensagem de bate-papo existente por essa mensagem.

Devoluções

Enviar resposta do Adaptive Card

Esta operação é usada para enviar uma resposta de cartão adaptável para a atividade que disparou o fluxo.

Parâmetros

Name Chave Necessário Tipo Description
Cartão adaptável selecionado
selectedCard True string

Selecione o cartão adaptável.

conteúdo
content True dynamic

Devoluções

Enviar resposta do Conjunto de Cartões Adaptável

Esta operação é usada para enviar uma resposta de conjunto de cartões adaptável para a atividade que disparou o fluxo. O conjunto pode ser na forma de Lista ou Carrossel.

Parâmetros

Name Chave Necessário Tipo Description
Conjunto de cartões adaptável
cards True object

Forneça o objeto do conjunto de cartões.

Estilo de exibição
displayStyle True string

Selecione o estilo de exibição a ser usado.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Mostrar no separador
showInTab boolean

Exiba este conjunto de cartões em uma guia em vez do bate-papo embutido.

Rótulo do botão Tab
deepLinkButtonLabel string

Rótulo do botão para exibição em uma guia.

Mensagem do botão Tab
deepLinkMessage string

Mensagem para enviar com o botão ao exibir em uma guia.

Devoluções

Excluir da memória do bot

Essa operação é usada para remover uma informação da memória no bot.

Parâmetros

Name Chave Necessário Tipo Description
Nome Principal do Utilizador
user True string

O usuário para salvar o item de memória contra.

Tipo de memória
type True string

O tipo de memória.

Valor
value True string

O valor do item de memória.

Devoluções

Gerar cartão adaptável

Esta operação é usada para gerar um cartão adaptável para ser usado posteriormente para exibir uma lista ou carrossel de cartões.

Parâmetros

Name Chave Necessário Tipo Description
Cartão adaptável selecionado
selectedCard True string

Selecione o cartão adaptável.

conteúdo
content dynamic

Devoluções

response
object

Iniciar uma nova conversa em grupo

Esta operação é usada para iniciar uma nova conversa em grupo em um canal.

Parâmetros

Name Chave Necessário Tipo Description
Bot de destino
EnterpriseBot True string

Selecione o bot.

Listagem de canais
teamIDStr True object

A saída de listagem do canal.

Nome do canal
channelId True string

O canal para postar a conversa. Digite o nome.

Texto da conversa
message True string

A mensagem para iniciar a conversa.

Devoluções

Iniciar uma nova conversa privada

Esta operação é usada para iniciar uma nova conversa privada com um usuário.

Parâmetros

Name Chave Necessário Tipo Description
Bot de destino
EnterpriseBot True string

Selecione o bot.

Texto da conversa
message True string

A mensagem para iniciar a conversa.

User
user True string

Nome principal do usuário (UPN).

Devoluções

Obter itens de memória de bot por tipo

Obtenha todos os itens de memória do Bot por tipo.

Parâmetros

Name Chave Necessário Tipo Description
Nome Principal do Usuário.
user True string

Forneça o Nome Principal do Usuário.

Tipo de memória
type True string

Forneça o tipo de memória a ser listado.

Devoluções

Obter resposta da lista de opções do usuário

Esta operação é usada para pedir ao usuário a entrada da lista de opções.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
URL do ícone
icon string

Insira um url absoluto para um ícone a ser exibido para cada item de escolha.

Message
message True string

Digite a mensagem a ser enviada ao usuário.

Valores de escolha
choices True object

Forneça o objeto de matriz de escolha.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação antes de fornecer uma resposta.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Ouvir a resposta por voz
listenForInput boolean

Se esta for uma chamada do Teams, essa propriedade determinará se o bot escuta uma resposta de voz. Se não, ou não, uma chamada do Teams não ouvirá imediatamente uma resposta de voz.

Devoluções

Obter resposta datetime do usuário

Esta operação é usada para pedir ao usuário a entrada datetime.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Âmbito da data
dateScope True string

Selecione o escopo do valor da data.

Message
message True string

Digite a mensagem a ser enviada ao usuário.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação antes de fornecer uma resposta.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Devoluções

Obter resposta de cartão adaptável do usuário

Esta operação é usada para pedir ao usuário a entrada via cartão adaptável.

Parâmetros

Name Chave Necessário Tipo Description
Cartão adaptável selecionado
selectedCard True string

Selecione o cartão adaptável.

WebHook
webHook dynamic

Devoluções

As saídas desta operação são dinâmicas.

Obter resposta de escolha do usuário

Esta operação é usada para pedir ao usuário a entrada de escolha.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Message
message True string

Digite a mensagem a ser enviada ao usuário.

Valores de escolha
choices True string

Forneça cada opção em uma linha separada.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação antes de fornecer uma resposta.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Ouvir a resposta por voz
listenForInput boolean

Se esta for uma chamada do Teams, essa propriedade determinará se o bot escuta uma resposta de voz. Se não, ou não, uma chamada do Teams não ouvirá imediatamente uma resposta de voz.

Devoluções

Obter resposta de memória do usuário

Esta operação é usada para pedir ao usuário a entrada de memória do bot.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Message
message True string

Digite a mensagem a ser enviada ao usuário.

Tipo de memória
type True string

Forneça o tipo de memória a ser listado.

Atividade de resposta
activityJson True string

Responder atividade do bot.

URL do ícone
icon string

Insira um url absoluto para um ícone a ser exibido para cada item de escolha.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Utilizador Alvo
targetUserMemory string

Opcionalmente, especifique o UPN do usuário do qual o bot deve extrair itens de memória. Se deixado em branco, ele puxará itens de memória do usuário que iniciou a habilidade. No caso de uma conversa em grupo iniciada a partir do bot, ele extrairá itens de memória do usuário autenticado no Flow.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação antes de fornecer uma resposta.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Devoluções

Obter resposta de User

Esta operação é usada para pedir a entrada do usuário.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Message
message True string

Digite a mensagem a ser enviada ao usuário.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Devoluções

Obter resposta do usuário

Esta operação é usada para pedir ao usuário a entrada do seletor de pessoas.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Message
message True string

Digite a mensagem a ser enviada ao usuário.

Mode
mode True string

Peça ao usuário para selecionar uma ou várias pessoas.

Cadeia (de carateres) de pesquisa
searchstr string

Opcionalmente, forneça uma cadeia de caracteres de pesquisa inicial.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação antes de fornecer uma resposta.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Ouvir a resposta por voz
listenForInput boolean

Se esta for uma chamada do Teams, essa propriedade determinará se o bot escuta uma resposta de voz. Se não, ou não, uma chamada do Teams não ouvirá imediatamente uma resposta de voz.

Devoluções

Obter resposta vetorial de intenção do usuário

Esta operação é usada para solicitar ao usuário a entrada de PNL.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Message
message True string

Digite a mensagem a ser enviada ao usuário.

Vetor de intenção LUIS
intentVector True string

Escolha o seu vetor de intenção LUIS.

Atividade de resposta
activityJson True string

Responder atividade do bot.

Aceitar resposta de
acceptResponseFrom string

Aceitar resposta de usuário específico ou de qualquer usuário.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação antes de fornecer uma resposta.

Mostrar no chat
showInChat boolean

Se esta for uma chamada do Teams, mostre essa mensagem no bate-papo. Caso contrário, o bot só falará a mensagem.

Devoluções

As saídas desta operação são dinâmicas.

Registrar ponte de bate-papo entre duas ou mais conversas

Esta operação é usada para iniciar uma ponte de bate-papo entre dois ou mais usuários.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Nome de Utilizador
chatUserName True string

Nome de exibição do usuário do bate-papo.

Mensagem de iniciação
chatInitiationMessage string

Mensagem a ser enviada a este usuário quando a ponte de chat for estabelecida.

Atividade de resposta
activityJson True string

A atividade de resposta para o usuário do chat.

Comando Terminar Chat
endBridgeCommand True string

O comando de palavra-chave a ser enviado ao bot para encerrar a ponte de chat.

Tempo Limite de Inatividade
idleTimeoutDuration True integer

A duração (em minutos) da atividade ociosa para acionar um tempo limite.

Devoluções

Salvar na memória do bot

Essa operação é usada para salvar uma informação na memória no bot.

Parâmetros

Name Chave Necessário Tipo Description
Nome Principal do Utilizador
user True string

O usuário para salvar o item de memória contra.

Tipo de memória
type True string

O tipo de memória.

Title
title True string

O título do item de memória.

Valor
value True string

O valor do item de memória.

Devoluções

Acionadores

Quando um vetor de intenção é reconhecido

Esta operação é acionada quando o vetor de intenção LUIS dado é reconhecido pelo bot.

Quando uma palavra-chave é usada

Esta operação é acionada quando a(s) palavra(s)-chave fornecida(s) são usadas pelo bot. Forneça várias palavras-chave em formato delimitado por ponto-e-vírgula.

Quando um vetor de intenção é reconhecido

Esta operação é acionada quando o vetor de intenção LUIS dado é reconhecido pelo bot.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Descrição do gatilho
triggerDescription True string

Descrição mostrada na caixa de diálogo de ajuda do bot.

Tipo de gatilho de bot
triggerType True string

Selecione o tipo de gatilho.

Vetor de intenção LUIS
intentVector string

Escolha o seu vetor de intenção LUIS.

Permitir ramificação
allowBranching string

Permita que o usuário acione habilidades de ramificação enquanto responde a perguntas de acompanhamento.

Devoluções

As saídas desta operação são dinâmicas.

Quando uma palavra-chave é usada

Esta operação é acionada quando a(s) palavra(s)-chave fornecida(s) são usadas pelo bot. Forneça várias palavras-chave em formato delimitado por ponto-e-vírgula.

Parâmetros

Name Chave Necessário Tipo Description
filters
filters array of string
headers
headers object
propriedades
properties object
Descrição do gatilho
triggerDescription True string

Descrição mostrada na caixa de diálogo de ajuda do bot

Tipo de gatilho de bot
triggerType True string

Selecione o tipo de gatilho.

Palavras-chave
keywords string

Insira palavras-chave personalizadas que acionarão o Flow.

(Preterido) Chave da API LUIS
luisApiKey string

(Preterido) Forneça ao AtBot a sua chave API LUIS. Este parâmetro foi preterido. Por favor, use o gatilho Intent Vetor para uso do LUIS no futuro.

(Preterido) Aplicação LUIS
luisAppId string

(Preterido) Escolha o seu aplicativo LUIS. Este parâmetro foi preterido. Por favor, use o gatilho Intent Vetor para uso do LUIS no futuro.

(Preterido) Intenção LUIS
luisIntent string

(Preterido) Escolha a intenção de uso do LUIS. Este parâmetro foi preterido. Por favor, use o gatilho Intent Vetor para uso do LUIS no futuro.

Devoluções

As saídas desta operação são dinâmicas.

Definições

BotReplyResponse

Name Caminho Tipo Description
ID da mensagem
id string

ID da mensagem criada a partir da resposta. Usado para atualizar a mensagem.

Resposta Bot

Name Caminho Tipo Description
Texto de resposta
text string

A resposta que o usuário digitou.

Aviso de Cancelamento
cancelNotice boolean

Este sinalizador será True se o usuário responder com uma palavra-chave de cancelamento.

Usuário Respondente
respondingUser string

O usuário respondendo ao bot.

files
files array of object
Nome do arquivo
files.name string

O nome do arquivo.

Tipo de Arquivo:
files.content-type string

O tipo de arquivo.

Bytes de arquivo
files.bytes byte

Os bytes do arquivo.

BotResponse_Date

Name Caminho Tipo Description
Data de resposta
text date-time

A data/hora da resposta que o usuário inseriu.

Data de resposta UTC
text_UTC date-time

A data/hora da resposta que o utilizador introduziu, em formato UTC.

Aviso de Cancelamento
cancelNotice boolean

Este sinalizador será True se o usuário responder com uma palavra-chave de cancelamento.

Usuário Respondente
respondingUser string

O usuário respondendo ao bot.

BotResponse_Choice

Name Caminho Tipo Description
Escolha de resposta
text string

A opção de resposta que o usuário inseriu.

Aviso de Cancelamento
cancelNotice boolean

Este sinalizador será True se o usuário responder com uma palavra-chave de cancelamento.

Usuário Respondente
respondingUser string

O usuário respondendo ao bot.

BotResponse_ChoiceList

Name Caminho Tipo Description
Título da lista de opções selecionadas
title string

O título da lista de opções selecionadas.

Legenda da Lista de Opções Selecionadas
subtitle string

A legenda da lista de opções selecionada.

Valor da lista de opções selecionadas
value string

O valor da lista de opções selecionada.

Aviso de Cancelamento
cancelNotice boolean

Este sinalizador será True se o usuário responder com uma palavra-chave de cancelamento.

Usuário Respondente
respondingUser string

O usuário respondendo ao bot.

BotResponse_People

Name Caminho Tipo Description
Pessoas
people array of object
Nome Principal do Utilizador
people.upn string

O nome principal do usuário.

ID do Utilizador
people.userid string

O ID do usuário.

Nome Completo
people.fullname string

O nome completo do usuário.

Email
people.email string

O e-mail do usuário.

Aviso de Cancelamento
cancelNotice boolean

Este sinalizador será True se o usuário responder com uma palavra-chave de cancelamento.

Usuário Respondente
respondingUser string

O usuário respondendo ao bot.

BotResponse_Memory

Name Caminho Tipo Description
Título do item de memória
title string

O título do item de memória.

Valor do item de memória
value string

O valor do item de memória.

Aviso de Cancelamento
cancelNotice boolean

Este sinalizador será True se o usuário responder com uma palavra-chave de cancelamento.

Usuário Respondente
respondingUser string

O usuário respondendo ao bot.

Response_SaveBotMemory

Name Caminho Tipo Description
Resultado de salvamento de memória de bot
text string

O resultado do salvamento na memória do bot.

Response_DeleteBotMemory

Name Caminho Tipo Description
Resultado da exclusão de memória do bot
text string

O resultado da exclusão da memória do bot.

BotGroupConversationStartResponse

Name Caminho Tipo Description
ID da Conversação
id string

Id da conversa criada a partir da conversa do grupo inicial. Usado para atualizar a conversa.

ID da mensagem
messageId string

ID da mensagem criada a partir da conversa de grupo inicial. Usado para atualizar a mensagem.

Atividade de resposta
activityJson string

Atividade Json.

BotConversationStartResponse

Name Caminho Tipo Description
ID da mensagem
id string

ID da mensagem criada a partir da resposta. Usado para atualizar a mensagem.

Atividade de resposta
activityJson string

Atividade Json.

BridgeOutcome

Name Caminho Tipo Description
Outcome
outcome string

O resultado da ponte.

Ponte fechada por
bridgeClosedBy string

O usuário que fechou a ponte.

MemoryItem

Name Caminho Tipo Description
Título do item de memória
title string

O título do item de memória.

Valor do item de memória
value string

O valor do item de memória.

objecto

Este é o tipo 'objeto'.