As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Integração com Box Agent
Com o conector Box Agent, você pode acessar os recursos do Box AI, gerenciar arquivos e pastas e organizar conteúdo em hubs diretamente no Amazon Quick por meio de linguagem natural.
O Amazon Quick oferece suporte aos seguintes métodos de autenticação para o Box Agent.
-
Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Você se autentica diretamente com sua conta Box.
-
Aplicativo OAuth personalizado — usa um aplicativo OAuth 2.0 gerenciado pelo cliente registrado no Box Developer Console. Essa opção dá à sua organização controle total sobre a configuração do OAuth.
Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.
Antes de começar
Verifique se você tem o seguinte antes de configurar a integração.
-
Uma conta Box com acesso a arquivos e pastas.
-
Para aplicativo OAuth personalizado: acesso ao Box Developer Console para criar um aplicativo personalizado. Para obter mais informações, consulte Configuração do OAuth 2.0 na documentação
do Box. -
Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.
Configurando o conector no Amazon Quick
Conecte-se a partir da guia Disponível
Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, localize Box Agent e escolha Connect.
-
Conclua o fluxo de login do Box e conceda as permissões solicitadas.
Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia Criar para sua equipe, conforme descrito abaixo.
Crie a partir da guia Criar para sua equipe
Se você usa a autenticação personalizada do aplicativo OAuth, crie um aplicativo personalizado no Box Developer Console antes de configurar o Amazon Quick. Para obter instruções de configuração, consulte Configuração do OAuth 2.0 na documentação
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha Box Agent.
nota
Se um conector do Box Agent já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha uma das seguintes opções:
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
Para o aplicativo OAuth personalizado, configure os seguintes campos:
-
URL base (opcional) — A URL base da API Box. Exemplo:
https://mcp.box.com -
ID do cliente — O ID do cliente do seu aplicativo Box.
-
Segredo do cliente — O segredo do cliente do seu aplicativo Box.
-
-
-
Escolha Próximo.
-
Uma janela de autorização do Box é aberta. Revise as permissões solicitadas e escolha Conceder acesso ao Box.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
| Categoria | Ação | Description |
|---|---|---|
| AI | Perguntas e respostas sobre IA (Hub) | Faça uma pergunta a um Box Hub usando o Box AI. |
| AI | Perguntas e respostas sobre IA (arquivo único) | Faça uma pergunta em um único arquivo usando o Box AI. |
| AI | Perguntas e respostas sobre IA (vários arquivos) | Faça uma pergunta para vários arquivos usando o Box AI. |
| AI | Extrato de IA (forma livre) | Extraia metadados de arquivos usando o Box AI em formato livre. |
| AI | Extrato de IA (estruturado) | Extraia metadados estruturados de arquivos usando o Box AI com base em campos personalizados ou em um modelo de metadados. |
| Arquivos | Obter conteúdo do arquivo | Extraia e retorne o conteúdo do arquivo em formato de texto para arquivos com menos de 50 MB. |
| Arquivos | Obter detalhes do arquivo | Obtenha informações abrangentes sobre arquivos, incluindo metadados, permissões e detalhes da versão. |
| Arquivos | Atualizar propriedades do arquivo | Atualize os metadados do arquivo, incluindo nome, descrição, tags e coleções. |
| Arquivos | Carregar arquivo | Faça upload de um novo arquivo para o Box. |
| Arquivos | Carregar versão do arquivo | Faça upload de uma nova versão de um arquivo existente. |
| Arquivos | Pesquisar arquivos | Pesquise arquivos usando palavras-chave com suporte para filtros de metadados e filtragem de extensão de arquivo. |
| Pastas | Criar pasta | Crie uma nova pasta no Box. |
| Pastas | Obter detalhes da pasta | Recupere informações abrangentes da pasta, incluindo metadados e configurações de colaboração. |
| Pastas | Listar conteúdo da pasta | Listar arquivos, pastas e links da web em uma pasta. |
| Pastas | Atualizar propriedades da pasta | Atualize os metadados da pasta, incluindo nome, descrição, tags e coleções. |
| Pastas | Pastas de pesquisa | Pesquise pastas por nome usando a correspondência de palavras-chave. |
| Hubs | Criar hub | Crie um novo hub para organizar o conteúdo. |
| Hubs | Obtenha detalhes do hub | Recupere informações sobre um hub específico. |
| Hubs | Obtenha itens do Hub | Recupere itens em um hub, incluindo arquivos, pastas e links da web. |
| Hubs | Listar hubs | Listar todos os hubs acessíveis ao usuário atual. |
| Hubs | Hub de atualização | Atualize o título ou a descrição de um hub. |
| Hubs | Adicionar itens ao Hub | Adicione arquivos, pastas ou links da web a um hub. |
| Comentários e tarefas | Criar comentário de arquivo | Crie um novo comentário em um arquivo. |
| Comentários e tarefas | Listar comentários do arquivo | Listar todos os comentários em um arquivo. |
| Comentários e tarefas | Listar tarefas | Listar todas as tarefas associadas a um arquivo. |
| Usuários | Quem sou eu | Retorna informações sobre o usuário atualmente autenticado. |
Gerenciamento e solução de problemas
Para obter instruções sobre como editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.
-
O pop-up de autenticação falha — Verifique se seu navegador permite pop-ups do domínio do console Amazon Quick.
-
Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores em seu aplicativo Box Developer Console.
-
Permissões insuficientes — Verifique se sua conta do Box tem acesso aos arquivos, pastas ou hubs que você está tentando acessar.
