Uma biblioteca rápida de serialização e validação para Python que codifica e decodifica JSON, MessagePack, YAML e TOML usando anotações de tipo padrão.
agntcy/oasf
Framework de esquema JSON e servidor padronizados para descrever capacidades, habilidades, domínios e metadados de agentes de IA, permitindo validar e descobrir agentes.
- Estrelas
- 340
- Forks
- 47
- Issues abertas
- 19
- Último commit
- há 6 horas
O que é?
OASF (Open Agentic Schema Framework) define uma estrutura de dados comum para registros de agentes de IA. Cada registro é descrito com taxonomias de habilidades e domínios baseadas em atributos, além de módulos opcionais que estendem os registros de forma combinável. O objetivo é definir, validar e descobrir de maneira consistente as capacidades dos agentes em sistemas distribuídos.
O projeto segue a abordagem de modelagem de dados do OCSF (Open Cybersecurity Schema Framework), e seu servidor de esquemas deriva do servidor de esquemas do OCSF. Ele inclui um servidor HTTP para consultar e validar esquemas, além de definições de Protocol Buffer publicadas no Buf Schema Registry.
O desenvolvimento segue um fluxo de trabalho baseado em Taskfile, com um ambiente em contêiner, incluindo a implantação de um cluster Kind local via Helm e um modo de hot reload para alterações nos esquemas. Há suporte a extensões de esquemas privados, e um servidor MCP pode ajudar LLMs a gerar e validar registros.
Recursos principais
- 01Define uma estrutura padrão de registros para descrever agentes de IA.
- 02Anota agentes com habilidades e domínios provenientes de taxonomias baseadas em atributos.
- 03Oferece suporte a extensões de esquemas privados com validação.
- 04Disponibiliza um servidor HTTP para consultar e validar esquemas.
- 05Inclui hot reload durante o desenvolvimento de esquemas e implantação local baseada em Helm.
- 06Publica definições de Protocol Buffer no Buf Schema Registry.
Casos de uso
- Padronizar a descrição das capacidades de agentes para facilitar sua descoberta entre sistemas.
- Validar registros de agentes em relação a um esquema compartilhado durante o desenvolvimento.
- Hospedar um servidor de esquemas privado com extensões próprias.
- Permitir que um LLM gere e valide registros OASF por meio de um servidor MCP.
Início rápido
- 1
Clone o repositório
git clone https://github.com/agntcy/oasf.git - 2
Instale os pré-requisitos (Taskfile, Docker com Buildx, Go, yq, curl e tar)
- 3
Compile a imagem do servidor localmente
IMAGE_TAG=latest task build:server - 4
Implante o OASF localmente em um cluster Kind temporário e, em seguida, abra localhost:8080
task up
Antes de usar
- A implantação local requer Docker com Buildx, Go, yq e uma configuração do Taskfile.
- Alterações no backend do servidor exigem executar task up novamente, então o hot reload só abrange alterações no esquema.
Em coleções
Tópicos
Perguntas frequentes
- O que é oasf?
- Framework de esquema JSON e servidor padronizados para descrever capacidades, habilidades, domínios e metadados de agentes de IA, permitindo validar e descobrir agentes. OASF (Open Agentic Schema Framework) define uma estrutura de dados comum para registros de agentes de IA. Cada registro é descrito com taxonomias de habilidades e domínios baseadas em atributos, além de módulos opcionais que estendem os registros de forma combinável. O objetivo é definir, validar e descobrir de maneira consistente as capacidades dos agentes em sistemas distribuídos.
- oasf é gratuito? Qual é a licença?
- oasf é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- oasf ainda é mantido?
- Manutenção ativa. O último commit de oasf foi em 22 de out. de 2026.
- Para que posso usar oasf?
- Padronizar a descrição das capacidades de agentes para facilitar sua descoberta entre sistemas. Validar registros de agentes em relação a um esquema compartilhado durante o desenvolvimento. Hospedar um servidor de esquemas privado com extensões próprias. Permitir que um LLM gere e valide registros OASF por meio de um servidor MCP.
- Como instalar oasf?
- Clone o repositório: git clone https://github.com/agntcy/oasf.git Instale os pré-requisitos (Taskfile, Docker com Buildx, Go, yq, curl e tar) Compile a imagem do servidor localmente: IMAGE_TAG=latest task build:server Implante o OASF localmente em um cluster Kind temporário e, em seguida, abra localhost:8080: task up
- Onde consigo oasf?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/agntcy/oasf
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
A especificação, as definições em TypeScript e JSON Schema e a documentação oficial do Model Context Protocol (MCP), um padrão aberto para conectar aplicações de IA a ferramentas e dados externos.
Biblioteca Python que extrai dados estruturados e validados com Pydantic de LLMs de vários provedores, com novas tentativas automáticas em caso de falha na validação.
Framework Python que adiciona proteções de entrada e saída a aplicações com LLMs e gera dados estruturados validados a partir das respostas dos modelos.
Uma linguagem declarativa de schemas que gera modelos de dados type-safe e código RPC para TypeScript, Python, Java, Go, C++ e outras linguagens a partir de um único arquivo .skir.
Biblioteca Python que restringe as saídas de LLMs durante a geração para corresponderem a um tipo, regex, JSON schema ou gramática especificados.