Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Você pode enviar agentes criados com o Construtor de Agentes no Microsoft 365 Copilot para o catálogo da sua organização para uso mais amplo. Quando você envia seu agente, um administrador o revisa no Centro de administração do Microsoft 365 e, após aprovar, o publica no Repositório de agentes em Criado pela sua organização. A partir daí, o agente fica disponível como uma solução confiável e aprovada pela organização para usuários em todo o seu locatário.
Este artigo descreve como enviar um agente, acompanhar seu status de aprovação e gerenciar sua listagem da Agent Store após a aprovação. Para obter detalhes sobre as ações do administrador, consulte Publicar agentes no Centro de administração do Microsoft 365.
Compartilhamento e o Agent Store
Os agentes criados com o Agent Builder podem alcançar outros usuários por meio de dois caminhos separados:
- Compartilhe seu agente com pessoas ou grupos específicos. Você gerencia o agente compartilhado, incluindo suas configurações de compartilhamento e atualizações. As alterações publicadas ficam visíveis para os usuários compartilhados imediatamente.
- Envie seu agente para o catálogo da sua organização. Um administrador revisa e publica o agente no Agent Store. O administrador gerencia a listagem da Agent Store, incluindo a disponibilidade. As alterações se aplicam à listagem da Agent Store somente depois que um administrador aprova um novo envio.
A versão compartilhada e a versão do Repositório de Agentes são rastreadas como duas entradas separadas. Você pode continuar iterando em seu agente compartilhado a qualquer momento, incluindo alterar com quem ele é compartilhado ou mantê-lo privado para testes, sem afetar a versão do Agent Store. Quando estiver pronto para lançar uma atualização significativa no Agent Store, reenvie o agente para revisão do administrador.
A tabela a seguir destaca as principais diferenças entre os dois caminhos.
| Compartilhamento | Enviar para o catálogo da sua organização | |
|---|---|---|
| Gerenciado por | O criador | O criador é o autor do agente; um administrador gerencia a listagem da Agent Store. |
| Espectadores | Usuários, grupos ou equipes nomeados | Qualquer pessoa em sua organização, com base nas configurações de disponibilidade do administrador. |
| Análise | Nenhum | Revisão do Administração no Centro de administração do Microsoft 365. |
| Distribuição | Link compartilhável | Agent Store, em Criado por sua organização. |
| Ciclo de atualização | As alterações se aplicam imediatamente ao publicar | As alterações se aplicam somente após a aprovação do administrador de um novo envio. |
| Quando usar | Iterar, pilotar ou distribuir para uma audiência conhecida | Ampla disponibilidade organizacional para um agente pronto para produção. |
Observação
Os limites de compartilhamento definidos pelo administrador se aplicam somente à versão compartilhada. Eles não restringem quem pode instalar a versão do Agent Store. Administração configurações de disponibilidade no Centro de administração do Microsoft 365 controlam quem vê a versão do Agent Store.
O que os administradores analisam
Quando você envia seu agente, o administrador analisa os seguintes itens para validar o comportamento de segurança, conformidade e acesso a dados:
- O nome de exibição do agente e a breve descrição
- Recursos configurados e fontes de conhecimento
- O rótulo de confidencialidade do agente
- Informações do desenvolvedor (nome do desenvolvedor, site do criador, política de privacidade, termos de uso)
- Metadados sobre o agente declarativo subjacente
Para obter mais informações, consulte Publicar agentes no Centro de administração do Microsoft 365.
Antes de enviar
Certifique-se de que seu agente esteja pronto para uso organizacional antes de enviá-lo.
Pré-requisitos
- Você publicou seu agente. O item de menu Enviar para o catálogo da sua organização está desabilitado até que você publique o agente pelo menos uma vez.
- Seu agente está completo, pronto para produção e em conformidade com os padrões, regras e políticas da sua organização.
- Os usuários que instalam o agente têm acesso às fontes de conhecimento que ele usa.
Práticas recomendadas
- Usar fontes de conhecimento controladas. Prefira sites do SharePoint e outras fontes compartilhadas que seu público-alvo possa acessar.
- Divulgar o uso do conhecimento pessoal. Se o seu agente usa fontes de conhecimento pessoais do Work IQ, como reuniões, chats ou emails do Microsoft Teams, menção esse uso na breve descrição para que os usuários saibam que o agente pode fazer referência a seus dados pessoais de trabalho.
- Design para escala organizacional. Use linguagem neutra e profissional na descrição do agente e nos prompts iniciais. Teste com os usuários de amostra antes de enviar.
- Forneça metadados completos. Inclua informações precisas para desenvolvedores e links para a política de privacidade e os termos de uso da sua organização. Para obter mais informações, consulte Política de privacidade e termos de uso.
Enviar um agente ao catálogo da sua organização
No Microsoft 365 Copilot, acesse Todos os agentes, selecione o agente que deseja enviar e selecione Editar.
Se o rascunho contiver alterações não publicadas, selecione Atualizar para publicá-las. O envio usa a versão publicada mais recente do seu agente.
No cabeçalho de criação do agente, selecione Mais reticências (...) e, em seguida, selecione Enviar para o catálogo da organização.
Você também pode começar a enviar em:
- A caixa de diálogo de compartilhamento, selecionando o link Enviar para seu catálogo .
- A caixa de diálogo publicar com sucesso, selecionando o link Enviar para seu catálogo .
Na caixa de diálogo de envio, forneça as seguintes informações. Todos os campos são obrigatórios.
Campo Comprimento máximo Descrição Nome de Exibição 30 caracteres O nome que aparece no Repositório de Agentes. Descrição curta 80 caracteres Um resumo conciso do que o agente faz. Padrão: criado usando o Construtor de Agentes do Microsoft 365 Copilot. Nome do desenvolvedor 32 caracteres Seu nome ou o nome da sua equipe. Site do criador 2,048 caracteres Um link para obter mais informações sobre você ou sua equipe, como sua página de perfil, o site do SharePoint da sua equipe ou uma página de suporte interno. Abre quando os usuários selecionam o nome do criador no painel de detalhes do agente. Deve ser uma URL HTTPS válida. Substitua o link de espaço reservado padrão pelo seu. Política de privacidade 2,048 caracteres Um link para a política de privacidade da sua organização. Deve ser uma URL HTTPS válida. Substitua o link de espaço reservado padrão pela URL da sua organização. Para obter detalhes, consulte Política de privacidade e termos de uso. Termos de uso 2,048 caracteres Um link para os termos de uso da sua organização. Deve ser uma URL HTTPS válida. Substitua o link de espaço reservado padrão pela URL da sua organização. Dica
A breve descrição, o site do criador, a política de privacidade e os termos de uso são preenchidos previamente nas configurações Sobre este agente do agente. Para definir esses valores sem iniciar um envio, use Sobre este agente no cabeçalho de criação do agente. Para obter mais informações, consulte Atualizar as informações sobre do agente.
Selecione Continuar. O Agent Builder salva suas alterações, publica a versão atualizada e a envia para revisão do administrador.
Após o envio, a caixa de diálogo mostra Enviado para aprovação do administrador junto com as próximas etapas.
Acompanhar o status de envio
Para marcar o status a qualquer momento, abra o agente, selecione Mais reticências (...) e, em seguida, selecione Enviar para o catálogo da organização. A caixa de diálogo mostra o estado atual.
| Status | Significado |
|---|---|
| Aguardando aprovação | Seu envio está pendente de revisão pelo administrador. |
| Aprovado | Seu administrador aprovou o envio. O agente está disponível no Agent Store em Criado pela sua organização. |
| Rejeitado pelo administrador | Seu administrador rejeitou o envio. A faixa inclui o comentário do revisor para que você saiba o que corrigir antes de reenviar. |
Um agente pode ter apenas um envio pendente ativo. Se você reenviar enquanto um envio estiver pendente, o novo envio substituirá o existente.
Atualizar um agente aprovado
As alterações publicadas no Agent Builder não fluem automaticamente para o Agent Store. Reenvie o agente quando quiser que suas atualizações sejam revisadas e publicadas no Agent Store.
- Faça suas alterações no Agent Builder e selecione Atualizar para publicar.
- Na caixa de diálogo de publicação bem-sucedida, selecione o link Enviar para o catálogo .
- Preencha a caixa de diálogo de envio conforme descrito em Enviar um agente para o catálogo da sua organização.
Após a aprovação, os envios subsequentes são revisados como atualizações para o mesmo agente, não como novos envios. Os administradores veem alterações incrementais para facilitar uma revisão mais rápida.
Importante
As alterações publicadas no Agent Builder atualizam a versão compartilhada imediatamente. A versão do Repositório de Agentes não é atualizada até que um administrador aprove seu novo envio. Até lá, os usuários que instalam o agente pelo Repositório de Agentes continuam vendo a última versão aprovada.
Encontre seu agente na Loja de agentes
Depois que o agente for aprovado, abra a listagem da Agent Store para compartilhar o URL com os usuários. Use um dos seguintes métodos.
Na caixa de diálogo de envio:
- Abra o agente e selecione as reticências Mais (...) >Envie para o catálogo da sua organização.
- Na faixa Aprovado , selecione Ir para a loja do agente.
De todos os agentes:
- No Microsoft 365 Copilot, selecione Todos os agentes.
- Em Criado pela sua organização, encontre seu agente. Para localizá-lo rapidamente, use a pesquisa.
- Selecione o agente para abrir o painel de detalhes do agente e, em seguida, selecione o ícone de link para copiar a URL do agente.