<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.38 (Ruby 2.6.10) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-zehta-aipref-parameters-00" category="info" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.33.0 -->
  <front>
    <title>AIPREF Vocabulary Parameters</title>
    <seriesInfo name="Internet-Draft" value="draft-zehta-aipref-parameters-00"/>
    <author fullname="Timid Robot Zehta">
      <organization>Creative Commons</organization>
      <address>
        <email>timid@creativecommons.org</email>
      </address>
    </author>
    <date year="2026" month="August" day="06"/>
    <area>Web and Internet Transport</area>
    <workgroup>AI Preferences</workgroup>
    <keyword>AI Preferences</keyword>
    <keyword>Artificial Intelligence</keyword>
    <abstract>
      <?line 89?>

<t>This document defines how parameters can be added to AI Preferences.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://TimidRobot.github.io/ietf-aipref-parameters/draft-zehta-parameters.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-zehta-aipref-parameters/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        AI Preferences Working Group mailing list (<eref target="mailto:ai-control@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/ai-control/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/ai-control/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/TimidRobot/ietf-aipref-parameters"/>.</t>
    </note>
  </front>
  <middle>
    <?line 94?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>This document defines how parameters can be added to AI Preferences <xref target="VOCAB"/>.</t>
    </section>
    <section anchor="conventions-and-definitions">
      <name>Conventions and Definitions</name>
      <t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>
      <?line -18?>

</section>
    <section anchor="parameters">
      <name>Parameters</name>
      <t>As noted in <xref section="6" sectionFormat="of" target="VOCAB"/>:</t>
      <ul empty="true">
        <li>
          <t>The format relies on the Dictionary type defined in
<xref section="3.2" sectionFormat="of" target="FIELDS"/>.</t>
        </li>
      </ul>
      <t>The AI Preferences can be extended with parameters. The parameter syntax is
defined in (<xref section="3.1.2" sectionFormat="of" target="FIELDS"/>):</t>
      <ul empty="true">
        <li>
          <t>Parameters are an ordered map of key-value pairs that are associated with an
Item (Section 3.3) [...]. The keys are unique within the scope of the
Parameters they occur within, and the values are bare items (i.e., they
themselves cannot be parameterized; see Section 3.3).</t>
        </li>
      </ul>
      <section anchor="uri-refernces">
        <name>URI-refernces</name>
        <t>If the value of a parameter contains a URI-reference (<xref section="4.1" sectionFormat="of" target="URI"/>) and its value is not a valid URI-reference, the parameter <bcp14>MUST</bcp14> be
ignored. If its value is a relative reference (<xref section="4.2" sectionFormat="of" target="URI"/>), it <bcp14>MUST</bcp14>
be resolved (<xref section="5" sectionFormat="of" target="URI"/>) before being used.</t>
      </section>
      <section anchor="examples">
        <name>Examples</name>
        <t>Generic example:</t>
        <artwork><![CDATA[
ai-train=n;foo=bar
]]></artwork>
        <t>Assuming a content holder wants to highlight the presense of a tip jar:</t>
        <artwork><![CDATA[
ai-train=y;tipjar=/tipjar
]]></artwork>
        <t>Example of categories from <xref target="DISPLAY"/> converted to parameters:</t>
        <artwork><![CDATA[
ai-train=n,search=y;display-text=y;max-text-length=160
]]></artwork>
      </section>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>See <xref target="VOCAB"/>.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document has no IANA actions.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="FIELDS">
          <front>
            <title>Structured Field Values for HTTP</title>
            <author fullname="M. Nottingham" initials="M." surname="Nottingham"/>
            <author fullname="P-H. Kamp" surname="P-H. Kamp"/>
            <date month="September" year="2024"/>
            <abstract>
              <t>This document describes a set of data types and associated algorithms that are intended to make it easier and safer to define and handle HTTP header and trailer fields, known as "Structured Fields", "Structured Headers", or "Structured Trailers". It is intended for use by specifications of new HTTP fields.</t>
              <t>This document obsoletes RFC 8941.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9651"/>
          <seriesInfo name="DOI" value="10.17487/RFC9651"/>
        </reference>
        <reference anchor="URI">
          <front>
            <title>Uniform Resource Identifier (URI): Generic Syntax</title>
            <author fullname="T. Berners-Lee" initials="T." surname="Berners-Lee"/>
            <author fullname="R. Fielding" initials="R." surname="Fielding"/>
            <author fullname="L. Masinter" initials="L." surname="Masinter"/>
            <date month="January" year="2005"/>
            <abstract>
              <t>A Uniform Resource Identifier (URI) is a compact sequence of characters that identifies an abstract or physical resource. This specification defines the generic URI syntax and a process for resolving URI references that might be in relative form, along with guidelines and security considerations for the use of URIs on the Internet. The URI syntax defines a grammar that is a superset of all valid URIs, allowing an implementation to parse the common components of a URI reference without knowing the scheme-specific requirements of every possible identifier. This specification does not define a generative grammar for URIs; that task is performed by the individual specifications of each URI scheme. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="66"/>
          <seriesInfo name="RFC" value="3986"/>
          <seriesInfo name="DOI" value="10.17487/RFC3986"/>
        </reference>
        <reference anchor="VOCAB">
          <front>
            <title>A Vocabulary For Expressing AI Usage Preferences</title>
            <author fullname="Paul Keller">
              <organization>Open Future</organization>
            </author>
            <author fullname="Martin Thomson" role="editor">
              <organization>Mozilla</organization>
            </author>
            <date year="2026" month="August"/>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-aipref-vocab-06"/>
        </reference>
        <reference anchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <date month="March" year="1997"/>
            <abstract>
              <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC8174">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <date month="May" year="2017"/>
            <abstract>
              <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="8174"/>
          <seriesInfo name="DOI" value="10.17487/RFC8174"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="DISPLAY">
          <front>
            <title>A Vocabulary for Controlling Usage of Content Collected by Search and AI Crawlers</title>
            <author fullname="Krishna Madhavan">
              <organization>Microsoft Corporation</organization>
            </author>
            <author fullname="Fabrice Canel">
              <organization>Microsoft Corporation</organization>
            </author>
            <author fullname="Jordan Gimbel">
              <organization>Microsoft Corporation</organization>
            </author>
            <author fullname="Sonia Cooper">
              <organization>Microsoft Corporation</organization>
            </author>
            <date year="2026" month="March" day="25"/>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-madhavan-aipref-displaybasedpref-02"/>
        </reference>
      </references>
    </references>
    <?line 179?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>The following individuals made significant contributions to this document:</t>
      <ul spacing="normal">
        <li>
          <t>Sara Lovell</t>
        </li>
      </ul>
    </section>
  </back>
  <!-- ##markdown-source:
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
QyJY6XsawWh0auaYk8X/AOxfSlOXEgAA

-->

</rfc>
