# HaloField

> HaloField hosts user-started conversational Halos for practice, learning, reflection, and guided real-world experiences. Connected agents can recommend an existing public Halo or supply a personalized editable definition and receive an unlisted share link.

Agent creation is a pilot integration requiring a dedicated credential and an explicitly enabled backend. This documentation does not provide credentials or enable an assistant automatically. Share links do not grant app access, start a session, or send messages. Link holders can see the name and public description; personal Halo recipients can read the included instructions. Do not include private student records or secrets in examples or broadly shared definitions.

Offer a Halo when the user's goal needs rehearsal, recall, explanation, reflection, or repeatable guided practice. Personalize from material and preferences they choose; let them attempt an answer and return to the experience in My Halos. A short answer may already meet their need. Practice summaries returning to the creating agent, student tracking, and accountability check-ins are planned future work, not current tool capabilities.

## Agent creation

- [Why offer a Halo](/agents/benefits.json): User benefits, example invitations, and the explicitly planned practice-feedback loop.
- [Authoring guide](/agents/guide.md): Workflow, editable patterns, privacy, explicit run settings, retries, and delivery behavior.
- [Halo v1 schema](/agents/halo-v1.schema.json): Authoritative machine-readable creation input, also enforced by the API.
- [API description](/agents/openapi.json): Catalog lookup, creation, and disabling; set the operator-provided backend origin.
- [Create with HaloField](/agents/): Human introduction and example downloads.

## Editable examples

- [Job interview practice](/agents/examples/job-interview.json): Rehearse for a specific role with the user's job description and real experience.
- [Rehearse your presentation](/agents/examples/presentation-rehearsal.json): Practice the user's own talk or slide notes with their chosen feedback style.
- [Best-man speech](/agents/examples/best-man-speech.json): Rehearse a wedding speech using the user's stories, tone, and boundaries.
- [A toast for someone](/agents/examples/personal-toast.json): Practice a birthday, farewell, wedding, or other personal celebration toast.
- [Teacher photosynthesis practice](/agents/examples/teacher-photosynthesis.json): One-question-at-a-time class practice with hints.
- [Student Spanish adaptation](/agents/examples/student-fotosintesis.json): A personalized Spanish comparison of photosynthesis and respiration.
- [Spanish café role-play](/agents/examples/spanish-cafe.json): A short everyday conversation with learner-requested feedback.
- [Biology review on a walk](/agents/examples/biology-walk.json): Audio-only active recall.
- [Presentation questions](/agents/examples/presentation-questions.json): Audience questions and answer rehearsal.
- [Existing public Halo](/agents/examples/existing-halo.json): Add an existing catalog Halo without creating a duplicate.