Considerações de desenvolvimento de ações
Vamos explorar conceitos fundamentais relacionados com a criação de ações para agentes copilot no Copilot Studio.
Pré-requisitos
Para expandir os agentes copilot com ações no Copilot Studio, precisa de:
- Uma conta de trabalho ou escolar com acesso ao Copilot Studio. Se você ainda não tiver acesso ao Copilot Studio, dependendo da configuração da sua organização do Microsoft 365, você poderá criar uma conta de avaliação.
- Uma licença de Microsoft 365 Copilot
- Credenciais necessárias para ligar a origens de conteúdo pretendidas (conectores, APIs, etc.)
Observação
No momento da publicação deste módulo, as ações do Copilot Studio estão em Prévia Pública. Recursos em prévia não são destinados ao uso em produção e podem ter funcionalidade restrita. Esses recursos estão disponíveis antes de um lançamento oficial para que os clientes possam ter acesso antecipado e fornecer feedback.
Ambientes e soluções
Antes de criar uma nova ação, você poderá optar por criar ou selecionar um ambiente do Power Platform específico. Os ambientes são espaços para armazenar, gerenciar e compartilhar os dados corporativos, os aplicativos e os processos de negócios da sua organização. Também servem como contêineres para separar aplicativos que podem ter diferentes funções, requisitos de segurança ou públicos-alvo. Cada ambiente pode ter apenas um banco de dados do Microsoft Dataverse.
Para gerenciar os ambientes, navegue até e https://admin.powerplatform.microsoft.com/ entre usando credenciais de função de administrador de ambiente ou administrador do sistema.
Ao criar uma nova ação, você será solicitado a selecionar uma solução para sua ação. As soluções são usadas para transportar aplicativos e componentes de um ambiente para outro ou para aplicar um conjunto de personalizações a aplicativos existentes.
Copilot Studio pode sugerir uma solução predefinida ou criar uma nova solução para si quando criar uma ação. Recomendamos que tenha uma solução personalizada para uma gestão fácil das suas aplicações e componentes. Armazenar sua ação em uma solução permite movê-la facilmente entre os ambientes. Para saber mais sobre soluções, veja Utilizar uma solução para personalizar
Fontes de conhecimento
As origens de conhecimento baseiam as suas ações e os seus agentes com informações especificadas. Existem várias origens de conhecimento que pode adicionar às suas ações no Copilot Studio. As opções e métodos específicos dependem do tipo de ação que você está criando.
As fontes de conhecimento podem incluir o seguinte:
- Tabelas do Dataverse
- Arquivos enviados
- SharePoint e OneDrive
- Sites públicos
- Dados empresariais através de conectores Copilot
- Arquivos do OneDrive
- APIs
Entradas e saídas
Poderá ter de adicionar variáveis de entrada ou saída às ações que criar no Copilot Studio.
As variáveis de entrada permitem que você defina as informações necessárias para sua ação antes que ela possa ser executada. Por exemplo, um conector que fornece informações de previsão do tempo pode exigir uma variável de entrada que capture as unidades meteorológicas desejadas.
As variáveis de saída definem qualquer saída que a ação fornece que pode ser passada para outra ação ou enviada em uma resposta ao usuário.
Em alguns casos, a ação que está a utilizar pode exigir parâmetros específicos, caso em que não pode adicionar ou remover variáveis. No entanto, ainda pode modificar as descrições para fornecer uma melhor compreensão das entradas e saídas.
Autenticação
Algumas origens de conteúdo e conectores requerem tipos específicos de autenticação. Quando você seleciona seu conteúdo, a fonte solicita as informações necessárias para autenticação.
Aqui estão alguns exemplos:
- Não autenticado: conector do MSN Clima. Essa ação do conector recupera apenas os dados meteorológicos públicos e não tem conteúdo seguro. Como resultado, o conector meteorológico está aberto para ser usado sem fornecer credenciais.
- Ações do conector: se você usar um conector para acessar sua fonte de dados, ele terá seu método de autenticação integrado ao conector. Não irá configurá-lo na configuração, mas as ações do conector requerem um conjunto válido de credenciais. Por predefinição, as ações do conector são configuradas para pedir aos utilizadores (utilizadores do seu agente) que forneçam as respetivas credenciais para o serviço associado, quando a ação é invocada. Tenha em atenção que todas as ações que selecionar para o conector estarão disponíveis para todos os utilizadores do seu agente. Você não pode ter permissões baseadas em função para uma ação específica dentro de um conector.
- Ação de solicitação: usa sua identidade do Teams ou do Power Apps. Certifique-se de compartilhar a solicitação para os usuários ou grupos apropriados após a criação.