Conectando-se a integrações em aplicativos no Quick

Você pode conectar seus aplicativos nos aplicativos Quick a serviços externos e fontes de dados por meio da estrutura de integração no Amazon Quick. O mesmo modelo de integração usado em outros lugares no Quick se aplica aos aplicativos no Quick. O agente registra as integrações em seu aplicativo e você e seus usuários as autorizam. Para obter mais informações sobre integrações, consulte Trabalhe com integrações no Amazon Quick.

Pré-requisitos

Antes de conectar as integrações, confirme o seguinte:

• Você tem uma conta Amazon Quick ativa com acesso ao Author Pro ou superior.

• Seu administrador habilitou os conectores que você planeja usar.

Tipos de integração

O Quick organiza as integrações em duas categorias:

• Integrações de conhecimento — Conecte-se a fontes de dados que o sistema pode pesquisar e analisar. Em aplicativos no Quick, geralmente é um espaço Amazon Quick usado como base de conhecimento para uma experiência de bate-papo incorporada.

• Integrações de ações — Conecte-se a aplicativos e serviços externos nos quais seu aplicativo pode ler dados, gravar dados ou realizar operações. Os exemplos incluem Microsoft Outlook, SharePoint, OneDrive, Slack, Jira e Asana. O Quick fornece mais de 100 conectores de ação pré-construídos. Você também pode criar conectores personalizados usando as especificações REST API, OpenAPI ou MCP.

Modelos de autenticação

As integrações de ações oferecem suporte a dois modelos de autenticação:

• Autenticação do usuário — A integração usa as credenciais do usuário final individual. Cada usuário deve ter seu próprio acesso ao recurso conectado.

• Autenticação de serviço — A integração usa uma credencial de nível de serviço configurada por um administrador. Todos os usuários do aplicativo compartilham esse acesso. Nem todos os conectores oferecem suporte à autenticação de serviços.

Adicionar uma integração ao seu aplicativo

Você não precisa configurar as integrações manualmente. Para adicionar uma integração:

1. Peça ao agente que use um serviço específico em suas instruções. Por exemplo: “Conecte-se ao meu calendário do Outlook e exiba minhas reuniões desta semana”.

2. Autorize a integração quando o agente solicitar.

3. Verifique se a integração aparece na visualização Ativos.

Quando outros usuários abrem o aplicativo publicado, eles autorizam suas próprias credenciais para cada integração registrada no primeiro uso.

Como os aplicativos no Quick funcionam com outros recursos do Quick

O Apps in Quick se conecta a vários outros recursos do Amazon Quick:

• Amazon Quick Spaces — Um aplicativo pode ler arquivos de um espaço, gravar novos arquivos nele e usar um espaço como base de conhecimento para uma experiência de bate-papo incorporada. Para obter mais informações, consulte Organize, colabore e compartilhe recursos com espaços no Amazon Quick.

• Amazon Quick Flows — Não há integração direta entre aplicativos em Quick e Quick Flows. Em vez disso, use um espaço como uma camada de dados compartilhada. Um fluxo processa dados e salva sua saída em um espaço. O aplicativo lê a partir desse espaço e exibe os resultados. Para obter mais informações, consulte Usando as automações do Amazon Quick.

Dicas de integração

• Outlook e OneDrive — Esses conectores não resolvem de forma confiável o me alias nas chamadas de API. Em vez disso, instrua o agente a usar a API de identidade do usuário para recuperar as informações do usuário atual.

• Slack — O esquema da API do conector do Slack não inclui todas as operações disponíveis da API do Slack. Forneça detalhes específicos sobre as operações da API Slack de que você precisa, como o ID do canal e o formato da mensagem.

• Remoção da integração — No momento, você não pode remover uma integração registrada de um aplicativo por meio da interface de configurações. Como solução alternativa, peça ao agente que remova as referências à integração no código do aplicativo.