Agent Client Protocol - v0.5.1
    Preparing search index...

    Interface PromptRequest

    Processes a user prompt within a session.

    This method handles the whole lifecycle of a prompt:

    • Receives user messages with optional context (files, images, etc.)
    • Processes the prompt using language models
    • Reports language model content and tool calls to the Clients
    • Requests permission to run tools
    • Executes any requested tool calls
    • Returns when the turn is complete with a stop reason

    See protocol docs: Prompt Turn

    interface PromptRequest {
        _meta?: { [k: string]: unknown };
        prompt: ContentBlock[];
        sessionId: string;
    }
    Index

    Properties

    _meta? prompt sessionId

    Properties

    Optional_meta

    _meta?: { [k: string]: unknown }

    Extension point for implementations

    prompt: ContentBlock[]

    The blocks of content that compose the user's message.

    As a baseline, the Agent MUST support [ContentBlock::Text] and [ContentBlock::ResourceLink], while other variants are optionally enabled via [PromptCapabilities].

    The Client MUST adapt its interface according to [PromptCapabilities].

    The client MAY include referenced pieces of context as either [ContentBlock::Resource] or [ContentBlock::ResourceLink].

    When available, [ContentBlock::Resource] is preferred as it avoids extra round-trips and allows the message to include pieces of context from sources the agent may not have access to.

    sessionId: string

    The ID of the session to send this user message to

    Settings

    Member Visibility

    On This Page

    Properties