Configurar o ambiente de desenvolvimento para o seu plug-in

Use o plano de desenvolvimento em Escolher ferramentas de desenvolvimento para preparar os ambientes, contas, ferramentas, identidades, permissões, conexões e serviços exigidos pelos componentes do plug-in.

Conclua essa configuração antes de criar, configurar, estender ou reutilizar os componentes. Talvez você precise de mais de um ambiente ou ferramenta quando o plug-in combina agentes, habilidades, conectores e recursos baseados em MCP.

Comece com o plano de desenvolvimento

Para cada componente, confirme:

• A ferramenta de desenvolvimento e o repositório de fonte de verdade ou ambiente gerenciado.
• O locatário de desenvolvimento ou teste, o ambiente, a região e as experiências de destino da Microsoft.
• Licenças de produto necessárias, cobrança baseada em uso, assinaturas e planos de serviço.
• Funções de administrador necessárias, registros de aplicativo, identidades, permissões e consentimento.
• Fontes de dados necessárias, APIs, serviços remotos, hospedagem, acesso à rede e segredos.
• Usuários de teste e dados representativos de não produção.
• O proprietário responsável por fornecer cada dependência.

Não comece a implementação com falta de acesso ou substitua silenciosamente um ambiente diferente. Registre os pré-requisitos não resolvidos como bloqueadores no plano de desenvolvimento.

O Microsoft 365 Copilot Chat é uma interface de chat de IA amplamente acessível que está disponível para todos os usuários do Microsoft 365. Os usuários do Copilot Chat têm acesso a agentes que ampliam seus recursos e podem ser fundamentados em instruções ou na Web. Os usuários em locatários que têm a cobrança paga conforme o uso do Copilot Studio habilitada (consumida como Créditos do Copilot) e usuários com licenças do Microsoft 365 Copilot têm acesso a agentes com recursos aprimorados, como base com dados do SharePoint e conectores do Microsoft 365 Copilot.

Para obter informações de licença do Microsoft 365 Copilot, consulte Opções de licença.

Ambiente de desenvolvimento do Copilot

Você tem as seguintes opções para um ambiente de desenvolvimento Copilot:

• Uma assinatura da área restrita do Programa para Desenvolvedores do Microsoft 365 . Os membros do Microsoft 365 Developer Program que se qualificarem para uma assinatura de desenvolvedor podem usar sua assinatura para desenvolver agentes.

  Se escolher uma área restrita instantânea, você terá um ambiente de desenvolvedor E5 pré-configurado que é provisionado em minutos e vem pré-carregado com usuários de exemplo, pacotes de dados do Microsoft Teams e aplicativos personalizados pré-configurados. A opção de área restrita instantânea tem compras de complementos habilitadas. Você pode comprar serviços adicionais, incluindo o Microsoft 365 Copilot, diretamente na área restrita. Para obter detalhes sobre os requisitos de configuração, consulte Configurar uma assinatura da área restrita do desenvolvedor do Microsoft 365.

  Se você provisionar uma área restrita configurável, a assinatura não dará suporte ao comércio. Você não pode comprar uma licença do Copilot e, portanto, não pode basear agentes em dados organizacionais ou adicionar outros recursos ao escolher essa opção.

  Importante

  A elegibilidade para o Programa de Desenvolvedores do Microsoft 365 é limitada a assinantes do Visual Studio Professional ou Enterprise, membros do Programa de Sucesso ISV, parceiros qualificados do Programa de Parceiros de Nuvem do Microsoft AI (MAICPP) e clientes de Suporte Premier ou Unificado.

• Um ambiente de produção Microsoft 365 ou Office 365 qualificado com uma licença do Microsoft 365 Copilot.

  Observação

  Ao criar agentes em ambientes de produção, você pode encontrar limitações impostas pelo administrador. Por exemplo, os administradores podem bloquear o sideload de aplicativos personalizados ou podem não conceder as permissões necessárias para criar conectores Copilot.

• Uma assinatura do Microsoft 365 sem uma licença do Copilot, como o Microsoft 365 Business Basic, se você quiser criar e testar agentes para o Microsoft 365 Copilot Chat, com recursos limitados.

Você também pode adquirir uma licença do Microsoft 365 Copilot e configurar um ambiente de desenvolvimento independente do seu ambiente de produção, no qual você pode ser seu próprio administrador.

Organizações com licenças do Microsoft 365 Copilot

Você pode desenvolver soluções de extensibilidade do Copilot trabalhando diretamente em um ambiente de produção do Microsoft 365 com uma licença do Microsoft 365 Copilot.

Entre em contato com seu representante da Microsoft para adicionar o Copilot ao seu plano da Microsoft. Os clientes corporativos precisam estar no Canal Atual ou no Canal Empresarial Mensal para que os aplicativos do Microsoft 365 tenham acesso ao Copilot.

Organizações sem licenças do Microsoft 365 Copilot

Você pode desenvolver soluções de extensibilidade do Copilot para usuários em organizações sem licenças do Copilot, com algumas limitações para seus recursos de agente. Se você quiser aproveitar os recursos do agente, como base em dados organizacionais, poderá habilitar a cobrança paga conforme o uso do Copilot Studio (Créditos do Copilot).

Requisitos para opções de extensibilidade do Copilot

Você pode estender o Microsoft 365 Copilot com a inteligência de serviços e dados externos de várias maneiras:

• Ao criar agentes para personalizar o Copilot.
• Adicionando extensões de mensagem do Teams e ações do Copilot Studio.
• Ampliando o conhecimento no Copilot com conectores do Microsoft 365 Copilot.

Para saber mais e escolher o melhor caminho de extensibilidade para seus usuários, consulte o guia de planejamento de extensibilidade do Copilot e a Visão geral dos agentes.

Requisitos para agentes

Para criar agentes, você precisa concluir os pré-requisitos, dependendo da ferramenta escolhida para usar.

Requisitos de Ferramentas de Desenvolvimento do Work IQ

O Work IQ Dev Tools é uma rota de pré-código profissional para cenários de agente declarativo e pacote de plug-in com suporte. Antes de instalá-lo, confirme:

• Node.js 24 ou posterior. O instalador com suporte pode instalar Node.js quando necessário.
• PowerShell 7 ou posterior no Windows.
• Uma conta do Microsoft 365 com acesso ao Copilot.
• Uma assinatura do Azure quando você provisiona agentes.
• Um locatário de desenvolvimento ou teste que permite a instalação, o compartilhamento ou as ações de catálogo de aplicativo personalizado necessárias.

O instalador padrão instala a CLI do WIQD, sua extensão do Visual Studio Code e o agente da CLI do wiqd:wiqd Copilot. Após a instalação, entre interativamente para desenvolvimento local e execute wiqd doctor para verificar o ambiente. Consulte Instalar ferramentas de desenvolvimento do Work IQ e autenticação de ferramentas de desenvolvimento do Work IQ.

Para integração contínua, use a autenticação de pipeline confiável documentada para comandos de ciclo de vida principais com suporte. Não execute wiqd auth login em um pipeline nem exponha credenciais a trabalhos de solicitação de pull não confiáveis. O monitoramento, a avaliação e outras extensões do Work IQ têm requisitos de autenticação separados. Consulte autenticação de CI/CD.

Requisitos do Kit de Ferramentas de Agentes do Microsoft 365

Você pode usar o Microsoft 365 Agents Toolkit para criar agentes sem uma licença do Microsoft 365 Copilot. Se você quiser criar agentes baseados em dados organizacionais, precisará configurar a cobrança paga conforme o uso em seu locatário ou adquirir uma licença do Microsoft 365 Copilot.

Para criar agentes com o Agents Toolkit e outros IDEs, você deve fazer com que o administrador habilite a capacidade de fazer sideload de um aplicativo personalizado para seu locatário.

Para habilitar o sideload, no Centro de administração do Teams, selecionePolíticas> de configuração de aplicativos> do TeamsGlobal (padrão em toda a organização) e alterne a opção Carregar aplicativos personalizados para Ativado.

Para gerenciar seus aplicativos personalizados de sideload, incluindo agentes, do cliente do Teams, acesse Gerenciar aplicativos>seus aplicativos.

Requisitos do Copilot Studio

O Copilot Studio está disponível para todos os usuários do Microsoft 365. Você pode usar o Copilot Studio para criar agentes e ações. Se você quiser criar agentes baseados em dados organizacionais por meio de conectores do SharePoint ou do Copilot, precisará configurar a cobrança paga conforme o uso em seu locatário ou comprar uma licença do Copilot Studio. Para obter mais informações, consulte Gerenciamento e taxas de cobrança.

As etapas a seguir são necessárias para você usar o Copilot Studio para criar agentes:

• O administrador do Power Platform ou do Dynamics 365 deve habilitar os recursos de IA generativa no centro de administração do Power Platform.
• O administrador do locatário do Microsoft 365 deve implantar o aplicativo Copilot Studio no Centro de administração do Microsoft 365.

Habilitar o modo de desenvolvedor

Você pode usar o modo de desenvolvedor no Copilot para testar se e como o orquestrador seleciona seu plug-in em resposta a um determinado prompt.

Para habilitar o modo de desenvolvedor, no Copilot Chat, digite -developer on. Para desabilitar o modo de desenvolvedor, digite -developer off.

O modo de desenvolvedor só está disponível na experiência licenciada do Microsoft 365 Copilot. Use-o durante o teste de integração de componentes. Para obter mais informações, consulte Depuração de agentes.

Licenças de desenvolvedor do Microsoft 365 Copilot

As contas usadas para testar agentes baseados em dados organizacionais ou que incluem recursos aprimorados precisam de uma licença de desenvolvedor do Microsoft 365 Copilot. Os administradores podem gerenciar licenças de desenvolvedor do Microsoft 365 Copilot no Centro de administração do Microsoft 365 (em Licenças de cobrança>). Você também pode usar o PowerShell para atribuir licenças do Microsoft 365 a contas de usuário.

Recursos do agente e modelos de licenciamento

Os agentes do Copilot estão disponíveis por meio de vários modelos de licenciamento, cada um oferecendo diferentes níveis de funcionalidade:

• Microsoft 365 com uma licença de complemento do Microsoft 365 Copilot - Os usuários com uma assinatura do Microsoft 365 e uma licença de complemento do Copilot têm acesso completo às experiências do agente do Copilot em aplicativos e plataformas compatíveis.
• Microsoft 365 Copilot Business - Um SKU autônomo introduzido para pequenas e médias empresas. Fornece acesso de agente Copilot alinhado com os planos do Microsoft 365 Business.
• Microsoft 365 E7 (Frontier Suite) - Um pacote que inclui recursos do Microsoft 365 E5, do Microsoft 365 Copilot e do Agent 365 para clientes corporativos.
• Cobrança baseada em uso (pagamento conforme o uso): os locatários podem habilitar o acesso do agente sem uma licença completa, com algumas limitações às opções de configuração do agente. O consumo é medido em Créditos do Copilot.
• Microsoft 365 sem uma licença de complemento do Copilot - Os usuários podem ver pontos de entrada do Copilot Chat em alguns aplicativos, mas o acesso às experiências do agente é limitado ou desabilitado com base nas configurações do locatário.

A tabela a seguir resume o acesso do agente com base no tipo de licenciamento do usuário.

A tabela a seguir lista os tipos de agente e os recursos de agente que estão disponíveis para os usuários com base na configuração de cobrança de licenciamento e uso no locatário. Para obter informações sobre taxas de cobrança de uso, consulte Gerenciamento e taxas de cobrança.

* Os limites de uso se aplicam a todos os recursos incluídos.

** Nenhum custo é incorrido para o acesso a fontes de conhecimento que estão disponíveis para usuários sem cobrança baseada em uso.

Perguntas frequentes

Posso usar minha assinatura do Programa de Desenvolvedores do Microsoft 365 para desenvolver com o Copilot?

Sim, você pode usar sua assinatura do Microsoft 365 Developer Program para criar agentes. Se você provisionar uma área restrita instantânea, ela terá compras de complementos habilitadas. Você pode comprar serviços adicionais, incluindo o Microsoft 365 Copilot, diretamente na área restrita. Essa opção permite que você crie agentes com base em dados organizacionais e acesse outros recursos aprimorados. Se você provisionar uma área restrita configurável, a assinatura não dará suporte ao comércio, portanto, você não poderá comprar licenças do Microsoft 365 Copilot ou habilitar a cobrança paga conforme o uso. Os recursos do agente são limitados à base de pesquisa na Web. Para obter mais informações, consulte Configurar uma assinatura da área restrita do desenvolvedor do Microsoft 365.

Não sou um ISV e não tenho uma licença do Microsoft 365 Copilot. Posso obter um ambiente de desenvolvimento do Microsoft 365 Copilot?

Se você tiver uma assinatura do Microsoft 365, poderá criar e testar agentes no Microsoft 365 Copilot Chat, com recursos limitados. Você precisa habilitar a cobrança paga conforme o uso em seu locatário ou comprar uma licença do Microsoft 365 Copilot se quiser criar agentes baseados em dados organizacionais.

Confirmar a preparação do ambiente

Seu ambiente estará pronto quando:

• Todas as ferramentas de desenvolvimento selecionadas estão disponíveis para o contribuidor pretendido.
• O locatário de desenvolvimento ou teste e as experiências da Microsoft de destino estão acessíveis.
• As licenças, cobranças, assinaturas, ambientes e regiões necessários estão configurados.
• Identidades, funções, permissões, consentimento, conexões e segredos do aplicativo estão disponíveis.
• As fontes de dados, APIs, serviços remotos e ambientes de hospedagem necessários estão acessíveis.
• Usuários de teste e dados representativos de não produção estão disponíveis.
• Cada dependência tem um proprietário e os bloqueadores não resolvidos são documentados.

Continue a criar ou reutilizar os componentes do plug-in.

Segurança e privacidade

O Copilot usa permissões e políticas existentes para fornecer as informações mais relevantes, com base em nossos compromissos existentes com segurança e privacidade de dados na empresa. Para obter informações sobre como o Copilot usa e protege os dados organizacionais, consulte Dados, privacidade e segurança do Microsoft 365 Copilot. Para considerações sobre privacidade de dados e segurança para desenvolver diferentes soluções de extensibilidade do Copilot, consulte Considerações sobre dados, privacidade e segurança para estender o Microsoft 365 Copilot.

Conteúdo relacionado

• Criar ou reutilizar recursos para seu plug-in
• Escolher ferramentas de desenvolvimento para o seu plug-in
• Integrar e testar os componentes do plug-in
• Visão geral da extensibilidade do Microsoft 365 Copilot
• Considerações de custos
• Bibliotecas de cliente de APIs do Microsoft 365 Copilot