Referência de comandos do Agent Developer Kit

Cada comando neste artigo é um comando de barra que você insere no painel GitHub Copilot Chat no Visual Studio Code. Execute esses ess-maker-skills comandos no espaço de trabalho após a execução do primeiro comando.

Se você esquecer um comando, o chat do Copilot listará os disponíveis quando você entrar / na entrada do chat. Você também pode concorrer /menu para a mesma lista com descrições curtas.

Comandos em um piscar de olhos

Comando Função Quando usar
/setup Conecta-se ao seu ambiente do Power Platform, localiza seu funcionário Self-Service agente e salva uma cópia local. Use-o para a primeira configuração. Ele também alterna de ambiente ou adiciona um segundo agente posteriormente.
/connect Conecta um sistema externo, Workday ou ServiceNow, de ponta a ponta. Use-o para adicionar uma nova integração ou corrigir uma quebrada.
/create Cria um novo tópico ou fluxo de trabalho com base em uma descrição simples em inglês. Use-o para adicionar um novo cenário com o qual o agente possa lidar.
/update Modifica um tópico ou fluxo de trabalho existente. Use-o para alterar frases de gatilho, mensagens ou o fluxo de um cenário existente.
/delete Remove um tópico ou fluxo de trabalho, com verificações de segurança para referências downstream. Use-o quando um cenário não for mais necessário.
/scan Verifica se há erros nos arquivos do agente e orienta você nas correções. Use-o depois de qualquer alteração e antes de empurrar.
/evaluate Gera casos de teste no formato CSV que o avaliador do Copilot Studio espera. Use-o para criar um conjunto de testes de linha de base ou para confirmar a qualidade após uma alteração importante.
/push Envia suas alterações locais para o Copilot Studio. Use-o quando estiver pronto para aplicar edições locais ao agente ao vivo.
/flightcheck Executa uma marca de preparação pré-implantação em licenças, ambiente, integrações e arquivos de agente. Use-o antes de publicar ou durante a triagem de um problema do cliente.
/troubleshoot Fornece triagem interativa para problemas comuns. Use-o quando algo não funcionar e você quiser ajuda guiada.
/menu Mostra a lista de comandos disponíveis. Use-o quando esquecer um nome de comando.

Sequências de comandos comuns

Adicionar um novo tópico do zero

/create        <- describe the scenario
/scan          <- catch any compile errors
/push          <- send the change to Copilot Studio

Conectar uma integração

/connect servicenow      <- or /connect workday
/flightcheck             <- confirm the integration is healthy

Prepare-se para publicar

/scan          <- catch local errors
/flightcheck   <- comprehensive readiness check across 40+ verifications
/push          <- send any final changes

Gerar casos de teste para o avaliador

/evaluate      <- pick which dimensions to generate

Carregue os arquivos CSV resultantes para o avaliador do Copilot Studio na exibição de análise do agente.

Verificação de preparação do FlightCheck marcando

/flightcheckExecuta uma marca abrangente de prontidão pré-implantação em mais de 40 verificações. Execute-o antes de publicar para os usuários finais ou quando você fizer a triagem de um problema do cliente e quiser um único relatório que verifique as causas mais comuns.

A marca abrange:

  • Licenças - confirma que as licenças e direitos necessários estão em vigor.
  • Environment - valida o ambiente do Power Platform e sua configuração.
  • Identidade - verifica a conta de entrada e as permissões que ela possui.
  • Integrações - verifica se os sistemas conectados, como Workday e ServiceNow, estão conectados e acessíveis.
  • Arquivos de agente - verifica se há erros em seus tópicos e fluxos de trabalho locais.
  • Publicação - confirma que o agente está pronto para publicar.

O FlightCheck produz um relatório HTML que você pode compartilhar com as partes interessadas. Quando encontra um problema que pode resolver, ele oferece a possibilidade de corrigi-lo para você.

/flightcheck

Para obter o histórico conceitual sobre o que o FlightCheck valida, consulte Publicar o funcionário Self-Service agente.

Como os comandos respondem

Os comandos do kit são conversacionais. Quando um comando precisa de mais informações, ele pergunta. Você não precisa se lembrar de todas as opções:

  • "Em qual agente você quer trabalhar?" - responda com o nome ou número
  • "Quais devem ser as frases de gatilho?" - resposta em inglês simples
  • "Tem certeza de que deseja excluir isso?" - resposta yes ou no

Se sua resposta for vaga, o comando pede mais detalhes em vez de adivinhar.

Onde os comandos procuram instruções

Os comandos do kit dependem do modelo do Copilot Chat captar o contexto do seu espaço de trabalho. Se um comando der uma resposta confusa:

  • Certifique-se de que a raiz do workspace seja ess-maker-skills e não o repositório completo (consulte a Etapa 1).
  • Certifique-se de selecionar um modelo recomendado.
  • Execute o comando novamente. Os modelos ocasionalmente não respondem.

Para modos de falha específicos, confira Solução de problemas de introdução.

Onde saber mais sobre cada comando

O conjunto de documentos do Copilot Studio abrange os conceitos mais amplos nos quais os comandos operam. Quando você quiser o plano de fundo conceitual:

Conceito Consulte
Componentes do funcionário Self-Service agente (tópicos, fluxos de trabalho, variáveis) Personalizar o Funcionário Self-Service agente
Integração do dia de trabalho Integração simplificada do Workday ou integração do Workday
Integração do ServiceNow Integração do ServiceNow HRSD e ITSM
Avaliações Avaliações para o Funcionário Self-Service agente
Publicação Publique o Funcionário Self-Service agente

Próximas etapas