SDK da Geyser · 0.3.4

Crie apps que põem os Agents para trabalhar

Coloque Agents nos softwares que sua equipe ou seus clientes já usam. Eles podem investigar um pedido, escrever um resumo ou sugerir uma mudança, e depois devolver um resultado com o qual o seu aplicativo consegue trabalhar.

“Diga-me o trabalho, o formato que você quer receber e um limite a respeitar. Devolvo um resultado que seu app pode usar.”

Otis

Ajude o suporte a destrinchar um ticket complicado

Ajude alguém da sua equipe de suporte a entender um chamado difícil e a escrever uma resposta. O exemplo de suporte organiza os detalhes do chamado que você envia, pede a um Agent que investigue o contexto e depois confere as fontes que o Agent cita.

Seu app cuida da conexão com a central de atendimento e repassa os registros. O exemplo escreve um rascunho, e uma pessoa decide se ele está certo e se deve ser enviado.

Experimente o exemplo de suporte

Transforme a pesquisa em um resumo que as pessoas possam usar

Crie algo que ajude uma equipe de vendas a se preparar para uma ligação com o cliente ou que ajude uma pesquisadora a se atualizar sobre um assunto. Envie as anotações e os documentos e peça a um Agent um resumo com referências.

Comece pelos exemplos de revisão por Agent e de conferência de fontes. Eles pegam referências que faltam ou que foram inventadas, mas você ainda vai querer fazer a sua própria revisão para checar os fatos.

Experimente os blocos de construção de pesquisa

Adicione uma etapa de aprovação a uma ferramenta de operações

Deixe um Agent propor uma mudança em um registro, mostrar a uma pessoa o que vai acontecer e esperar a decisão dela. Funciona bem em ferramentas internas em que a equipe revisa as mudanças antes de elas valerem.

Os exemplos de registro aprovado rodam em um banco de dados de exemplo ou em um espaço de trabalho de Agent descartável, e cobrem a aprovação e a recuperação de uma resposta interrompida. Qualquer conexão com um sistema de negócio real vem do seu app.

Experimente uma atualização aprovada

Crie ferramentas sob medida para o jeito da sua equipe trabalhar

Crie um assistente de propostas ou uma ferramenta de passagem de projeto que siga as instruções da sua equipe. Empacote as etapas e o contexto de que ela precisa, e você pode reaproveitar a abordagem no próximo trabalho.

Um Agent Bundle reúne instruções, habilidades e contexto portátil em um só pacote. Cada execução continua seguindo as permissões do espaço de trabalho como estiverem naquele momento e pede uma nova aprovação antes de qualquer ação importante.

Empacote um fluxo de trabalho reutilizável
Por que criar na Geyser?

Gaste seu tempo com o app enquanto a Geyser acompanha o trabalho

O seu app é dono da interface e das conexões dele com outros serviços. A Geyser acompanha a tarefa do Agent em um só lugar dentro do espaço de trabalho do cliente, incluindo o progresso, o orçamento, as permissões, os pedidos de aprovação e o resultado.

Se a conexão cair, você se reconecta à mesma tarefa. Você pode mostrar às pessoas o trabalho que está esperando uma decisão e receber os resultados no formato que o seu app espera. Tudo isso compensa quando um trabalho tem várias etapas ou precisa de supervisão. Para uma transformação de texto simples, uma chamada direta ao modelo ou uma função comum pode ser tudo de que você precisa.

Crie um aplicativo com o SDK
  1. Dê um trabalho a ele

    Envie as informações que você pode usar, o formato que quer receber de volta e os limites de tempo e de gasto.

  2. Iniciar a tarefa

    Reutilize o mesmo ID de operação para o app encontrar a tarefa de novo se a conexão cair.

  3. Acompanhe o trabalho

    Acompanhe o andamento e mostre às pessoas qualquer pedido de aprovação ou de ajuda para retomar uma ação interrompida.

  4. Use o resultado

    Busque o resultado salvo no espaço de trabalho do cliente e confira antes de usá-lo.

Comece com um exemplo pequeno que funcione

Rode sua primeira ferramenta na sua própria máquina

Escreva uma ferramenta em Python que receba JSON, rode com as entradas de exemplo e veja o que sai. O início rápido executa o seu código de verdade em um ambiente restrito, junto com um teste que rejeita entradas inválidas, e você não precisa de conta para experimentar.

O início rápido com o código-fonte marcado precisa do Python 3.11 ou posterior e de um sandbox compatível, que é o sandbox-exec do macOS ou o bubblewrap do Linux com namespaces de usuário permitidos. Depois de instalado, o handler não usa modelo, acesso à rede nem credenciais.

Entenda o contrato de extensões
Versão 0.3.4 marcada · execução local
git clone --branch v0.3.4 --depth 1 https://github.com/geyserlabs/geyser-open.git
cd geyser-open
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ./sdk/python -e ./cli
geyser init tool word-count
geyser test word-count
geyser --json dev word-count
Autoridade e disponibilidade, ditas com clareza

Onde as coisas rodam e quanto custam

Cada projeto trabalha por meio de um Agent que você escolhe. As chaves do projeto só funcionam para esse projeto e só no lugar onde os dados do espaço de trabalho dele ficam hoje. Um pacote JSON assinado só entra no ar depois que esse Agent o confere byte a byte e ele passa nos testes em um sandbox.

Uma extensão feita só de JSON não consegue mexer nos arquivos do computador, na rede, em outros processos nem em credenciais que possa herdar. As tarefas de Agent que você envia pelo SDK ou pela CLI usam os modelos e as ferramentas configurados no seu espaço de trabalho. O SDK em si tem licença MIT, e o uso remoto de modelos e de computação é cobrado na sua conta. Durante a prévia, não há cota gratuita de computação nem SLA de disponibilidade.

O SDK/CLI 0.3.4 está no PyPI e no GitHub. O Homebrew o instala em Macs com Apple silicon e em Linux AMD64, e os handlers locais em Python também precisam do Python 3.11 ou posterior. Rodar localmente já funciona hoje. Rodar uma tarefa remotamente exige versões compatíveis do software do espaço de trabalho e do software do Agent, então confira a página Desenvolvedores no console antes de enviar uma. Um bundle não amplia o que um Agent já pode fazer, e um perfil de modelo escolhe entre os modelos que já estão configurados. Os forks públicos de inspeção não executam ferramentas, e repetir uma execução é uma operação separada.

Comece agora

Comece por um trabalho que seu app poderia facilitar

Escolha um exemplo, adapte ao jeito de trabalhar da sua equipe e veja se ele poupa você de construir sozinho o tratamento das tarefas. Cada exemplo é um ponto de partida para o seu próprio aplicativo.