Repolode
agntcy

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. 1

    Clone o repositório

    git clone https://github.com/agntcy/oasf.git
  2. 2

    Instale os pré-requisitos (Taskfile, Docker com Buildx, Go, yq, curl e tar)

  3. 3

    Compile a imagem do servidor localmente

    IMAGE_TAG=latest task build:server
  4. 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