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 de ações Box Com o conector de ação do Box, você pode acessar os recursos do Box AI, gerenciar arquivos e pastas e organizar o 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, consulte[Métodos de autenticação](quick-action-auth.md). ## Antes de começar Certifique-se de ter 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](https://developer.box.com/guides/authentication/oauth2/oauth2-setup) do Box. + Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md). ## 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. 1. No console do Amazon Quick, escolha **Conectores**. 1. Na guia **Disponível**, localize **Box Agent** e escolha **Connect**. 1. 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 na 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](https://developer.box.com/guides/authentication/oauth2/oauth2-setup) do Box. 1. No console do Amazon Quick, escolha **Conectores**. 1. Escolha a guia **Criar para sua equipe**. 1. 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**. 1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição. 1. Em **Tipo de conexão**, escolha **Rede pública**. 1. Para **Configuração do OAuth**, escolha uma das seguintes opções: 1. Para o **aplicativo OAuth padrão**: Nenhuma credencial adicional é necessária. Escolha **Próximo** para continuar. 1. 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. 1. Escolha **Próximo**. 1. Uma janela de autorização do Box é aberta. Revise as permissões solicitadas e escolha **Conceder acesso ao Box**. 1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**. 1. 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. 1. Selecione **Publish**. ## Ações disponíveis Depois de configurar o conector, as ações a seguir estarão disponíveis. **Ações disponíveis do Box Agent** | 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. | ## Gerenciar e solucionar problemas Para obter instruções sobre como editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations). + 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.