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.
O interpretador de código no Microsoft Copilot Studio e os prompts do construtor de prompts permitem aos criadores desenvolver agentes de IA que:
- Executar código Python para análise de dados, processamento de ficheiros Word, Excel, PowerPoint e PDF, e visualizações
- Utilizem modelos de linguagem para respostas generativas
Esta funcionalidade é adaptado para programadores, analistas de negócios e criadores de low-code. A geração e execução de código integram-se perfeitamente com o ecossistema do Copilot Studio para criar soluções poderosas impulsionadas por IA.
Os programadores devem ler Interpretador de Código para Programadores e rever o exemplo de componente Interpretador de Código do Power Apps Component Framework (PCF) para compreender como podem usar a mensagem Predict Dataverse para invocar prompts e processar as respostas devolvidas.
Requerimentos
Licenciamento: Microsoft Copilot Studio faturação e licenciamento. A geração e execução de código contam como caraterísticas de ferramentas de texto e de IA generativa (premium).
Regiões suportadas: Disponível para todas as nuvens públicas. As clouds soberanas não são atualmente suportadas.
Capacidades do interpretador de código
Agentes que usam um interpretador de código podem escrever e executar código Python para tarefas avançadas. Os casos de uso incluem:
- Processamento de ficheiros Excel: Crie, copie e atualize folhas de trabalho Excel num livro de trabalho, leia e aplique estilos de células, copie formatação entre células, copie e atualize fórmulas entre células e mais.
- Processamento de ficheiros Word e PowerPoint.
- Processamento de ficheiros PDF: Criar e copiar ficheiros PDF, ler tabelas e parágrafos de texto.
- Processamento de dados da tabela Dataverse.
- Cálculos matemáticos e estatísticos complexos.
- Análise, manipulação e visualização de dados (por exemplo, gráficos e tabelas).
O intérprete de código adiciona as seguintes capacidades aos pedidos:
- Suporte para ficheiros como formato de saída em prompts.
- Suporte para ficheiros Excel como formatos de entrada e saída para indicações.
Crie prompts de uma das duas formas:
- Em Power Apps: Use a opção Construa o seu próprio prompt no AI Hub.
- No Copilot Studio: Adicione um prompt como ferramenta ao nível do agente ou do tema.
Saiba mais sobre os prompts na visão geral dos prompts.
Também podes usar o interpretador de código no chat do agente no Copilot Studio.
Inicie um novo prompt no Power Apps AI Hub e ative o interpretador de código
Podes iniciar um novo prompt no AI Hub no Power Apps e ativar o interpretador de código nas definições do prompt.
Vai a Power Apps.
Selecione AI hub no painel esquerdo.
Selecione Pedidos.
Selecione Criar o seu próprio pedido.
Introduza um nome para o seu prompt.
Na secção de Instruções , selecione os três pontos (...), e depois selecione Definições.
Nas Definições, ativa o interpretador de código.
Fecha as Definições para voltar ao editor de prompts.
O editor de prompts está aberto com o interpretador de código ativado. De seguida, escreva instruções para o seu prompt.
Inicie um novo prompt como ferramenta dentro de um agente e ative o interpretador de código
Podes iniciar um novo prompt como ferramenta dentro de um agente em Copilot Studio e ativar o interpretador de código para esse prompt.
No Copilot Studio, vai ao agente onde queres usar o interpretador de código.
Adicione um novo prompt ao agente como ferramenta, seja ao nível do agente ou ao nível do tópico.
Adicione um prompt ao nível do agente:
Vai à página de Ferramentas .
Selecionar Adicionar uma ferramenta>Prompt.
Adicione um prompt ao nível do tema:
Vai à página de Tópicos e seleciona o tema onde queres adicionar o prompt.
Selecione Adicionar nó na posição do tópico onde quer adicionar o prompt.
Selecione Adicionar uma ferramenta>Novo prompt.
A interface de criação de prompts embutida do construtor de prompts abre-se.
Na barra de informações, selecione os três pontos (...), e depois selecione Definições.
Na página Definições, selecione Ativar o intérprete de código.
Fecha as Definições para voltar ao editor de prompts.
O editor de prompts está aberto com o interpretador de código ativado. De seguida, escreva instruções para o seu prompt.
Escreva instruções para o seu prompt
De seguida, podes escrever as instruções do prompt, configurar o prompt conforme necessário e guardar para criar o prompt.
Saiba mais sobre como usar o interpretador de código em prompts em exemplos de prompts de interpretador de código.
Práticas recomendadas para interpretador de código em prompts
- Usa outras ferramentas de IA como o Copilot para obter o prompt otimizado para começar.
- Use pedidos precisos com exemplos (pedidos de poucas capturas).
- Especifique as saídas (por exemplo, "Devolver como JSON" ou "Excel" ou "PDF").
Limitações
- Não há suporte para a análise de vários arquivos carregados em um único prompt.
- Não há suporte para o retorno de várias saídas de arquivo em um único prompt.
- Não há suporte para fazer perguntas sobre um arquivo carregado em vários turnos.
- Para usar o interpretador de código, precisas de configurar o teu agente, nas definições do agente, para usar autenticação de utilizador. Por exemplo, usar Direct Line com Sem autenticação selecionado não funciona para cenários usando o interpretador de código.
Troubleshooting
Se encontrar erros ao usar o interpretador de código, experimente os seguintes passos:
- Assegure que todas as permissões necessárias são concedidas. Verifique se a conta de utilizador e o agente têm as permissões necessárias para executar os prompts do interpretador de código.
- Verifique as definições de configuração. Confirme que o interpretador de código está ativado nas definições de prompt e que o seu agente está configurado para usar autenticação de utilizador.
- Consulte os registos de erros para informações detalhadas. Revise os registos de erro no Copilot Studio ou no ambiente Power Platform associado para identificar a causa raiz do problema e tomar medidas corretivas.