openai excel functions

Funções da API OpenAI para Excel

Crie conclusões de bate-papo OpenAI a partir de fórmulas do Excel

Suplemento do Excel orientado ao desenvolvedor que fornece =OAI.CHAT_COMPLETE() para chamar a API de conclusões e auxiliares. Use o poder das planilhas para engenharia imediata, decomposição imediata, prototipagem de sistemas e muito mais.

Por que este suplemento

• Gratuito - use sua própria chave API
• Confidencial - as chamadas vão diretamente para a API da OpenAI
• Abrangente – suporta todos os modelos e parâmetros
• Observável - visualize e use todos os dados de solicitação e resposta da API
• Código aberto

Desenvolvido tendo em mente os desenvolvedores de IA generativa - estão disponíveis outros produtos que podem ser mais adequados para o uso de IA generativa em planilhas gerais. Como regra, não incluímos funções de conveniência para tarefas que podem ser razoavelmente realizadas usando funções integradas do Excel.

Blogue

Leia nossa postagem Engenharia imediata com planilhas no blog da Scott Logic, onde você também encontrará muito mais sobre inteligência artificial e tudo relacionado a software.

Instalação

O suplemento é instalado por meio de um processo de “sideload”, no qual você carrega o arquivo de manifesto no Excel, que então carrega o código do suplemento diretamente do GitHub. Não é publicado na Office Store.

Primeiro, baixe o arquivo manifest.xml . Você não precisará modificar isso ou baixar mais nada - desconsidere essas instruções nas instruções vinculadas a seguir.

Siga as instruções de sideload para sua plataforma:

• Na web, use a técnica de "sideload manual".
• No Windows, use a opção “configurar confiança manualmente” na etapa relevante.

Tipo =OAI. na barra de fórmulas ou em uma célula, e você deverá ver as novas funções.

Desinstalação

Na web, limpe os cookies do seu navegador para o seu domínio.

Para outras plataformas, limpe o cache do Office.

Uso

OAI.CHAT_COMPLETE() chama a API para criar conclusões. É típico configurar uma planilha contendo parâmetros para a chamada do modelo. A primeira coluna é usada como chaves de parâmetro e a segunda como valores. O parâmetro API_KEY é obrigatório e seu valor deve ser obtido no console OpenAI.

OAI.COST() calcula o(s) custo(s) de faturamento da(s) célula(s) de conclusão. Envolva-o com SUM() para calcular um total.

Consulte os metadados da função para documentação completa de funções e parâmetros. A apresentação da documentação de funções personalizadas no Excel varia em termos de integridade de acordo com a plataforma, mas é melhor na caixa de diálogo Inserir Função e/ou na plataforma de desktop.

Cuidado

Aconselhamos cautela para evitar incorrer involuntariamente em custos excessivos ao trabalhar com muitas células de completação ou completações caras. Alterações nas células de dependência podem causar recálculo em massa, e determinadas ações no Excel podem acionar o recálculo completo. Você pode querer mudar o modo de cálculo no Excel de automático para manual. São feitas no máximo 10 solicitações de API em paralelo - para cancelar solicitações em espera ou pendentes, desfazer sua alteração ou excluir a fórmula.

Usando resultados de conclusão

As conclusões preenchem a célula com um tipo de dados personalizado que inclui a solicitação e a resposta completas da API. Seu valor de texto é o conteúdo da primeira opção de conclusão.

Para obter o valor do texto para uso em fórmulas, utilize a função VALUETOTEXT() . Para obter outros dados de solicitação/resposta, use a notação de ponto para o caminho da propriedade (por exemplo, A123.response.model ).

Para visualizar os dados de conclusão, abra o cartão da entidade. A propriedade lines fornece uma visualização linha por linha do conteúdo de conclusão.

Para extrair uma resposta final que siga uma cadeia de pensamento, você poderia usar uma fórmula como:

 =TEXTAFTER(VALUETOTEXT(A123), "<!-- END CoT -->" & CHAR(10))

Desenvolvimento de suplementos

Instruções para começar o trabalho de desenvolvimento

Pré-requisitos

Se você estiver no Windows, configure o NPM para usar um shell compatível com sh, por exemplo:

npm config set script-shell " C: \ Program Files \ git \ bin \ bash.exe "

Configure seu IDE para aderir à formatação do código do projeto. Para VSCode, eles serão carregados nas configurações do espaço de trabalho em .vscode/ ; para outros editores/IDEs você precisará configurar de forma equivalente. Pode ser necessário desativar/desativar quaisquer configurações ou extensões pessoais que interfiram.

Instalar e executar

1. Instale as dependências npm ( npm i )
2. Gere e instale certificados ( npm run install-certs )
3. Execute o servidor local ( npm start ).

Além disso, você pode precisar navegar até a raiz do seu navegador e confiar temporariamente no par de chaves de certificado recém-criado.

Abrir no Excel web

1. Abra uma planilha no Excel na Web e anexe os seguintes parâmetros de string de consulta

 wdaddindevserverport=3000&wdaddinmanifestfile=manifest-localhost.xml&wdaddinmanifestguid=00aeeb98-f4d9-4db0-a1e6-cdc652c08e34

2. Se você for solicitado a ativar o modo de desenvolvedor do Excel, faça-o.

Agora você deve conseguir usar as funções normalmente. Ao fazer uma alteração, você precisará recarregar a janela do navegador.

Abrir na área de trabalho do Excel

npm run sideload:desktop

Arquivos principais

Caminho	Descrição
src/funções/funções.json	Os metadados que detalham cada função e fazem referência à sua implementação.
src/funções/funções.mjs	As funções JavaScript que implementam as funções.
compartilhado.html	Página raiz carregada em segundo plano durante a inicialização do suplemento.
manifesto-local.xml	Uma versão do manifest.xml que faz referência a https://localhost:3000/ para uso no desenvolvimento de complementos.
manifesto.xml	Configura de onde o suplemento deve ser carregado e quais recursos ele utilizará.