Coloque Agents no software que a sua equipe ou os seus clientes já usam, para que investiguem um pedido, redijam um resumo ou sugiram uma mudança e devolvam um resultado com que o seu aplicativo consiga trabalhar.
“Diga-me o trabalho, o formato que você quer receber e um limite a respeitar. Devolvo um resultado que seu app pode usar.”
Ajude alguém da sua equipe de suporte a entender um ticket difícil e a redigir uma resposta. O exemplo de suporte organiza os detalhes do ticket que você envia, pede a um Agent que investigue o contexto e confere as fontes que ele 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 suporteCrie 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 de Agents e de conferência de fontes. Eles pegam referências que faltam ou são inventadas, mas você ainda vai precisar de um processo próprio de revisão para conferir os fatos.
Experimente os blocos de construção de pesquisaDeixe um Agent propor uma alteração em um registro, mostrar a uma pessoa o que vai acontecer e esperar a decisão. Serve para ferramentas internas em que a equipe precisa revisar as alterações antes de elas serem aplicadas.
Os exemplos de registros aprovados rodam em um banco de dados de amostra ou em um espaço de trabalho descartável de Agent. Eles cobrem a aprovação e a recuperação de uma resposta interrompida. Qualquer conexão com um sistema real da empresa vem do seu app.
Experimente uma atualização aprovadaCrie um assistente de propostas ou uma ferramenta de passagem de projetos que siga as instruções da sua equipe. Empacote as etapas e o contexto de que ele precisa para 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 ainda segue as permissões atuais do espaço de trabalho e pede nova aprovação antes de uma ação importante.
Empacote um fluxo de trabalho reutilizávelSeu app é dono da interface e das conexões dele com outros serviços. A Geyser guarda num só lugar o andamento, o orçamento, as permissões, os pedidos de aprovação e o resultado da tarefa do Agent, dentro do espaço de trabalho do cliente.
Se a conexão cair, você pode se reconectar à mesma tarefa. Também dá para mostrar o trabalho que aguarda uma decisão e receber os resultados no formato que seu app espera. Vale usar esses controles quando um trabalho tem várias etapas ou precisa de supervisão; para uma transformação simples de texto, uma chamada direta ao modelo ou uma função comum pode bastar.
Crie um aplicativo com o SDKEnvie as informações que você pode usar, o formato que quer receber de volta e os limites de tempo e de gasto.
Reutilize o mesmo ID de operação para o app encontrar a tarefa de novo se a conexão cair.
Acompanhe o andamento e mostre às pessoas qualquer pedido de aprovação ou de ajuda para retomar uma ação interrompida.
Busque o resultado salvo no espaço de trabalho do cliente e confira antes de usá-lo.
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 seu código de verdade em um ambiente restrito, com um teste que rejeita entradas inválidas, e você não precisa de conta.
Você vai precisar do Python 3.11 ou posterior para o início rápido com o código-fonte marcado, além de um sandbox compatível: 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õesgit clone --branch v0.2.0 --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-countCada projeto escolhe um Agent, e as credenciais dele ficam vinculadas a esse projeto e à Cell do cliente atual. Um pacote JSON assinado só fica ativo depois que o Agent designado verifica os bytes exatos e o pacote passa nos testes em ambiente isolado.
Extensões em JSON puro não podem usar arquivos do host, rede, subprocessos nem credenciais herdadas. As tarefas abertas de Agent 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é-visualização, não prometemos cota gratuita de computação nem SLA de disponibilidade.
Configuração do console, credenciais com escopo e a URL de API emitida
Orçamentos, limites de solicitações, retenção e suporte
Pacotes publicados, atualizações obrigatórias do ambiente de execução e recursos compatíveis
Armazenamento do cliente, computação dos Agents e trânsito de retransmissão em texto simples
OpenAPI gerado, esquemas tipados e decisões condicionais
Confiança do publicador, revogação e relato privado de vulnerabilidades
O SDK/CLI 0.2.0 está publicado no PyPI e no GitHub. A instalação pelo Homebrew funciona em macOS com Apple Silicon e em Linux AMD64, e os handlers Python locais também exigem Python 3.11 ou posterior. Você já pode rodar localmente hoje. A execução remota exige uma Cell de cliente e um software de Agent compatíveis entre si, então confira a página Desenvolvedores no console para ver se está pronta antes de enviar uma tarefa remota. Os pacotes mantêm a autoridade existente como está, e os perfis de modelo escolhem um modelo que já esteja configurado. Forks públicos de inspeção não executam ferramentas; reproduzir uma execução é uma operação à parte.
SDK Python no PyPICLI no PyPIBaixar o SDK/CLI 0.2.0Leia as mudanças e as notas de migraçãoEscolha um exemplo, adapte-o ao jeito de trabalhar da sua equipe e veja se ele poupa você de montar o tratamento de tarefas por conta própria. Os exemplos são pontos de partida para o seu aplicativo, e não publicamos nenhum resultado de adoção independente.