Pular para o conteúdo principal
As mesmas regras se aplicam independentemente de você usar o Glasser por meio de um Agent, MCP, CLI ou HTTP.

​
Da solicitação aos dados

O Glasser conecta você a dados pagos de Providers especializados. Um Endpoint é uma operação de um Provider, com seu próprio esquema de entrada, versão e Price. Sua Glasser Key dá acesso sem contas separadas dos Providers.
  1. Pesquise um Endpoint adequado à sua solicitação.
  2. Inspecione seu esquema de entrada e o Price atual.
  3. Execute-o para recuperar dados. O Glasser registra o resultado e a cobrança em um Run.
Search e Inspect são gratuitos. Para tarefas predefinidas, Solutions podem selecionar um Endpoint e mapear sua entrada para você. Ambos os caminhos usam os mesmos Runs e o saldo do Workspace.

​
Entenda o Price

Inspect mostra como um Endpoint cobra:
  • Resultado bem-sucedido: um valor fixo ou um valor medido (como por resultado ou token), com um limite máximo.
  • Outros resultados: regras separadas para nenhum resultado, erros do Provider, timeouts e falhas internas (NO_RESULT, PROVIDER_ERROR, TIMED_OUT, INTERNAL).
Um novo Run usa o Price vigente na admissão e o mantém até a liquidação. A versão de um Endpoint não fixa o Price para Runs futuros. Os valores são strings decimais exatas em USD, como "0.005". Use aritmética decimal, não aritmética de ponto flutuante, ao somá-los.

​
Status do Run

Antes de criar um Run, o Glasser verifica o acesso e os fundos disponíveis e faz um Hold da cobrança máxima. Uma solicitação recusada não cria Run nem cobrança. Quando o Run termina, o Glasser encerra o Hold e registra a cobrança final. Uma solicitação de interrupção após o despacho não cancela o trabalho do Provider. Leia o status retornado e a cobrança final; consulte Interromper um Run.

​
Leia o resultado e a cobrança

Verifique estes campos separadamente:

​
Tente novamente sem uma segunda cobrança

Após um timeout ou perda de conexão, tente novamente com a mesma chave de idempotência para recuperar o Run original sem iniciar outro nem ser cobrado por ele.
  • Mantenha provider, endpoint, input e endpoint_version iguais.
  • Alterar esses parâmetros de execução usando a mesma chave retorna um conflito.
  • Use uma chave nova somente quando quiser iniciar outro Run.
Alterar task_id ou metadata não cria um novo Run nem atualiza o Run original. As respostas do MCP também incluem replayed: true para uma nova tentativa; as respostas da API HTTP e do CLI retornam o Run sem esse campo.

​
Keys e políticas

Uma Key pertence a um Workspace. Os Runs usam o saldo desse Workspace. Um Endpoint precisa ser permitido tanto pela Policy do Workspace quanto pela Policy da Key. Search omite Endpoints que não fazem parte desse acesso; Inspect retorna não encontrado para eles.

​
Adicionar fundos

Adicione fundos na página de saldo. A API, o CLI e o MCP não podem adicionar fundos. Um Grant é saldo gratuito: não expira e é usado como qualquer outro saldo. Todo novo Workspace começa com um Grant de cadastro. Grants de indicação e compartilhamento têm limites vitalícios por Workspace; o console mostra os valores e limites atuais. Grants aparecem no histórico do saldo com o tipo grant.

​
Um modelo, quatro superfícies

As mesmas regras de execução, cobrança e políticas se aplicam à API HTTP, ao CLI, ao servidor MCP e ao Skill do agent.