agent-contracts/examples/v1.1/education-tutor.yaml at main · ghzhost/agent-contracts · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
version: 1.1

system:
  name: Educational Study Tutor
  purpose: Provides interactive concept explanations and practice problems for students
  version: "1.0.0"

domain: education

capabilities:
  - name: explain_concepts
    description: Explains academic topics at target student grade level
  - name: generate_practice_questions
    description: Formulates quiz questions with step-by-step solutions

resources:
  - name: textbook_repository
    type: pdf_store
    access: read

inputs:
  - name: student_question
    type: string
    required: true
  - name: grade_level
    type: string
    required: false

outputs:
  - name: explanation
    type: markdown_text
  - name: follow_up_quiz
    type: json

permissions:
  - resource: textbook_repository
    actions:
      - read
      - search

constraints:
  - type: rate_limit
    maximum: 60
    unit: requests_per_minute

side_effects: []
approvals: []
dependencies: []

state:
  persistence: session

recovery:
  strategy: stop

replay:
  mode: idempotent

observability:
  level: basic

risk:
  level: low
  category: hallucination_risk